Azure Kubernetes Service(AKS)ノードプールのノード構成をカスタマイズする

ノード構成をカスタマイズすることで、ワークロードのニーズに合わせてオペレーティング システム (OS) の設定または kubelet パラメーターを調整できます。 AKS クラスターを作成するか、クラスターにノード プールを追加すると、一般的に使用される OS と Kubelet の設定のサブセットをカスタマイズできます。 このサブセット以外の設定を構成するには、 デーモン セットを使用して、ノードの AKS サポートを失うことなく、必要な構成をカスタマイズします。

Prerequisites

サービスによって新しい設定と kubelet パラメーターのサポートが追加されるため、プレビュー機能フラグの登録が必要になる場合があります。 プレビュー フラグが必要な場合は、 カスタム ノード構成パラメーター参照 によって呼び出されます。

kubelet 設定の kubeReserved と hardEvictionThreshold のプレビュー要件

aks-preview Azure CLI 拡張機能をインストールする

1. aksプレビュー拡張機能をインストールして、次のコマンドを実行します：

   az extension add --name aks-preview
   

2. 次のコマンドを実行して、最新バージョンの拡張機能に更新します。

   az extension update --name aks-preview
   

プレビュー CustomNodeConfigPreview および kubeReserved kubelet 設定を使用する前に、Azure サブスクリプションに hardEvictionThreshold 機能フラグを登録してください。

CustomNodeConfigPreview フィーチャーフラグを登録する

1. CustomNodeConfigPreview コマンドを使用して、az feature register機能フラグを登録します。

   az feature register --namespace "Microsoft.ContainerService" --name "CustomNodeConfigPreview"
   

   状態が [登録済み] と表示されるまでに数分かかります。

2. az feature show コマンドを使用して、登録状態を確認します。

   az feature show --namespace "Microsoft.ContainerService" --name "CustomNodeConfigPreview"
   

3. 状態がRegisteredと表示されたら、 コマンドを使用して、az provider register リソース プロバイダーの登録を更新します。

   az provider register --namespace "Microsoft.ContainerService"
   

AKS ノード プール用のカスタム ノード構成ファイルを作成する

OS と kubelet の構成を変更するには、必要なパラメーターと設定を含む新しい構成ファイルを作成します。 パラメーターの値を指定しない場合は、既定値が使用されます。

Kubelet の構成

{
 "cpuManagerPolicy": "static",
 "cpuCfsQuota": true,
 "cpuCfsQuotaPeriod": "200ms",
 "imageGcHighThreshold": 90,
 "imageGcLowThreshold": 70,
 "topologyManagerPolicy": "best-effort",
 "allowedUnsafeSysctls": [
  "kernel.msg*",
  "net.*"
],
 "failSwapOn": false
}

{
  "cpuManagerPolicy": "static",
  "kubeReserved": {
    "cpuMillicores": 200,
    "memoryMB": 1024
  },
  "hardEvictionThreshold": {
    "memoryAvailable": "20%",
    "nodeFsAvailable": "10%",
    "nodeFsInodesFree": "5%"
  }
}

{
 "imageGcHighThreshold": 90,
 "imageGcLowThreshold": 70,
 "containerLogMaxSizeMB": 20,
 "containerLogMaxFiles": 6
}

OS 構成

{
 "transparentHugePageEnabled": "madvise",
 "transparentHugePageDefrag": "defer+madvise",
 "swapFileSizeMB": 1500,
 "sysctls": {
  "netCoreSomaxconn": 163849,
  "netIpv4TcpTwReuse": true,
  "netIpv4IpLocalPortRange": "32000 60000"
 }
}

カスタム構成ファイルを使用して AKS クラスターを作成する

az aks create コマンドを実行し、--kubelet-configパラメーターと--linux-os-config パラメーターに構成ファイルを指定して、カスタム構成ファイルを使用して新しいクラスターを作成します。 次のコマンド例では、カスタムの ./linuxkubeletconfig.json ファイルと ./linuxosconfig.json ファイルを使用して新しいクラスターを作成します。

az aks create --name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json --linux-os-config ./linuxosconfig.json

カスタム構成ファイルを使用してノード プールを追加する

az aks nodepool add --name <node-pool-name> --cluster-name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json

az aks nodepool add --name <node-pool-name> --cluster-name <cluster-name> --resource-group <resource-group-name> --os-type Windows --kubelet-config ./windowskubeletconfig.json

設定が適用されたことを確認する

カスタム ノード構成を適用した後、 ホストに接続 し、ファイルシステムで sysctl または構成の変更が行われていることを確認することで、設定がノードに適用されたことを確認できます。

サポートされているカスタム構成パラメーターを確認する

サポートされている kubelet および Linux OS 構成パラメーター、許可される値、既定値、および説明の完全な一覧については、 AKS のカスタム ノード構成パラメーターを参照してください。

カスタム ノード構成に関する考慮事項

ノード構成をカスタマイズするときは、次の考慮事項に注意してください。

• ノード イメージのアップグレードにより、カスタム ノード構成が再適用されます。
• スケールアウト操作では、カスタム ノード構成が保持されます。
• AKS では、すべてのカスタム ノード構成パラメーターまたは値に対してフライト前検証が実行されるわけではありません。 クラスター ノードの潜在的な問題を回避するために、指定したカスタム ノード構成パラメーターと値がサポートされ、有効であることを確認します。
• プレビューの kubeReserved と hardEvictionThreshold の設定は、Linux ノード プールでのみ使用できます。
• kubeReservedを構成する場合、値は正である必要があり、ターゲット ノード プールで使用可能な CPU またはメモリ容量を超えることはできません。
• hardEvictionThresholdを構成する場合は、サポートされているユニット (Ki、Mi、Gi、または%のmemoryAvailableとnodeFsAvailable)、および%の生の数値またはnodeFsInodesFreeのみを使用します。
• カスタム ノード構成パラメーターの既定値は、多くの場合、新しいオペレーティング システムバージョンで変更されます。 カスタム ノード構成を適用する場合は、構成するパラメーターの既定値を確認して、クラスター ノードの OS バージョンに対してカスタム設定が適切であることを確認します。
• クラスターの安定性とパフォーマンスに意図しない影響を与えないように、カスタム ノード構成を変更するアクセス許可を持つユーザーの数を制限します。 Kubernetes API に対する Microsoft Entra ID 承認を使用して、クラスター構成設定へのアクセスを制限することを検討してください。
• カスタム構成のあるノードプールは、カスタム構成のないノードプールと分離してください。これにより、特定の構成変更の影響を受けやすいワークロードへの意図しない影響を防ぐことができます。 たとえば、特定の kubelet 設定を必要とする重要なワークロードがある場合は、必要なカスタム kubelet 構成を使用して、そのワークロードを専用ノード プールに分離することを検討してください。

関連コンテンツ

• AKS クラスターを構成する方法を学習する。
• クラスター内 のノード イメージをアップグレードする 方法について説明します。
• 「Azure Kubernetes Service (AKS) クラスターのアップグレード」を参照し、クラスターを最新バージョンの Kubernetes にアップグレードする方法について学習する。
• AKS についてよく寄せられる質問に関する記事の一覧を参照し、AKS についての一般的な質問への回答を確認する。