インストールガイド

例 1

1. メディア: フルフラッシュシステム (SSD)
2. 使用例: ブロック (RBD) とファイル (CephFS)、またはオブジェクト (Ceph Object Gateway)
3. ノード数: 3
4. レプリケーションスキーム: 2

例 2

1. メディア: フルフラッシュシステム (SSD) またはスピニングデバイス (HDD)
2. 使用例: ブロック (RBD)、ファイル (CephFS)、およびオブジェクト (Ceph Object Gateway)
3. ノード数: 4
4. レプリケーションスキーム: 3

例 3

1. メディア: フルフラッシュシステム (SSD) またはスピニングデバイス (HDD)
2. 使用例: ブロック (RBD)、オブジェクト (Ceph Object Gateway)、および Ceph Object Gateway の NFS
3. ノード数: 4
4. レプリケーションスキーム: 3

手順

1. ノードを登録します。プロンプトが表示されたら、適切な Red Hat カスタマーポータルの認証情報を入力します。

   構文

   subscription-manager register

2. CDN から最新のサブスクリプションデータをプルします。

   構文

   subscription-manager refresh

3. Red Hat Ceph Storage で利用可能なサブスクリプションのリストを表示します。

   構文

   subscription-manager list --available --matches 'Red Hat Ceph Storage'

4. 適切なサブスクリプションを特定し、プール ID を取得します。

5. ソフトウェアエンタイトルメントにアクセスするには、プール ID をアタッチします。直前の手順で特定したプール ID を使用します。

   構文

   subscription-manager attach --pool=POOL_ID

6. デフォルトのソフトウェアリポジトリーを無効にしてから、該当するバージョンの Red Hat Enterprise Linux でサーバーおよび extras リポジトリーを有効にします。

   Red Hat Enterprise Linux 8

   subscription-manager repos --disable=*
   subscription-manager repos --enable=rhel-8-for-x86_64-baseos-rpms
   subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms

   Red Hat Enterprise Linux 9

   subscription-manager repos --disable=*
   subscription-manager repos --enable=rhel-9-for-x86_64-baseos-rpms
   subscription-manager repos --enable=rhel-9-for-x86_64-appstream-rpms

7. システムを更新して、Red Hat Enterprise Linux の最新パッケージを受け取ります。

   構文

   # dnf update

8. Red Hat Ceph Storage 5 コンテンツをサブスクライブします。How to Register Ceph with Red Hat Satellite 6 の手順に従います。

9. ceph-tools リポジトリーを有効にします。

   Red Hat Enterprise Linux 8

   subscription-manager repos --enable=rhceph-5-tools-for-rhel-8-x86_64-rpms

   Red Hat Enterprise Linux 9

   subscription-manager repos --enable=rhceph-5-tools-for-rhel-9-x86_64-rpms

10. クラスターに追加するすべてのノードで上記の手順を繰り返します。

11. Red Hat Enterprise Linux 8 に cephadm-ansible をインストールします。

    例

    dnf install cephadm-ansible

    重要

    cephadm-ansible がサポートされていないため、Red Hat Enterprise Linux 9 ではこの手順をスキップしてください。

手順

1. /usr/share/cephadm-ansible ディレクトリーに移動します。

   [root@admin ~]# cd /usr/share/cephadm-ansible

2. 必要に応じて、ステージングおよび実稼働環境用のサブディレクトリーを作成します。

   [root@admin cephadm-ansible]# mkdir -p inventory/staging inventory/production

3. 必要に応じて、ansible.cfg ファイルを編集し、以下の行を追加してデフォルトのインベントリーの場所を割り当てます。

   [defaults]
   inventory = ./inventory/staging

4. 必要に応じて、各環境のインベントリー hosts ファイルを作成します。

   [root@admin cephadm-ansible]# touch inventory/staging/hosts
   [root@admin cephadm-ansible]# touch inventory/production/hosts

