ノードを開始およびシャットダウンする

このページでは、Automation Suite の手動および自動の起動時とシャットダウン時の動作について説明します。

重要:

必ず、一方のノードをシャットダウンして必要な操作を実行し、ノードが正常になるまで待ってから、もう一方のノードを停止して同じ操作を実行する必要があります。

次の表では、クラスター サービスまたはノードをシャットダウンするときに発生する可能性のあるさまざまなシナリオについて説明します。この表は、各状況に対して実行する必要がある詳細なアクションと、これらのアクションに対して期待される動作を理解するためのガイダンスを示しています。

シナリオ	操作	予想される行動
メンテナンスまたはその他の理由で、ノードをオフせずに 1 つのノード上のクラスター サービスをシャットダウンすること。	シャットダウン手順を手動で実行します。 手動の起動を使用するか、マシンを再起動して、サービスを再起動します。	HA シナリオでは、ほとんどのサービスが稼働したままになります。ノードは問題なく起動し、ダウンしたサービスは再起動するはずです。
メンテナンスまたはその他の理由により、ノードをオフせずにすべてのクラスター サービスをシャットダウンする。	エージェント ノードから始めて、すべてのノードで、シャットダウン手順を手動で実行します。 手動の起動を使用するか、サーバー ノードから始めてマシンを再起動して、サービスを再起動します。	サービスは利用できなくなります。ノードは問題なく起動するはずです。
すべてのノードをシャットダウンします。	ハイパーバイザー管理ポータル(VMware、AWSなど)で、マシンを強制終了せずにサービスを正常にシャットダウンできる場合は、通常のシャットダウンを実行します。デフォルトでは、systemdサブシステムは、サービスが強制終了する前にシャットダウンするための猶予期間を許可します。ただし、システムが設定されたシャットダウン時間を上書きすると、グレースフルシャットダウンが妨げられる可能性があります。 たとえば AWS では、プラットフォームによって 2 分後に仮想マシンを強制終了できます。そのため、ノードのドレインに最大で 5 分かかる可能性があるため、サービスを手動でシャットダウンする必要があります (これはグレースフル シャットダウンの要件です)。	シャットダウンが正常に行われる場合、ノードは問題なく起動するはずです。
個々のノードをシャットダウンする。	ハイパーバイザー管理ポータル(VMware、AWSなど)で、マシンを強制終了せずにサービスを正常にシャットダウンできる場合は、通常のシャットダウンを実行します。デフォルトでは、systemdサブシステムは、サービスが強制終了する前にシャットダウンするための猶予期間を許可します。ただし、システムが設定されたシャットダウン時間を上書きすると、グレースフルシャットダウンが妨げられる可能性があります。たとえば AWS では、プラットフォームによって 2 分後に仮想マシンを強制終了できます。そのため、ノードのドレインに最大で 5 分かかる可能性があるため、サービスを手動でシャットダウンする必要があります (これはグレースフル シャットダウンの要件です)。	シャットダウン プロセスが強制的でない場合、ノードは問題なく再起動します。
サーバー ノードを強制終了する。	該当なし。	ほとんどの場合、ノードは起動しますが、永続的なデータを使用する一部のサービスで問題が発生する可能性があります。通常、これらの問題は回復可能ですが、バックアップを設定することを強くお勧めします。 データが失われる可能性を防ぐため、Insights ポッドは元のノードがオンラインに戻るまで再起動されません。ノードが回復できない場合は、サポート チームに連絡してください。

起動時の動作

rke2-service が開始した後、node-drainer と node-uncordon が開始します。node-drainer は起動時に何も実行せず、サービスが稼働しているという確認を返すだけです。

node-uncordon は 1 回だけ実行され、ノードの遮断を解除する /opt/node-drain.sh nodestart を開始します。シャットダウン時に発生するドレイン手順の一部として、ノードが遮断され、スケジュールできなくなります。この状態は、rke2 サービスの開始後も維持されます。そのため、rke2-service の再起動後にノードの遮断を解除する必要があります。

手動の起動

このサービスは Automation Suite によって自動的に開始されます。ただし、手動で rke2-service を停止した場合は、次のコマンドを実行してサービスを再開する必要があります。

1. サーバー ノードで実行されている Kubernetes プロセスを開始します。

   systemctl start rke2-server

2. サーバー ノードで実行されている Kubernetes プロセスを開始します。

   systemctl start rke2-agent

3. rke2 サービスが開始したら、ノードの遮断を解除して、Kubernetes がこのノードでワークロードをスケジュールできるようにします。

   systemctl restart node-uncordon

4. ノードが起動したら、ノードをドレインする必要があります。

   systemctl start node-drain.service

   重要:

   手順 4 をスキップした場合、システムを再起動すると Kubelet サービスが異常な方法でシャットダウンする可能性があります。

シャットダウン時の動作

シャットダウン中、systemd は開始時の順序でサービスを停止します。node-drain サービスには After=rke2-server.service または After=rke2-agent.service ディレクティブが設定されているため、rke2-service をシャットダウンする前にシャットダウン シーケンスを実行します。つまり、適切に構成されたシステムでは、単にノードを正常にシャットダウンするのは安全な操作です。

手動の再起動

rke2 サービスを停止してマシンを再起動する場合は、次の手順を実行します。

1. ノード メンテナンス アクティビティの実行中にクラスターの健全性を確保するためには、そのノードで実行されているワークロードを他のノードにドレインする必要があります。ノードのドレインを行うには、次のコマンドを実行します。

   systemctl stop node-drain.service

2. サーバー ノードで実行されている Kubernetes プロセスを停止します。

   systemctl stop rke2-server

3. エージェント ノードで実行されている Kubernetes プロセスを停止します。

   systemctl stop rke2-agent

4. rke2 サービス、containerd、およびすべての子プロセスを終了します。

   rke2-killall.sh

   rke2-killall.shスクリプトをダウンロードするには、「インストール パッケージのダウンロード用リンク」をご覧ください。

インストール時に作成されるファイル

1. インストール中に、次のユニット ファイルが作成されます。
   • rke2-server.service (サーバーのみ)。rke2-server を開始します。これにより、サーバー ノードが開始されます。
   • rke2-agent.service (エージェントのみ)。rke2-agent を開始します。これにより、エージェント ノードが開始されます。
   • node-drain.service。シャットダウン時に使用されます。rke2-agent または rke2-server をシャットダウンする前に実行され、ドレインを実行します。タイムアウトは 300 秒です。
   • node-uncordon.service。起動時にノードの遮断を解除するために使用されます。
   • var-lib-kubelet.mount。fstab ジェネレーターによって自動生成されます。
   • var-lib-rancher-rke2-server-db.mount。fstab ジェネレーターによって自動生成されます。
   • var-lib-rancher.mount。fstab ジェネレーターによって自動生成されます。

ユニット ファイル間に強い依存関係はありません。ただし、node-drain と node-uncordon には After=rke2-server.service または After=rke2-agent.service ディレクティブが設定されています。つまり、これらのサービスは rke2-service の後に開始されます。