クラスターのノード プールを管理する (AKS on Azure Stack HCI 22H2)
適用対象: AKS on Azure Stack HCI 22H2、AKS on Windows Server
注意
AKS on Azure Stack HCI 23H2 でのノード プールの管理については、「 ノード プールの管理」を参照してください。
Azure Arc によって有効になっている AKS では、同じ構成のノードが ノード プールにグループ化されます。 これらのノード プールには、お使いのアプリケーションを実行する基になる VM が含まれています。 この記事では、AKS Arc でクラスターのノード プールを作成および管理する方法について説明します。
注意
この機能を使用すると、複数のノード プールを作成および管理する方法をより細かく制御できます。 その結果、作成、更新、および削除の操作には、個別のコマンドが必要になります。 以前は、 New-AksHciCluster または Set-AksHciCluster を使用したクラスター操作は、1 つの Windows ノード プールと 1 つの Linux ノード プールを使用してクラスターを作成またはスケーリングする唯一のオプションでした。 この機能により、ノード プール用の個別の操作セットが公開されることになり、ノード プール コマンド New-AksHciNodePool、Set-AksHciNodePool、Get-AksHciNodePool、および Remove-AksHciNodePool を使用して、個々のノード プールに対して操作を実行する必要があります。
開始する前に
バージョン 1.1.6 をインストールすることをお勧めします。 PowerShell モジュールが既にインストールされている場合は、次のコマンドを実行してバージョンを見つけます。
Get-Command -Module AksHci
PowerShell を更新する必要がある場合は、「 AKS ホストのアップグレード」の手順に従います。
AKS クラスターを作成する
まず、1 つのノード プールで AKS クラスターを作成開始します。 次の例では、 New-AksHciCluster コマンドを使用して、 linuxnodepool という名前の 1 つの Linux ノード プール (ノードが 1 つ) を持つ新しい Kubernetes クラスターを作成します。 以前のバージョンの AKS でクラスターが既にデプロイされていて、古いデプロイを引き続き使用する場合は、この手順をスキップできます。 新しいノード プール コマンドのセットを使用して、既存のクラスターにノード プールを追加することもできます。
New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType linux
注意
の古いパラメーター セット New-AksHciCluster
は引き続きサポートされています。
ノード プールの追加
前の手順で作成した *' という名前 mycluster
のクラスターには、1 つのノード プールがあります。
New-AksHciNodePool コマンドを使用して、既存のクラスターに 2 番目のノード プールを追加できます。 次の例では、1 つのノードを持つ windowsnodepool という名前の Windows ノード プールを作成します。 ノード プールの名前が既存のノード プールと同じ名前ではないことを確認します。
New-AksHciNodePool -clusterName mycluster -name windowsnodepool -count 1 -osType Windows -osSku Windows2022
ノード プールの構成情報を取得する
ノード プールの構成情報を確認するには、Get-AksHciNodePool コマンドを使用します。
Get-AksHciNodePool -clusterName mycluster
出力例:
ClusterName : mycluster
NodePoolName : linuxnodepool
Version : v1.20.7
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
ClusterName : mycluster
NodePoolName : windowsnodepool
Version : v1.20.7
OsType : Windows
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
1 つの特定のノード プールの構成情報を表示するには、Get-AksHciNodePool の パラメーターを使用-name
します。
Get-AksHciNodePool -clusterName mycluster -name linuxnodepool
出力例:
ClusterName : mycluster
NodePoolName : linuxnodepool
Version : v1.20.7
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Get-AksHciNodePool -clusterName mycluster -name windowsnodepool
出力例:
ClusterName : mycluster
NodePoolName : windowsnodepool
Version : v1.20.7
OsType : Windows
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Note
New-AksHciCluster
で新しいパラメーター セットを使用してクラスターをデプロイしてから、クラスター情報を取得するために Get-AksHciCluster
を実行すると、WindowsNodeCount
と LinuxNodeCount
のフィールドに 0
出力が返されます。 各ノード プール内のノードの正確な数を取得するには、指定したクラスター名の コマンド Get-AksHciNodePool
を使用します。
ノード プールのスケーリング
ノード プールのノード数をスケールアップまたはスケールダウンできます。
ノード プールのノード数をスケーリングするには、Set-AksHciNodePool コマンドを使用します。 次の例では、クラスター内の という名前 linuxnodepool
のノード プール内のノード数を 3 に mycluster
スケーリングします。
Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3
コントロール プレーン ノードをスケーリングします
コントロール プレーン ノードの管理は変更されていません。 作成、スケーリング、および削除の方法は変わりません。 値を指定しない場合は、 New-AksHciCluster コマンドでパラメーター controlPlaneNodeCount
を指定し controlPlaneVmSize
、既定値はそれぞれ 1 とStandard_A4_V2を使用してコントロール プレーン ノードをデプロイします。
場合によっては、アプリケーションのワークロード需要の変化に合わせて、コントロール プレーン ノードをスケーリングする必要があります。 コントロール プレーン ノードをスケーリングするには、Set-AksHciCluster コマンドを使用します。 次の例では、前の手順で作成したクラスター内の mycluster
コントロール プレーン ノードを 3 にスケーリングします。
Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3
ノード プールの削除
ノード プールを削除する必要がある場合は、Remove-AksHciNodePool コマンドを使用します。 次の例では、 という名前 windowsnodepool
のノード プールを mycluster
クラスターから削除します。
Remove-AksHciNodePool -clusterName mycluster -name windowsnodepool
ノード プールにテイントを指定する
ノード プールを作成するときに、テイントをそのノード プールに追加できます。 テイントを追加すると、そのノード プール内のすべてのノードもそのテイントを取得します。 テイントと容認について詳しくは、Kubernetes のテイントと容認に関する記事をご覧ください。
ノード プールのテイントの設定
テイントが指定されたノード プールを作成するには、New-AksHciNodePool を使用します。 という名前 taintnp
を指定し、 パラメーターを -taints
使用してテイントを指定 sku=gpu:noSchedule
します。
New-AksHciNodePool -clusterName mycluster -name taintnp -count 1 -osType linux -taints sku=gpu:NoSchedule
注意
テイントは、ノード プールを作成するときにノード プールに対してのみ設定できます。
次のコマンドを実行して、指定したテイントを使用してノード プールが正常にデプロイされたことを確認します。
Get-AksHciNodePool -clusterName mycluster -name taintnp
出力
Status : {Phase, Details}
ClusterName : mycluster
NodePoolName : taintnp
Version : v1.20.7-kvapkg.1
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Taints : {sku=gpu:NoSchedule}
前の手順では、ノード プールの作成時に sku=gpu:NoSchedule テイントを適用しました。 次の YAML マニフェストの基本例では、Kubernetes スケジューラがそのノードプール内のノードで NGINX ポッドを実行できるように toleration を使用しています。
という名前 nginx-toleration.yaml
のファイルを作成し、次のテキストの情報をコピーします。
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- image: mcr.microsoft.com/oss/nginx/nginx:1.15.9-alpine
name: mypod
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 1
memory: 2G
tolerations:
- key: "sku"
operator: "Equal"
value: "gpu"
effect: "NoSchedule"
次に、次のコマンドを使用してポッドをスケジュールします。
kubectl apply -f nginx-toleration.yaml
そのポッドがデプロイされていることを確認するために、次のコマンドを実行します。
kubectl describe pod mypod
[...]
Tolerations: node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
sku=gpu:NoSchedule
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Scheduled 32s default-scheduler Successfully assigned default/mypod to moc-lk4iodl7h2y
Normal Pulling 30s kubelet Pulling image "mcr.microsoft.com/oss/nginx/nginx:1.15.9-alpine"
Normal Pulled 26s kubelet Successfully pulled image "mcr.microsoft.com/oss/nginx/nginx:1.15.9-alpine" in 4.529046457s
Normal Created 26s kubelet Created container mypod