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

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

ノード カスタマイズ プレビューの前提条件

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

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

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

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

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

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

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

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 または構成の変更が行われていることを確認することで、設定がノードに適用されたことを確認できます。

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

Linux kubelet カスタム構成

Windows kubelet カスタム構成

Linux カスタム OS 構成設定

Linux ファイルハンドル制限

大量のトラフィックを提供する場合、そのトラフィックは通常、多数のローカル ファイルから送信されます。 次のカーネル設定と組み込みの制限を調整して、いくつかのシステム メモリを犠牲にして、より多くの処理を行うことができます。

次の表に、ノード プールごとにカスタマイズできるファイル ハンドルの制限を示します。

Linux ソケットとネットワークのチューニング

多数の同時セッションを処理することが予想されるエージェント ノードの場合は、次の TCP およびネットワーク オプションを使用し、ノード プールごとに調整できます。

Linux worker の制限

ファイル記述子の制限と同様に、プロセスで作成できるワーカーまたはスレッドの数は、カーネル設定とユーザー制限の両方により制限されます。 AKS のユーザー制限は無制限です。 次の表に、ノード プールごとにカスタマイズできるカーネル設定を示します。

Linux 仮想メモリ

次の表に、Linux カーネルの仮想メモリ (VM) サブシステムの操作とディスクへのダーティ データの writeout を調整するために、ノード プールごとにカスタマイズできるカーネル設定の一覧を示します。

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

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

• カスタム ノード構成は、ノード イメージのアップグレード中に再適用されます。
• カスタム ノード構成は、スケールアウト操作中も保持されます。
• 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 についての一般的な質問への回答を確認する。