1.7. コンテナーへの Ceph iSCSI ゲートウェイのインストール

手順

1. root ユーザーとして、/etc/ansible/hosts ファイルを開いて編集します。iSCSI ゲートウェイグループにノード名エントリーを追加します。

   例

   [iscsigws]
   ceph-igw-1
   ceph-igw-2

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

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

3. iscsigws.yml.sample ファイルのコピーを作成し、iscsigws.yml という名前を付けます。

   [root@admin ceph-ansible]# cp group_vars/iscsigws.yml.sample group_vars/iscsigws.yml

   重要

   新しいファイル名 (iscsigws.yml) と新しいセクション見出し (iscsigws) は、Red Hat Ceph Storage 3.1 以降にのみ適用されます。以前のバージョンの Red Hat Ceph Storage から 3.1 にアップグレードすると、古いファイル名 (iscsi-gws.yml) と古いセクション見出し (iscsi-gws) が引き続き使用されます。

   重要

   現在、Red Hat は、コンテナーベースのデプロイメントで ceph-ansible を使用してインストールする以下のオプションをサポートしていません。

   • gateway_iqn
   • rbd_devices
   • client_connections

   これらのオプションを手動で設定する手順について は、コンテナーでの Ceph iSCSI ゲートウェイの設定 セクションを参照してください。

4. iscsigws.yml ファイルを開いて編集します。

5. IPv4 アドレスまたは IPv6 アドレスを使用して、iSCSI ゲートウェイ IP アドレスを追加して、gateway_ip_list オプションを設定します。

   例

   gateway_ip_list: 192.168.1.1,192.168.1.2

   重要

   IPv4 アドレスと IPv6 アドレスを混在させることはできません。

6. 必要に応じて、trusted_ip_list オプションのコメントを解除し、SSL を使用する場合は IPv4 または IPv6 アドレスを適宜追加します。SSL を設定するには、iSCSI ゲートウェイコンテナーへの root アクセスが必要です。SSL を設定するには、以下の手順を実行します。

   1. 必要に応じて、すべての iSCSI ゲートウェイコンテナー内に openssl パッケージをインストールします。

   2. プライマリー iSCSI ゲートウェイコンテナーで、SSL キーを保持するディレクトリーを作成します。

      # mkdir ~/ssl-keys
      # cd ~/ssl-keys

   3. プライマリー iSCSI ゲートウェイコンテナーで、証明書とキーファイルを作成します。

      # openssl req -newkey rsa:2048 -nodes -keyout iscsi-gateway.key -x509 -days 365 -out iscsi-gateway.crt

      注記

      環境情報を入力するよう求められます。

   4. プライマリー iSCSI ゲートウェイコンテナーで、PEM ファイルを作成します。

      # cat iscsi-gateway.crt iscsi-gateway.key > iscsi-gateway.pem

   5. プライマリー iSCSI ゲートウェイコンテナーで、公開鍵を作成します。

      # openssl x509 -inform pem -in iscsi-gateway.pem -pubkey -noout > iscsi-gateway-pub.key

   6. プライマリー iSCSI ゲートウェイコンテナーから、iscsi-gateway.crt、iscsi-gateway.pem、iscsi-gateway-pub.key、および iscsi-gateway.key ファイルを他の iSCSI ゲートウェイコンテナーの /etc/ceph/ ディレクトリーにコピーします。

7. 必要に応じて、次の iSCSI ターゲット API サービスオプションのいずれかを確認し、コメントを解除します。

   #api_user: admin
   #api_password: admin
   #api_port: 5000
   #api_secure: false
   #loop_delay: 1
   #trusted_ip_list: 192.168.122.1,192.168.122.2

8. 必要に応じて、次のリソースオプションのいずれかを確認してコメントを外し、ワークロードのニーズに応じて更新します。

   # TCMU_RUNNER resource limitation
   #ceph_tcmu_runner_docker_memory_limit: 1g
   #ceph_tcmu_runner_docker_cpu_limit: 1
   
   # RBD_TARGET_GW resource limitation
   #ceph_rbd_target_gw_docker_memory_limit: 1g
   #ceph_rbd_target_gw_docker_cpu_limit: 1
   
   # RBD_TARGET_API resource limitation
   #ceph_rbd_target_api_docker_memory_limit: 1g
   #ceph_rbd_target_api_docker_cpu_limit: 1

9. Ansible のユーザーとして、Ansible のプレイブックを実行します。

   [user@admin ceph-ansible]$ ansible-playbook site-docker.yml --limit iscsigws

   Red Hat Enterprise Linux Atomic の場合、--skip-tags=with_pkg オプションを追加します。

   [user@admin ceph-ansible]$ ansible-playbook site-docker.yml --limit iscsigws --skip-tags=with_pkg

10. Ansible Playbook が完了したら、trusted_ip_list オプションにリストされている各ノードで、TCP ポート 3260 と iscsigws.yml ファイルで指定された api_port を開きます。

    注記

    api_port オプションが指定されていない場合、デフォルトのポートは 5000 です。