5. 各 hosts ファイルを開いて編集し、ノードおよび [admin] グループを追加します。

   NODE_NAME_1
   NODE_NAME_2
   
   [admin]
   ADMIN_NODE_NAME_1

   • NODE_NAME_1 および NODE_NAME_2 を、モニター、OSD、MDS、ゲートウェイノードなどの Ceph ノードに置き換えます。

   • ADMIN_NODE_NAME_1 は、管理キーリングが保存されるノードの名前に置き換えます。

     例

     host02
     host03
     host04
     
     [admin]
     host01

     注記

     ansible.cfg ファイルのインベントリーの場所を staging に設定する場合は、以下のようにステージング環境で Playbook を実行する必要があります。

     構文

     ansible-playbook -i inventory/staging/hosts PLAYBOOK.yml

     実稼働環境で Playbook を実行するには、以下を実行します。

     構文

     ansible-playbook -i inventory/production/hosts PLAYBOOK.yml

手順

1. etc/ssh/sshd_config ファイルを開き、PermitRootLogin を yes に設定します。

   例

   [root@admin ~]# echo 'PermitRootLogin yes' >> /etc/ssh/sshd_config.d/01-permitrootlogin.conf

2. SSH サービスを再起動します。

   例

   [root@admin ~]# systemctl restart sshd.service

3. root ユーザーとしてノードにログインします。

   構文

   ssh root@HOST_NAME

   HOST_NAME は、Ceph ノードのホスト名に置き換えます。

   例

   [root@admin ~]# ssh root@host01

   プロンプトに従い root パスワードを入力します。

手順

1. root ユーザーとしてノードにログインします。

   構文

   ssh root@HOST_NAME

   HOST_NAME は、Ceph ノードのホスト名に置き換えます。

   例

   [root@admin ~]# ssh root@host01

   プロンプトに従い root パスワードを入力します。

2. 新しい Ansible ユーザーを作成します。

   構文

   adduser USER_NAME

   USER_NAME は、Ansible ユーザーの新しいユーザー名に置き換えます。

   例

   [root@host01 ~]# adduser ceph-admin

   重要

   ceph をユーザー名として使用しないでください。ceph ユーザー名は、Ceph デーモン用に予約されます。クラスター全体で統一されたユーザー名を使用すると、使いやすさが向上しますが、侵入者は通常、そのユーザー名をブルートフォース攻撃に使用するため、明白なユーザー名の使用は避けてください。

3. このユーザーに新しいパスワードを設定します。

   構文

   passwd USER_NAME

   USER_NAME は、Ansible ユーザーの新しいユーザー名に置き換えます。

   例

   [root@host01 ~]# passwd ceph-admin

   プロンプトが表示されたら、新しいパスワードを 2 回入力します。

4. 新規に作成されたユーザーの sudo アクセスを設定します。

   構文

   cat << EOF >/etc/sudoers.d/USER_NAME
   $USER_NAME ALL = (root) NOPASSWD:ALL
   EOF

   USER_NAME は、Ansible ユーザーの新しいユーザー名に置き換えます。

   例

   [root@host01 ~]# cat << EOF >/etc/sudoers.d/ceph-admin
   ceph-admin ALL = (root) NOPASSWD:ALL
   EOF

5. 正しいファイル権限を新しいファイルに割り当てます。

   構文

   chmod 0440 /etc/sudoers.d/USER_NAME

   USER_NAME は、Ansible ユーザーの新しいユーザー名に置き換えます。

   例

   [root@host01 ~]# chmod 0440 /etc/sudoers.d/ceph-admin

6. ストレージクラスター内のすべてのノードで上記の手順を繰り返します。

手順

1. cephadm-ansible ディレクトリーに移動します。

2. 新しい SSH キーを生成します。

   例

   [ceph-admin@admin cephadm-ansible]$ ceph cephadm generate-key

3. SSH キーの公開部分を取得します。

   例

   [ceph-admin@admin cephadm-ansible]$ ceph cephadm get-pub-key

4. 現在保存されている SSH キーを削除します。

   例

   [ceph-admin@admin cephadm-ansible]$ceph cephadm clear-key

5. mgr デーモンを再起動して、設定を再読み込みします。

   例

   [ceph-admin@admin cephadm-ansible]$ ceph mgr fail

手順

1. SSH キーペアを生成し、デフォルトのファイル名を受け入れ、パスフレーズを空のままにします。

   [ceph-admin@admin ~]$ ssh-keygen

