クラスターのノード プールを管理する (AKS on Azure Stack HCI 22H2)
適用対象: AKS on Azure Stack HCI 22H2、Windows Server 上の AKS
Note
AKS on Azure Stack HCI 23H2 でのノード プールの管理については、「 管理ノード プール」を参照してください。
Azure Arc によって有効になっている AKS では、同じ構成のノードが ノード プールにグループ化されます。 これらのノード プールには、お使いのアプリケーションを実行する基になる VM が含まれています。 この記事では、AKS Arc でクラスターのノード プールを作成および管理する方法について説明します。
Note
この機能により、複数のノード プールを作成および管理する方法をより詳細に制御できます。 その結果、作成、更新、削除の各操作には個別のコマンドが必要になります。 以前は、 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 コマンドを使用して、1 つのノードを持つ linuxnodepool という名前の 1 つの Linux ノード プールを持つ新しい Kubernetes クラスターを作成します。 以前のバージョンの AKS でクラスターが既にデプロイされていて、古いデプロイを引き続き使用する場合は、この手順をスキップできます。 新しいノード プール コマンドのセットを使用して、既存のクラスターにノード プールを追加することもできます。
New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType linux
Note
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 コマンドを使用します。 次の例では、mycluster クラスター内の linuxnodepool という名前のノード プール内のノード数を 3 にスケーリングします。
Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3
コントロール プレーン ノードをスケーリングします
コントロール プレーン ノードの管理は変更されていません。 作成、スケーリング、および削除の方法は変わりません。 値を指定しない場合は、 New-AksHciCluster コマンドを使用してコントロール プレーン ノードをデプロイし、パラメーターを controlPlaneNodeCount し、既定値をそれぞれ 1 とStandard_A4_V2で controlPlaneVmSize します。
場合によっては、アプリケーションのワークロード需要の変化に合わせて、コントロール プレーン ノードをスケーリングする必要があります。 コントロール プレーン ノードをスケーリングするには、Set-AksHciCluster コマンドを使用します。 次の例では、前の手順で作成した mycluster クラスターでコントロール プレーン ノードを 3 にスケーリングします。
Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3
ノード プールの削除
ノード プールを削除する必要がある場合は、Remove-AksHciNodePool コマンドを使用します。 次の例では、mycluster クラスターから windowsnodepool という名前のノード プールを削除します。
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
Note
テイントは、ノード プールを作成するときにノード プールに対してのみ設定できます。
次のコマンドを実行して、指定したテイントでノード プールが正常にデプロイされたことを確認します。
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