enix.proxmox_ve

これは、Ansibleを使用して、unixホスト上にProxmox VEを展開および設定するための役割です。この役割は、ローカルのLVMボリュームやISCSIマルチパスなどを構成することにより、enixの使用に強く関連しています。そのため、全ての人にとって関連性があるわけではありませんが、各ステップは設定可能であり、独立して使用できます。

要件

サポート対象:

• Debian 10 "Buster"
• Debian 11 "Bullseye"
• Debian 12 "Bookworm"

役割の変数

この役割にはほとんどすべてのデフォルトがプリロードされています。あなたのホスト/グループ変数、インベントリ、またはプレイブックの中で、各変数をオーバーライドできます。設定の手助けが必要な場合は、defaults/main.ymlにある注釈されたデフォルトを参照してください。提供されるすべての変数はproxmox_ve__で始まります。

• proxmox_ve__force_reboot - :warning: 注意 :warning:。重要な設定変更がある場合、ホストが自動的に再起動します。デフォルト: false。
• proxmox_ve__enterprise - Proxmox VEのエンタープライズサブスクリプションを有効にするかどうか。デフォルト: false。
• proxmox_ve__disable_smt - ブートカーネルオプションとしてSMT（ハイパースレッディング）を無効にします。詳細についてはこちらを参照してください。デフォルト: false。
• proxmox_ve__net_ovs - ホスト上でOpenVswitchネットワーク構成を有効にします。デフォルト: false。
• proxmox_ve__net_template - ホスト上の/etc/network/interfaces設定で使用されるテンプレート、デフォルト: interfaces.j2。パスは変更またはオーバーロードできます。既定のテンプレートは基本的なブリッジ設定のみを提供します。
• proxmox_ve__storage_lvm - Proxmoxで初期化および構成するLVMストレージの説明。上記の例の設定を参照してください。
• proxmox_ve__storage_lvm_options - lvm.confで変更するオプション。デフォルト: none。
• proxmox_ve__lvm_global_filter - lvm global_filter。デフォルト: ["r|/dev/zd.*|", "r|/dev/mapper/pve-.*|", "r|/dev/mapper/.*-(vm|base)--[0-9]+--disk--[0-9]+|"]。
• proxmox_ve__storage_iscsi - Proxmoxで設定するiSCSIストレージの説明。上記の例の設定を参照してください。
• proxmox_ve__storage_iscsi_options - iscsid.confで変更するオプション。デフォルト:

proxmox_ve__storage_iscsi_options:
  - option: node.session.timeo.replacement_timeout
    value: 10
    state: present

• proxmox_ve__spv_user - 監視用のPVEAuditor役割を持つユーザー名。デフォルト: prometheus@pve
• proxmox_ve__spv_password - 監視ユーザーのパスワード。定義されていない場合、ユーザーは作成されません。
• proxmox_ve__storage_iscsi_multipath_template - マルチパス構成に使用するテンプレートファイル。
• proxmox_ve__migration_secure - マイグレーションのセキュリティレベルを定義します。詳細はこちらを参照してください。デフォルト: true。
• proxmox_ve__cluster_ip - Proxmoxクラスタリングに使用するIP。この設定により/etc/hostsのノードIPが変更されます。デフォルト: ansible_default_ipv4.address。

依存関係

• なし

使用方法

このリポジトリを役割ディレクトリにクローンします：

$ git clone https://gitlab.enix.org/ansible/ansible-proxmox_ve.git roles/proxmox_ve

またはAnsibleギャラクシーのrequirements.ymlを使用します。

# 公開役割
- src: enix.proxmox_ve
  name: proxmox_ve

そして、プレイブックの役割に追加します：

- hosts: all
  roles:
    - role: enix.proxmox_ve
      proxmox_ve__storage_iscsi:
        - name: iscsi-storage
          portal: 192.168.0.1
          target: iqn.2015-11.com.storage:iscsi.12315132
          volumes:
            - name: bigvolume
              wwid: 3600c0ff0003bb7fcb730e75a01000000
      proxmox_ve__storage_lvm:
        - name: "localvm"
          devices:
            - /dev/md12
          pesize: "128"
          shared: 0
        - name: "iscsilvm"
          devices:
            - /dev/mapper/bigvolume
          pesize: "256"
          shared: 1
      proxmox_ve__storage_lvm_options:
        - option: issue_discards
          value: 0

この役割をプレイブックとしても使用できます。どのホストをプロビジョニングするかを尋ねられ、--extra-varsを使ってプレイをさらに構成できます。

$ ansible-playbook -i inventory --extra-vars='{...}' main.yml

今後の予定

• クラスタへのホストの自動追加
• ユーザーおよび資格情報の管理

変更履歴

3.1.0

特定のクラスタIPのサポートを追加。

3.0.0

Debian BookwormとProxmox VE 8.xブランチのサポートを追加。

2.8.0

必要に応じて安全なマイグレーション機構を無効にするためのproxmox_ve__migration_secureオプションを追加。

2.7.0

lvm.confのオプション設定を行うためのproxmox_ve__storage_lvm_optionsを追加。

2.6.0

Proxmox 7.0 / BullsEyeのサポートを追加。

2.5.0

クラスタ上に監視役割のユーザー作成機能を追加。

2.4.1

Debian Busterの変更に従ったデフォルトのmultipath.confを更新（find_mulitpaths）。

2.4.0

lvm global_filterを新しい6.1デフォルト値に更新。 非推奨の修正。

2.3.0

lvmの問題を修正。 iSCSI構成オプションを追加。

2.2.0

proxmox_ve__disable_smtオプションを追加。

2.1.1

enix.deb role_nameに切り替え。

2.1.0

lvm global_filterのオーバーライドを許可。 /etc/hostsの設定を追加。

2.0.0

自動ホスト再起動機能と適切なストレージ管理が含まれるようになりました。

1.0.0

基本的なストレージ設定が含まれた最初のバージョン。

ライセンス

GPLv2

著者情報

Laurent CORBES laurent.corbes@enix.fr - http://www.enix.fr