計画メンテナンスを使用して Azure Kubernetes Service クラスターのアップグレードをスケジュールおよび制御する

この記事では、計画メンテナンスを使用して、Azure Kubernetes Service (AKS) でクラスターとノード イメージのアップグレードをスケジュールおよび制御する方法について説明します。

AKS クラスターでは、定期的なメンテナンスが自動的に実行されます。 次の 2 種類のメンテナンス操作があります。

• AKS によって開始されるメンテナンスには、最新の機能と修正プログラムを使用してクラスターを最新の状態に保つために AKS が実行する毎週のリリースが含まれます。
• ユーザーが開始するメンテナンスには、クラスターの自動アップグレードとノード オペレーティング システム OS の自動セキュリティ更新プログラムが含まれます。

AKS の計画メンテナンスの機能を使用する場合、両方の種類のメンテナンスを任意の頻度で実行し、ワークロードへの影響を最小限に抑えることができます。 計画メンテナンスを使用して自動アップグレードのタイミングをスケジュールできますが、計画メンテナンスを有効または無効にしても、自動アップグレードは有効または無効になりません。

開始する前に

• この記事は、AKS クラスターがすでに存在していることを前提としています。 AKS クラスターがない場合は、AKS クラスターの作成に関するページを参照してください。
• Azure CLI を使用する場合、az upgrade コマンドを使用して最新バージョンにアップグレードしてください。

考慮事項

計画メンテナンスを使用する場合は、次の考慮事項が適用されます。

• AKS は、緊急または重大な計画外または事後対応のメンテナンス操作のために、計画メンテナンス期間を中断する権利を留保します。 これらのメンテナンス操作は、構成で定義されている notAllowedTime または notAllowedDates の期間中に実行される場合もあります。
• メンテナンス操作はベストエフォートのみと見なされており、指定した期間内に行われる保証はありません。

計画メンテナンスのスケジュール構成の種類

計画メンテナンスには、スケジュール構成の種類が 3 つあります。

• default は、AKS リリースを制御するための基本的な構成です。 これらのリリースは、Azure の安全なデプロイ プラクティス のため、最初の出荷時点からすべてのリージョンに展開されるまで最大 2 週間かかることがあります。

  最も中断が少ない方法でこれらの更新プログラムをスケジュールするには、default を選びます。 週間リリース トラッカーで、リージョン別に進行中の AKS リリースの状態を監視できます。

• aksManagedAutoUpgradeSchedule は、ユーザーが指定した自動アップグレード チャネルによってスケジュールされたクラスターのアップグレードをいつ実行するかを制御します。 この構成では、default 構成と比較して、より細かく制御された頻度と繰り返しの設定を構成できます。 クラスターの自動アップグレードについて詳しくは、Azure Kubernetes Service クラスターの自動アップグレードに関する記事をご覧ください。

• aksManagedNodeOSUpgradeSchedule は、ノード OS の自動アップグレード チャネルによってスケジュールされたノード OS のセキュリティ パッチ適用をいつ実行するかを制御します。 この構成では、default 構成と比較して、より細かく制御された頻度と繰り返しの設定を構成できます。 ノード OS の自動アップグレード チャネルについて詳しくは、AKS クラスター ノード イメージの自動的なパッチと更新に関する記事をご覧ください。

すべてのクラスター アップグレード シナリオには aksManagedAutoUpgradeSchedule を使い、すべてのノード OS セキュリティ パッチ適用シナリオには aksManagedNodeOSUpgradeSchedule を使うことをお勧めします。

default オプションは、AKS の毎週のリリース専用です。 default の構成は、az aks maintenanceconfiguration update コマンドを使用して aksManagedAutoUpgradeSchedule または aksManagedNodeOSUpgradeSchedule 構成に切り替えることができます。

メンテナンス期間の作成

計画メンテナンスの期間は、協定世界時 (UTC) で指定します。

default メンテナンス期間には、次のプロパティが用意されています。

aksManagedAutoUpgradeSchedule または aksManagedNodeOSUpgradeSchedule のメンテナンス期間には、次のプロパティがあります。

スケジュールの種類

使用できるスケジュールは、Daily、Weekly、AbsoluteMonthly、RelativeMonthly の4 種類です。

Weekly、AbsoluteMonthly、RelativeMonthly のスケジュールの種類は、aksManagedClusterAutoUpgradeSchedule と aksManagedNodeOSUpgradeSchedule の構成にのみ適用されます。 Daily のスケジュールは、aksManagedNodeOSUpgradeSchedule の構成にのみ適用されます。

スケジュールの種類ごとに表示されるすべてのフィールドが必須です。

Daily のスケジュールは、"3 日ごと" のようになります。

"schedule": {
    "daily": {
        "intervalDays": 3
    }
}

Weekly のスケジュールは "2 週間ごとの金曜日" のようになります。

"schedule": {
    "weekly": {
        "intervalWeeks": 2,
        "dayOfWeek": "Friday"
    }
}

AbsoluteMonthly のスケジュールは、"3 か月ごとに月の初日" のようになります。

"schedule": {
    "absoluteMonthly": {
        "intervalMonths": 3,
        "dayOfMonth": 1
    }
}

