第9章 ローカルディスク上の rootVolume および etcd を使用した OpenStack へのデプロイ

手順

1. 10 GB 以上のエフェメラルディスクを搭載したコントロールプレーンの Nova フレーバーを作成します。環境に応じて、--ram、--disk、および <flavor_name> の値を置き換えます。

   $ openstack flavor create --<ram 16384> --<disk 0> --ephemeral 10 --vcpus 4 <flavor_name>

2. コントロールプレーンのルートボリュームを含むクラスターをデプロイします。以下に例を示します。

   サンプル YAML ファイル

   # ...
   controlPlane:
     name: master
     platform:
       openstack:
         type: ${CONTROL_PLANE_FLAVOR}
         rootVolume:
           size: 25
           types:
           - ${CINDER_TYPE}
     replicas: 3
   # ...

3. 次のコマンドを実行して、作成したクラスターをデプロイします。

   $ openshift-install create cluster --dir <installation_directory>

   <installation_directory> には、以前に作成したカスタマイズ済みの ./install-config.yaml ファイルの場所を指定します。

4. 次の手順に進む前に、次のコマンドを実行して、デプロイしたクラスターが正常であることを確認します。

   $ oc wait clusteroperators --all --for=condition=Progressing=false

   出力を確認し、クラスター Operator の進行が完了しており、クラスターがデプロイまたは更新中でないことを確認します。

5. 次の YAML ファイルを使用して、98-var-lib-etcd.yaml という名前のファイルを作成します。

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: master
     name: 98-var-lib-etcd
   spec:
     config:
       ignition:
         version: 3.5.0
       systemd:
         units:
         - contents: |
             [Unit]
             Description=Mount local-etcd to /var/lib/etcd
   
             [Mount]
             What=/dev/disk/by-label/local-etcd
             Where=/var/lib/etcd
             Type=xfs
             Options=defaults,prjquota
   
             [Install]
             WantedBy=local-fs.target
           enabled: true
           name: var-lib-etcd.mount
         - contents: |
             [Unit]
             Description=Create local-etcd filesystem
             DefaultDependencies=no
             After=local-fs-pre.target
             ConditionPathIsSymbolicLink=!/dev/disk/by-label/local-etcd
   
             [Service]
             Type=oneshot
             RemainAfterExit=yes
             ExecStart=/bin/bash -c "[ -L /dev/disk/by-label/ephemeral0 ] || ( >&2 echo Ephemeral disk does not exist; /usr/bin/false )"
             ExecStart=/usr/sbin/mkfs.xfs -f -L local-etcd /dev/disk/by-label/ephemeral0
   
             [Install]
             RequiredBy=dev-disk-by\x2dlabel-local\x2detcd.device
           enabled: true
           name: create-local-etcd.service
         - contents: |
             [Unit]
             Description=Migrate existing data to local etcd
             After=var-lib-etcd.mount
             Before=crio.service
   
             Requisite=var-lib-etcd.mount
             ConditionPathExists=!/var/lib/etcd/member
             ConditionPathIsDirectory=/sysroot/ostree/deploy/rhcos/var/lib/etcd/member
   
             [Service]
             Type=oneshot
             RemainAfterExit=yes
   
             ExecStart=/bin/bash -c "if [ -d /var/lib/etcd/member.migrate ]; then rm -rf /var/lib/etcd/member.migrate; fi"
   
             ExecStart=/usr/bin/cp -aZ /sysroot/ostree/deploy/rhcos/var/lib/etcd/member/ /var/lib/etcd/member.migrate
             ExecStart=/usr/bin/mv /var/lib/etcd/member.migrate /var/lib/etcd/member
   
             [Install]
             RequiredBy=var-lib-etcd.mount
           enabled: true
           name: migrate-to-local-etcd.service
         - contents: |
             [Unit]
             Description=Relabel /var/lib/etcd
   
             After=migrate-to-local-etcd.service
             Before=crio.service
             Requisite=var-lib-etcd.mount
   
             [Service]
             Type=oneshot
             RemainAfterExit=yes
   
             ExecCondition=/bin/bash -c "[ -n \"$(restorecon -nv /var/lib/etcd)\" ]"
   
             ExecStart=/usr/sbin/restorecon -R /var/lib/etcd
   
             [Install]
             RequiredBy=var-lib-etcd.mount
           enabled: true
           name: relabel-var-lib-etcd.service

   各項目の説明:

   [マウント].What=/dev/disk/by-label/local-etcd

   etcd データベースは、ラベルではなくデバイスによってマウントする必要があります。この設定で使用されるデバイスの依存関係を systemd に生成させ、ファイルシステムの作成をトリガーするためです。

   [ユニット].ConditionPathIsSymbolicLink=!/dev/disk/by-label/local-etcd

   ファイルシステム dev/disk/by-label/local-etcd がすでに存在する場合は実行しないでください。

   [サービス].ExecStart=/usr/sbin/mkfs.xfs

   /dev/disk/by-label/ephemeral0 が存在しない場合は、警告メッセージが表示されて失敗します。

   [Unit].Before=crio.service

   既存のデータをローカル etcd データベースに移行します。この設定では、/var/lib/etcd がマウントされた後、CRI-O が起動する前に、つまり etcd がまだ実行されていないときにデータを移行します。

   [Unit].ConditionPathIsDirectory

   etcd をマウントすること、etcd にメンバーディレクトリーを含めないこと、および ostree にメンバーディレクトリーを含めることを必須とします。

   [Service].ExecStart=/bin/bash

   以前の移行状態をクリーンアップします。

   [サービス].ExecStart=/usr/bin/mv

   コピーと移動を別々のステップで実行し、完全なメンバーディレクトリーの作成をアトミック操作として実行します。

   [Service].ExecCondition=/bin/bash

   完全な再帰的なラベルの再設定を実行する前に、マウントポイントディレクトリーの簡単なチェックを実行します。ファイルパス /var/lib/etcd 内の restorecon がディレクトリーの名前を変更できない場合、再帰的な名前変更が実行されません。

   警告

   98-var-lib-etcd.yaml ファイルをシステムに適用した後は、ファイルを削除しないでください。このファイルを削除すると、etcd メンバーが壊れ、システムが不安定になります。

   ロールバックが必要な場合は、ControlPlaneMachineSet オブジェクトを変更して、一時ディスクを含まないフレーバーを使用します。この変更により、etcd パーティションに一時ディスクを使用せずにコントロールプレーンノードが再生成され、98-var-lib-etcd.yaml ファイルに関連する問題が回避されます。ControlPlaneMachineSet オブジェクトの更新が完了し、コントロールプレーンノードが一時ディスクを使用していない場合にのみ、98-var-lib-etcd.yaml ファイルを安全に削除できます。

6. 次のコマンドを実行して、新しい MachineConfig オブジェクトを作成します。

   $ oc create -f 98-var-lib-etcd.yaml

   注記

   etcd データベースを各コントロールプレーンマシンのローカルディスクに移動するには時間がかかります。

7. 次のコマンドを実行して、etcd データベースが各コントロールプレーンのローカルディスクに転送されたことを確認します。

   1. 次のコマンドを実行して、クラスターがまだ更新中であることを確認します。

      $ oc wait --timeout=45m --for=condition=Updating=false machineconfigpool/master

   2. 次のコマンドを実行して、クラスターの準備ができていることを確認します。

      $ oc wait node --selector='node-role.kubernetes.io/master' --for condition=Ready --timeout=30s

   3. 次のコマンドを実行して、クラスター Operators がクラスター内で実行されていることを確認します。

      $ oc wait clusteroperators --timeout=30m --all --for=condition=Progressing=false