2. 公開鍵をストレージクラスター内のすべてのノードにコピーします。

   ssh-copy-id USER_NAME@HOST_NAME

   USER_NAME は、Ansible ユーザーの新しいユーザー名に置き換えます。HOST_NAME は、Ceph ノードのホスト名に置き換えます。

   例

   [ceph-admin@admin ~]$ ssh-copy-id ceph-admin@host01

3. ユーザーの SSH の config ファイルを作成します。

   [ceph-admin@admin ~]$ touch ~/.ssh/config

4. config ファイルを編集するために開きます。ストレージクラスター内の各ノードの Hostname および User オプションの値を設定します。

   Host host01
      Hostname HOST_NAME
      User USER_NAME
   Host host02
      Hostname HOST_NAME
      User USER_NAME
   ...

   HOST_NAME は、Ceph ノードのホスト名に置き換えます。USER_NAME は、Ansible ユーザーの新しいユーザー名に置き換えます。

   例

   Host host01
      Hostname host01
      User ceph-admin
   Host host02
      Hostname host02
      User ceph-admin
   Host host03
      Hostname host03
      User ceph-admin

   重要

   ~/.ssh/config ファイルを設定すると、ansible-playbook コマンドを実行するたびに -u USER_NAME オプションを指定する必要がありません。

5. ~/.ssh/config ファイルに正しいファイルパーミッションを設定します。

   [ceph-admin@admin ~]$ chmod 600 ~/.ssh/config

手順

1. /usr/share/cephadm-ansible ディレクトリーに移動します。

2. hosts ファイルを開いて編集し、ノードを追加します。

   例

   host02
   host03
   host04
   
   [admin]
   host01

