Worker Node Pool の OS イメージバージョンを変更する
M-FKE クラスターの Worker Node は Ubuntu 上で動作します。このリリースから、クラスター作成時や Worker Group 追加時に Ubuntu 22.04 または Ubuntu 24.04 を選択できるようになり、Worker Group を再作成せずに Portal 上で直接、実行中の Worker Group の OS バージョンを変更できます。
これにより、長期的なセキュリティパッチの提供が続く OS バージョンへワークロードを移行したり、アプリケーションがまだ対応していない場合は以前のバージョンに戻したりできます。
対象ユーザー
| ロール | 説明 |
|---|---|
| Cluster Operator | OS バージョンの確認、クラスターや Worker Group 作成時の OS 選択、実行中の Worker Group の OS バージョン変更 |
| その他の VPC メンバー | Portal に既存の Worker Group 編集権限に従います |
できること
| 機能 | 説明 |
|---|---|
| 作成時に OS を選択 | クラスターの Kubernetes バージョンに対応したリストから、新しい Worker Group に Ubuntu 22.04 または 24.04 を選択 |
| OS をアップグレード | 実行中の Worker Group を Ubuntu 22.04 から 24.04 に変更 |
| OS をダウングレード | 必要に応じて Ubuntu 22.04 に戻す（回数制限なし） |
| 複数の Worker Group を一度に変更 | 同じ画面で複数の Worker Group の OS バージョンを変更 |
| Auto Patch OS Image | 同じ OS バージョン内でのセキュリティパッチの自動適用を有効化 |
利用できる OS バージョンは、クラスターの Kubernetes バージョンによって異なります。
| Kubernetes バージョン | 対応 OS | デフォルト |
|---|---|---|
| v1.33 未満 | Ubuntu 22.04 | Ubuntu 22.04 |
| v1.33 〜 v1.36 | Ubuntu 22.04 または Ubuntu 24.04 | Ubuntu 24.04 |
1. Worker Group 追加時に OS を選択する
手順 1: Portal で対象の Kubernetes クラスターを開き、Worker Group タブを選択して Add Worker Group をクリックします。
手順 2: 通常どおり Worker Group の設定（名前、flavor、node 数、disk）を入力します。
手順 3: OS image フィールドに Ubuntu と Version のドロップダウンが表示されます。リストにはクラスターの Kubernetes バージョンに対応したバージョンのみが表示され、推奨バージョンがあらかじめ選択されています。
手順 4: 推奨バージョンのままにするか、リストから別のバージョンを選択します。
手順 5: Create をクリックして Worker Group を作成します。
選択した OS バージョンで新しい Worker Group が作成されます。このバージョンは Worker Group 詳細画面に表示されます。
2. 実行中の Worker Group の OS バージョンを変更する
開始する前に、Worker Group が Running または Succeeded 状態であり、他の操作（リサイズ、Kubernetes バージョンのアップグレードなど）が実行中でないことを確認してください。
手順 1: クラスターの Worker Group タブを開き、OS を変更したい Worker Group を選択します。
手順 2: Worker Group の詳細画面で、OS image フィールドの Version ドロップダウンを開きます。クラスターの Kubernetes バージョンと互換性のないバージョンはグレーアウトされ、選択できません。
手順 3: 切り替えたいバージョンを選択します。上位バージョンを選べばアップグレード、下位バージョンを選べばロールバックになります。バージョンを選択すると即座に変更が適用され、別途確認する手順はありません。
手順 4: 複数の Worker Group を変更する場合は、各 Worker Group に対してこの手順を繰り返します。
その後、システムが Worker Group の node を新しい OS バージョンへ順番に入れ替えます。完了すると Version フィールドに新しいバージョンが表示されます。処理が失敗した場合、Worker Group は以前の OS バージョンを保持するので再試行できます。
3. Auto Patch OS Image を有効にする
Auto Patch OS Image は、同じ OS バージョン内でのみセキュリティパッチを適用します。この機能だけで Worker Group の OS バージョンが変わることはありません。
手順 1: Worker Group の詳細画面を開きます。
手順 2: Auto Patch OS Image トグルを有効にします。フィールド名の横にある情報アイコンにマウスを合わせると説明が表示されます。
手順 3: この機能を有効にしても OS バージョンは変わらないことを知らせるバナーが表示されます。
Kubernetes バージョン v1.33 以降のクラスターでは、Auto Patch OS Image はまだ利用できないため、トグル自体が表示されません。
UI リファレンス
| 項目 | 意味 |
|---|---|
| OS image | Worker Node のオペレーティングシステム。現在は Ubuntu に固定 |
| Version | Ubuntu のバージョンを選択するドロップダウン。互換性のないバージョンは disable されます |
| Beta ラベル | この機能はテスト段階であり、継続的に改善されています |
| Auto Patch OS Image | 同じ OS バージョン内でセキュリティパッチを有効化。バージョン自体は変更されません |
Worker Group の状態
| 状態 | 意味 |
|---|---|
| Running / Succeeded | Worker Group は安定しており、OS バージョンを変更できます |
| 更新中 | システムが node を新しい OS バージョンへ順番に入れ替えています |
| Error | バージョン変更に失敗しました。Worker Group は以前の OS バージョンを保持し、再試行できます |
トラブルシューティング
| 状況 | 対処法 |
|---|---|
| 選択したいバージョンがドロップダウンでグレーアウトしている | そのバージョンはクラスターの Kubernetes バージョンとまだ互換性がありません。先に Kubernetes バージョンをアップグレードするか、別の OS バージョンを選択してください |
| バージョン変更が失敗した | Worker Group は以前の OS バージョンを保持します。VPC の空きリソースを確認してから再試行してください |
| OS バージョン変更中に接続が切れた | 処理はシステム側で継続しています。ページを再読み込みして進行状況を確認してください |
| Auto Patch を有効にしても OS バージョンが変わらない | 設計どおりの動作です。Auto Patch は同じバージョン内のパッチのみを適用します。バージョンを変更するには、Version ドロップダウンで別のバージョンを選択してください |
推奨事項:
- node が順番に入れ替わるため、OS バージョンを変更する前にワークロードの PodDisruptionBudget と replica 数を確認してください。
- 本番環境の Worker Group に適用する前に、小さな Worker Group で試してください。
- ピーク時間帯に OS バージョン変更を開始しないでください。
- 処理を開始すると、成功または失敗するまで実行され、途中でキャンセルすることはできません。