RelativeMonthly のスケジュールは、"2 か月ごとに最後の月曜日" のようになります。

"schedule": {
    "relativeMonthly": {
        "intervalMonths": 2,
        "dayOfWeek": "Monday",
        "weekIndex": "Last"
    }
}

weekIndex の有効な値には、First、Second、Third、Fourth、Last が含まれます。

メンテナンス期間の構成を追加する

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 1

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-time 00:00

既存のメンテナンス期間を更新する

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 2

既存のクラスター内のすべてのメンテナンス期間を一覧表示する

az aks maintenanceconfiguration list コマンドを使用して、AKS クラスターの現在のメンテナンス構成期間を一覧表示します。

az aks maintenanceconfiguration list --resource-group myResourceGroup --cluster-name myAKSCluster

既存のクラスター内の特定のメンテナンス構成期間を表示する

--name パラメータを指定した az aks maintenanceconfiguration show コマンドを使用して、AKS クラスター内の特定のメンテナンス構成期間を表示します。

az aks maintenanceconfiguration show --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule

次の出力例では、aksManagedAutoUpgradeSchedule のメンテナンス期間が示されています。

{
  "id": "/subscriptions/<subscription>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "maintenanceWindow": {
    "durationHours": 4,
    "notAllowedDates": [
      {
        "end": "2024-01-05",
        "start": "2023-12-23"
      }
    ],
    "schedule": {
      "absoluteMonthly": {
        "dayOfMonth": 1,
        "intervalMonths": 3
      },
      "daily": null,
      "relativeMonthly": null,
      "weekly": null
    },
    "startDate": "2023-01-20",
    "startTime": "09:00",
    "utcOffset": "-08:00"
  },
  "name": "aksManagedAutoUpgradeSchedule",
  "notAllowedTime": null,
  "resourceGroup": "myResourceGroup",
  "systemData": null,
  "timeInWeek": null,
  "type": null
}

既存のクラスターのメンテナンス構成期間を削除する

az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluster-name myAKSCluster --name autoUpgradeSchedule

az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluster-name myAKSCluster --name autoUpgradeSchedule

よく寄せられる質問

• クラスターの既存のメンテナンス構成を確認するにはどうすればよいですか?

  az aks maintenanceconfiguration show コマンドを使用します。

• 事後対応型で計画外のメンテナンスは、notAllowedTime または notAllowedDates の期間中にも行われますか?

  はい。 AKS では、緊急または重大な計画外または事後対応のメンテナンス操作のために、これらの期間を無効にする権利を留保します。

• メンテナンス イベントが発生したかどうかを確認するにはどうすればよいですか?

  リリースの場合は、クラスターのリージョンを確認し、毎週のリリースで情報を検索し、メンテナンス スケジュールと一致するかどうかを確認します。 自動アップグレードの状態を表示するには、クラスターのアクティビティ ログを検索します。 AKS クラスターのアップグレードに関する記事で説明されているように、特定のアップグレード関連イベントを検索することもできます。

  AKS は、アップグレード関連の Azure Event Grid イベントも生成します。 詳細については、「Event Grid ソースとしての AKS」を参照してください。

• 同時に複数のメンテナンス構成を使用できますか?

  はい。3 つの構成 (default、aksManagedAutoUpgradeSchedule、aksManagedNodeOSUpgradeSchedule) をすべて同時に実行できます。 ウィンドウが重なる場合、AKS によって実行順序が決定されます。

• メンテナンス期間を構成しましたが、アップグレードが行われませんでした。 なぜですか?

  AKS の自動アップグレードでは、メンテナンス期間を考慮に入れるのに一定の時間が必要です。 メンテナンス構成の作成または更新からスケジュールされた開始日時まで、少なくとも 24 時間は空けることをお勧めします。

  また、計画メンテナンス期間の開始時にクラスターが起動していることを確認してください。 クラスターが停止している場合、そのコントロール プレーンは割り当てが解除され、操作は実行できません。

• エージェント プールの 1 つがメンテナンス期間外にアップグレードされたのはなぜですか?

  エージェント プールがアップグレードされていない場合 (たとえば、ポッド中断バジェットによってそれが妨げられたため)、後でメンテナンス期間外にアップグレードされる可能性があります。 このシナリオは、"キャッチアップ アップグレード" と呼ばれます。これにより、AKS コントロール プレーンとは異なるバージョンでエージェント プールがアップグレードされることが回避されます。

• メンテナンス構成のベスト プラクティスはありますか?

  NodeImage チャネルを使用している場合、新しいノード イメージが毎週発行されるため、 ノード OS のセキュリティ更新プログラムのスケジュールを週単位に設定することをお勧めします。 また、SecurityPatch チャネルをオプトインして、セキュリティ更新プログラムを毎日受け取ることもできます。

  自動アップグレード スケジュールを月単位に設定して、Kubernetes N-2 サポート ポリシーを最新の状態に保ちます。

  アップグレードのベスト プラクティスとその他の考慮事項の詳細については、AKS のパッチとアップグレード ガイダンスのページを参照してください。

次のステップ

• AKS クラスターのアップグレードを開始するには「AKS クラスターのアップグレード オプション」を参照してください。