3. プリフライト Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

   インストールが完了すると、cephadm は /usr/sbin/ ディレクトリーに配置されます。

   • --limit オプションを使用して、ストレージクラスターの選択したホストでプリフライト Playbook を実行します。

     構文

     ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit GROUP_NAME|NODE_NAME

     GROUP_NAME は、インベントリーファイルからのグループ名に置き換えます。NODE_NAME は、インベントリーファイルからの特定のノード名に置き換えます。

     注記

     必要に応じて、[mons]、[osds]、[mgrs] などのグループ名で、インベントリーファイルのノードをグループ化できます。ただし、管理ノードを [admin] グループに追加し、クライアントを [clients] グループに追加する必要があります。

     例

     [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit clients
     [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit host01

   • プリフライト Playbook を実行すると、cephadm-ansible は自動的にクライアントノードに chrony および ceph-common をインストールします。

     プリフライト Playbook は chrony をインストールしますが、単一の NTP ソース用に設定します。複数のソースを設定する場合、または非接続環境の場合は、次のドキュメントを参照してください。

     • How to configure chrony?
     • Best practices for NTP.
     • 基本的な chrony NTP のトラブルシューティング

手順

1. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ansible@admin ~]$ cd /usr/share/cephadm-ansible

2. Ansible 管理ノードから、SSH 鍵を配布します。オプションの cephadm_pubkey_path パラメーターは、Ansible コントローラーホスト上の SSH 公開鍵ファイルの完全パス名です。

   注記

   cephadm_pubkey_path が指定されていない場合、Playbook は cephadm get-pub-key コマンドから鍵を取得します。これは、少なくとも最小限のクラスターのブートストラップを設定したことを意味します。

   構文

   ansible-playbook -i INVENTORY_HOST_FILE cephadm-distribute-ssh-key.yml -e cephadm_ssh_user=USER_NAME -e cephadm_pubkey_path= home/cephadm/ceph.key -e admin_node=ADMIN_NODE_NAME_1

   例

   [ansible@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-distribute-ssh-key.yml -e cephadm_ssh_user=ceph-admin -e cephadm_pubkey_path=/home/cephadm/ceph.key -e admin_node=host01
   
   [ansible@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-distribute-ssh-key.yml -e cephadm_ssh_user=ceph-admin -e admin_node=host01

1. 管理キーリングが含まれるノードから、新規ホストの root ユーザーの authorized_keys ファイルにストレージクラスターの公開 SSH 鍵をインストールします。

   構文

   ssh-copy-id -f -i /etc/ceph/ceph.pub user@NEWHOST

   例

   [root@host01 ~]# ssh-copy-id -f -i /etc/ceph/ceph.pub root@host02
   [root@host01 ~]# ssh-copy-id -f -i /etc/ceph/ceph.pub root@host03

2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. Ansible 管理ノードから、新しいホストを Ansible インベントリーファイルに追加します。ファイルのデフォルトの場所は /usr/share/cephadm-ansible/hosts/ です。以下の例は、一般的なインベントリーファイルの構造を示しています。

   例

   [ceph-admin@admin ~]$ cat hosts
   
   host02
   host03
   host04
   
   [admin]
   host01

   注記

   新しいホストを Ansible インベントリーファイルに追加し、ホストでプリフライト Playbook を実行している場合は、ステップ 4 に進みます。

4. Red Hat Enterprise Linux 8 の --limit オプションを指定して、プリフライト Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit NEWHOST

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit host02

   プリフライト Playbook は、新しいホストに podman、lvm2、chrony、および cephadm をインストールします。インストールが完了すると、cephadm は /usr/sbin/ ディレクトリーに配置されます。

   • Red Hat Enterprise Linux 9 の場合は、podman、lvm2、chronyd、および cephadm を手動でインストールします。

     [root@host01 ~]# dnf install podman lvm2 chrony cephadm

5. ブートストラップノードから、cephadm オーケストレーターを使用して、新しいホストをストレージクラスターに追加します。

   構文

   ceph orch host add NEWHOST

   例

   [ceph: root@host01 /]# ceph orch host add host02
   Added host 'host02' with addr '10.10.128.69'
   [ceph: root@host01 /]# ceph orch host add host03
   Added host 'host03' with addr '10.10.128.70'

6. オプション: プリフライト Playbook を実行する前後に、IP アドレスでノードを追加することもできます。ストレージクラスター環境に DNS が設定されていない場合は、ホスト名とともに、IP アドレスでホストを追加できます。

   構文

   ceph orch host add HOSTNAME IP_ADDRESS

   例

   [ceph: root@host01 /]# ceph orch host add host02 10.10.128.69
   Added host 'host02' with addr '10.10.128.69'

   検証

   • ストレージクラスターのステータスを表示し、新しいホストが追加されたことを確認します。ホストの STATUS は、ceph orch host ls コマンドの出力では空白になります。

     例

     [ceph: root@host01 /]# ceph orch host ls

手順

1. 5 つの Monitor デーモンをストレージクラスター内の 5 つのランダムなホストに適用します。

   ceph orch apply mon 5

2. 自動モニターのデプロイメントを無効にします。

   ceph orch apply mon --unmanaged

手順

1. ceph orch host ls を使用して、ストレージクラスター内のホストを表示します。

   例

   [root@host01 ~]# ceph orch host ls
   HOST   ADDR   LABELS  STATUS
   host01        mon,mgr,_admin
   host02        mon
   host03        mon,mgr
   host04
   host05
   host06

2. ストレージクラスターの admin ホストを指定するには、_admin ラベルを使用します。最良の結果を得るには、このホストで Monitor デーモンと Manager デーモンの両方が実行されている必要があります。

   構文

   ceph orch host label add HOSTNAME _admin

   例

   [root@host01 ~]#  ceph orch host label add host03 _admin

3. admin ホストに _admin ラベルがあることを確認します。

   例

   [root@host01 ~]#  ceph orch host ls
   HOST   ADDR   LABELS  STATUS
   host01        mon,mgr,_admin
   host02        mon
   host03        mon,mgr,_admin
   host04
   host05
   host06

4. 管理ノードにログインして、ストレージクラスターを管理します。

手順

1. OSD をデプロイするために利用可能なデバイスをリスト表示します。

   構文

   ceph orch device ls [--hostname=HOSTNAME1 HOSTNAME2] [--wide] [--refresh]

   例

   [ceph: root@host01 /]# ceph orch device ls --wide --refresh

2. OSD を特定のホストまたは利用可能なすべてのデバイスにデプロイできます。

   • 特定のホストの特定のデバイスから OSD を作成するには、以下を実行します。

     構文

     ceph orch daemon add osd HOSTNAME:DEVICE_PATH

     例

     [ceph: root@host01 /]# ceph orch daemon add osd host02:/dev/sdb

   • 使用可能な未使用のデバイスに OSD をデプロイするには、--all-available-devices オプションを使用します。

     例

     [ceph: root@host01 /]# ceph orch apply osd --all-available-devices

手順

1. Ansible ユーザーとして、Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

2. hosts インベントリーファイルを開いて編集し、[clients] グループとクライアントをインベントリーに追加します。

   例

   host02
   host03
   host04
   
   [clients]
   client01
   client02
   client03
   
   [admin]
   host01

3. cephadm-preflight.yml playbook を実行して、前提条件をクライアントにインストールします。

   構文

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --limit CLIENT_GROUP_NAME|CLIENT_NODE_NAME

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --limit clients

4. cephadm-clients.yml playbook を実行して、キーリングと Ceph 設定ファイルを一連のクライアントに配布します。

   1. カスタム宛先キーリング名でキーリングをコピーするには、以下を実行します。

      構文

      ansible-playbook -i INVENTORY_FILE cephadm-clients.yml --extra-vars '{"fsid":"FSID","keyring":"KEYRING_PATH","client_group":"CLIENT_GROUP_NAME","conf":"CEPH_CONFIGURATION_PATH","keyring_dest":"KEYRING_DESTINATION_PATH"}'

      • INVENTORY_FILE を Ansible インベントリーのファイル名に置き換えます。
      • FSID をクラスターの FSID に置き換えます。
      • KEYRING_PATH を、クライアントにコピーする管理ホスト上のキーリングへのフルパス名に置き換えます。
      • オプション: CLIENT_GROUP_NAME を、セットアップするクライアントの Ansible グループ名に置き換えます。
      • オプション: CEPH_CONFIGURATION_PATH を、管理ノード上の Ceph 設定ファイルへのフルパスに置き換えます。

      • オプション: KEYRING_DESTINATION_PATH を、キーリングがコピーされる宛先の絶対パス名に置き換えます。

        注記

        Playbook の実行時に conf オプションで設定ファイルを指定しない場合、Playbook は最小限の設定ファイルを生成して配布します。デフォルトでは、生成されたファイルは /etc/ceph/ceph.conf にあります。

        例

        [ceph-admin@host01 cephadm-ansible]$ ansible-playbook -i hosts cephadm-clients.yml --extra-vars '{"fsid":"266ee7a8-2a05-11eb-b846-5254002d4916","client_group":"clients","keyring":"/etc/ceph/ceph.client.admin.keyring","conf":"/etc/ceph/ceph.conf","keyring_dest":"/etc/ceph/custom.name.ceph.keyring"}'

   2. デフォルトの宛先キーリング名 ceph.keyring でキーリングをコピーし、clients のデフォルトグループを使用するには:

      構文

      ansible-playbook -i INVENTORY_FILE cephadm-clients.yml --extra-vars '{"fsid":"FSID","keyring":"KEYRING_PATH","conf":"CEPH_CONFIGURATION_PATH"}'

      例

      [ceph-admin@host01 cephadm-ansible]$ ansible-playbook -i hosts cephadm-clients.yml --extra-vars '{"fsid":"266ee7a8-2a05-11eb-b846-5254002d4916","keyring":"/etc/ceph/ceph.client.admin.keyring","conf":"/etc/ceph/ceph.conf"}'

手順

1. cephadm を無効にしてすべてのオーケストレーション操作を停止し、新しいデーモンのデプロイを回避します。

   例

   [ceph: root#host01 /]# ceph mgr module disable cephadm

2. クラスターの FSID を取得します。

   例

   [ceph: root#host01 /]# ceph fsid

3. cephadm シェルを終了します。

   例

   [ceph: root@host01 /]# exit

4. クラスター内のすべてのホストから Ceph デーモンをパージします。

   構文

   cephadm rm-cluster --force --zap-osds  --fsid FSID

   例

   [root@host01 ~]# cephadm rm-cluster --force --zap-osds  --fsid a6ca415a-cde7-11eb-a41a-002590fc2544

手順

1. Ansible 管理ノードにログインします。

2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. hosts ファイルを作成し、ホスト、ラベルを追加し、ストレージクラスター内の最初のホストの IP アドレスを監視します。

   構文

   sudo vi INVENTORY_FILE
   
   HOST1 labels="['LABEL1', 'LABEL2']"
   HOST2 labels="['LABEL1', 'LABEL2']"
   HOST3 labels="['LABEL1']"
   
   [admin]
   ADMIN_HOST monitor_address=MONITOR_IP_ADDRESS labels="['ADMIN_LABEL', 'LABEL1', 'LABEL2']"

   例

   [ceph-admin@admin cephadm-ansible]$ sudo vi hosts
   
   host02 labels="['mon', 'mgr']"
   host03 labels="['mon', 'mgr']"
   host04 labels="['osd']"
   host05 labels="['osd']"
   host06 labels="['osd']"
   
   [admin]
   host01 monitor_address=10.10.128.68 labels="['_admin', 'mon', 'mgr']"

4. プリフライト Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

5. クラスターをブートストラップする Playbook を作成します。

   構文

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: NAME_OF_PLAY
     hosts: BOOTSTRAP_HOST
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       -name: NAME_OF_TASK
        cephadm_registry_login:
          state: STATE
          registry_url: REGISTRY_URL
          registry_username: REGISTRY_USER_NAME
          registry_password: REGISTRY_PASSWORD
   
       - name: NAME_OF_TASK
         cephadm_bootstrap:
           mon_ip: "{{ monitor_address }}"
           dashboard_user: DASHBOARD_USER
           dashboard_password: DASHBOARD_PASSWORD
           allow_fqdn_hostname: ALLOW_FQDN_HOSTNAME
           cluster_network: NETWORK_CIDR

   例

   [ceph-admin@admin cephadm-ansible]$ sudo vi bootstrap.yml
   
   ---
   - name: bootstrap the cluster
     hosts: host01
     become: true
     gather_facts: false
     tasks:
       - name: login to registry
         cephadm_registry_login:
           state: login
           registry_url: registry.redhat.io
           registry_username: user1
           registry_password: mypassword1
   
       - name: bootstrap initial cluster
         cephadm_bootstrap:
           mon_ip: "{{ monitor_address }}"
           dashboard_user: mydashboarduser
           dashboard_password: mydashboardpassword
           allow_fqdn_hostname: true
           cluster_network: 10.10.128.0/28

6. Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE PLAYBOOK_FILENAME.yml -vvv

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts bootstrap.yml -vvv

手順

1. 次の手順を使用して、新しいホストをクラスターに追加します。

   1. Ansible 管理ノードにログインします。

   2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

      例

      [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

   3. 新しいホストとラベルを Ansible インベントリーファイルに追加します。

      構文

      sudo vi INVENTORY_FILE
      
      NEW_HOST1 labels="['LABEL1', 'LABEL2']"
      NEW_HOST2 labels="['LABEL1', 'LABEL2']"
      NEW_HOST3 labels="['LABEL1']"
      
      [admin]
      ADMIN_HOST monitor_address=MONITOR_IP_ADDRESS labels="['ADMIN_LABEL', 'LABEL1', 'LABEL2']"

      例

      [ceph-admin@admin cephadm-ansible]$ sudo vi hosts
      
      host02 labels="['mon', 'mgr']"
      host03 labels="['mon', 'mgr']"
      host04 labels="['osd']"
      host05 labels="['osd']"
      host06 labels="['osd']"
      
      [admin]
      host01 monitor_address= 10.10.128.68 labels="['_admin', 'mon', 'mgr']"

      注記

      新しいホストを Ansible インベントリーファイルに追加し、ホストでプリフライト Playbook を実行している場合は、ステップ 3 に進みます。

   4. --limit オプションを指定して、プリフライト Playbook を実行します。

      構文

      ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit NEWHOST

      例

      [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit host02

      プリフライト Playbook は、新しいホストに podman、lvm2、chrony、および cephadm をインストールします。インストールが完了すると、cephadm は /usr/sbin/ ディレクトリーに配置されます。

   5. 新しいホストをクラスターに追加する Playbook を作成します。

      構文

      sudo vi PLAYBOOK_FILENAME.yml
      
      ---
      - name: PLAY_NAME
        hosts: HOSTS_OR_HOST_GROUPS
        become: USE_ELEVATED_PRIVILEGES
        gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
        tasks:
          - name: NAME_OF_TASK
            ceph_orch_host:
              name: "{{ ansible_facts['hostname'] }}"
              address: "{{ ansible_facts['default_ipv4']['address'] }}"
              labels: "{{ labels }}"
            delegate_to: HOST_TO_DELEGATE_TASK_TO
      
          - name: NAME_OF_TASK
            when: inventory_hostname in groups['admin']
            ansible.builtin.shell:
              cmd: CEPH_COMMAND_TO_RUN
            register: REGISTER_NAME
      
          - name: NAME_OF_TASK
            when: inventory_hostname in groups['admin']
            debug:
              msg: "{{ REGISTER_NAME.stdout }}"

      注記

      デフォルトでは、Ansible は Playbook の hosts 行に一致するホストですべてのタスクを実行します。ceph orch コマンドは、管理キーリングと Ceph 設定ファイルを含むホストで実行する必要があります。delegate_to キーワードを使用して、クラスター内の管理ホストを指定します。

      例

      [ceph-admin@admin cephadm-ansible]$ sudo vi add-hosts.yml
      
      ---
      - name: add additional hosts to the cluster
        hosts: all
        become: true
        gather_facts: true
        tasks:
          - name: add hosts to the cluster
            ceph_orch_host:
              name: "{{ ansible_facts['hostname'] }}"
              address: "{{ ansible_facts['default_ipv4']['address'] }}"
              labels: "{{ labels }}"
            delegate_to: host01
      
          - name: list hosts in the cluster
            when: inventory_hostname in groups['admin']
            ansible.builtin.shell:
              cmd: ceph orch host ls
            register: host_list
      
          - name: print current list of hosts
            when: inventory_hostname in groups['admin']
            debug:
              msg: "{{ host_list.stdout }}"

      この例では、Playbook は新しいホストをクラスターに追加し、ホストの現在のリストを表示します。

   6. Playbook を実行して、追加のホストをクラスターに追加します。

      構文

      ansible-playbook -i INVENTORY_FILE PLAYBOOK_FILENAME.yml

      例

      [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts add-hosts.yml

2. 次の手順を使用して、クラスターからホストを削除します。

   1. Ansible 管理ノードにログインします。

   2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

      例

      [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

   3. クラスターからホストを削除する Playbook を作成します。

      構文

      sudo vi PLAYBOOK_FILENAME.yml
      
      ---
      - name: NAME_OF_PLAY
        hosts: ADMIN_HOST
        become: USE_ELEVATED_PRIVILEGES
        gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
        tasks:
          - name: NAME_OF_TASK
            ceph_orch_host:
              name: HOST_TO_REMOVE
              state: STATE
      
          - name: NAME_OF_TASK
            ceph_orch_host:
              name: HOST_TO_REMOVE
              state: STATE
            retries: NUMBER_OF_RETRIES
            delay: DELAY
            until: CONTINUE_UNTIL
            register: REGISTER_NAME
      
          - name: NAME_OF_TASK
            ansible.builtin.shell:
              cmd: ceph orch host ls
            register: REGISTER_NAME
      
          - name: NAME_OF_TASK
              debug:
                msg: "{{ REGISTER_NAME.stdout }}"

      例

      [ceph-admin@admin cephadm-ansible]$ sudo vi remove-hosts.yml
      
      ---
      - name: remove host
        hosts: host01
        become: true
        gather_facts: true
        tasks:
          - name: drain host07
            ceph_orch_host:
              name: host07
              state: drain
      
          - name: remove host from the cluster
            ceph_orch_host:
              name: host07
              state: absent
            retries: 20
            delay: 1
            until: result is succeeded
            register: result
      
           - name: list hosts in the cluster
             ansible.builtin.shell:
               cmd: ceph orch host ls
             register: host_list
      
           - name: print current list of hosts
             debug:
               msg: "{{ host_list.stdout }}"

      この例では、playbook タスクは host07 上のすべてのデーモンをドレインし、クラスターからホストを削除し、ホストの現在のリストを表示します。

   4. Playbook を実行して、クラスターからホストを削除します。

      構文

      ansible-playbook -i INVENTORY_FILE PLAYBOOK_FILENAME.yml

      例

      [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts remove-hosts.yml

手順

1. Ansible 管理ノードにログインします。

2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. 設定を変更して Playbook を作成します。

   構文

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: PLAY_NAME
     hosts: ADMIN_HOST
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       - name: NAME_OF_TASK
         ceph_config:
           action: GET_OR_SET
           who: DAEMON_TO_SET_CONFIGURATION_TO
           option: CEPH_CONFIGURATION_OPTION
           value: VALUE_OF_PARAMETER_TO_SET
   
       - name: NAME_OF_TASK
         ceph_config:
           action: GET_OR_SET
           who: DAEMON_TO_SET_CONFIGURATION_TO
           option: CEPH_CONFIGURATION_OPTION
         register: REGISTER_NAME
   
       - name: NAME_OF_TASK
         debug:
           msg: "MESSAGE_TO_DISPLAY {{ REGISTER_NAME.stdout }}"

   例

   [ceph-admin@admin cephadm-ansible]$ sudo vi change_configuration.yml
   
   ---
   - name: set pool delete
     hosts: host01
     become: true
     gather_facts: false
     tasks:
       - name: set the allow pool delete option
         ceph_config:
           action: set
           who: mon
           option: mon_allow_pool_delete
           value: true
   
       - name: get the allow pool delete setting
         ceph_config:
           action: get
           who: mon
           option: mon_allow_pool_delete
         register: verify_mon_allow_pool_delete
   
       - name: print current mon_allow_pool_delete setting
         debug:
           msg: "the value of 'mon_allow_pool_delete' is {{ verify_mon_allow_pool_delete.stdout }}"

   この例では、Playbook は最初に mon_allow_pool_delete オプションを false に設定します。その後、Playbook は現在の mon_allow_pool_delete 設定を取得し、その値を Ansible 出力に表示します。

4. Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE _PLAYBOOK_FILENAME.yml

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts change_configuration.yml

手順

1. Ansible 管理ノードにログインします。

2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. サービス仕様を使用して Playbook を作成します。

   構文

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: PLAY_NAME
     hosts: HOSTS_OR_HOST_GROUPS
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       - name: NAME_OF_TASK
         ceph_orch_apply:
           spec: |
             service_type: SERVICE_TYPE
             service_id: UNIQUE_NAME_OF_SERVICE
             placement:
               host_pattern: 'HOST_PATTERN_TO_SELECT_HOSTS'
               label: LABEL
             spec:
               SPECIFICATION_OPTIONS:

   例

   [ceph-admin@admin cephadm-ansible]$ sudo vi deploy_osd_service.yml
   
   ---
   - name: deploy osd service
     hosts: host01
     become: true
     gather_facts: true
     tasks:
       - name: apply osd spec
         ceph_orch_apply:
           spec: |
             service_type: osd
             service_id: osd
             placement:
               host_pattern: '*'
               label: osd
             spec:
               data_devices:
                 all: true

   この例では、Playbook はラベル osd を持つすべてのホストに Ceph OSD サービスをデプロイします。

4. Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE _PLAYBOOK_FILENAME.yml

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts deploy_osd_service.yml

手順

1. Ansible 管理ノードにログインします。

2. Ansible 管理ノードの /usr/share/cephadm-ansible ディレクトリーに移動します。

   例

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. デーモンの状態が変化する Playbook を作成します。

   構文

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: PLAY_NAME
     hosts: ADMIN_HOST
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       - name: NAME_OF_TASK
         ceph_orch_daemon:
           state: STATE_OF_SERVICE
           daemon_id: DAEMON_ID
           daemon_type: TYPE_OF_SERVICE

   例

   [ceph-admin@admin cephadm-ansible]$ sudo vi restart_services.yml
   
   ---
   - name: start and stop services
     hosts: host01
     become: true
     gather_facts: false
     tasks:
       - name: start osd.0
         ceph_orch_daemon:
           state: started
           daemon_id: 0
           daemon_type: osd
   
       - name: stop mon.host02
         ceph_orch_daemon:
           state: stopped
           daemon_id: host02
           daemon_type: mon

   この例では、Playbook は ID 0 で OSD を開始し、ID が host02 の Ceph Monitor を停止します。

4. Playbook を実行します。

   構文

   ansible-playbook -i INVENTORY_FILE _PLAYBOOK_FILENAME.yml

   例

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts restart_services.yml