az aks nodepool

在 Kubernetes kubernetes 叢集中管理節點集區的命令。

命令

az aks nodepool add

將節點集區新增至受控 Kubernetes 叢集。

az aks nodepool delete

刪除受控 Kubernetes 叢集中的代理程式組件區。

az aks nodepool get-upgrades

取得受控 Kubernetes 叢集代理程式組件區可用的升級版本。

az aks nodepool list

列出受控 Kubernetes 叢集中的節點集區。 若要取得叢集執行 kubectl get nodes 命令中的節點清單。

az aks nodepool operation-abort

中止 nodepool 上的上次執行作業。

az aks nodepool scale

調整受控 Kubernetes 叢集中的節點集區。

az aks nodepool show

顯示受控 Kubernetes 叢集中節點集區的詳細資料。

az aks nodepool snapshot

用來管理 nodepool 快照集的命令。

az aks nodepool snapshot create

建立 nodepool 快照集。

az aks nodepool snapshot delete

刪除 nodepool 快照集。

az aks nodepool snapshot list

列出 nodepool 快照集。

az aks nodepool snapshot show

顯示 nodepool 快照集的詳細資料。

az aks nodepool snapshot wait

等候 nodepool 快照集達到所需的狀態。

az aks nodepool start

在受控 Kubernetes 叢集中啟動已停止的代理程式組件區。

az aks nodepool stop

停止在受控 Kubernetes 叢集中執行代理程式組件區。

az aks nodepool update

更新節點集區屬性。

az aks nodepool upgrade

升級受控 Kubernetes 叢集中的節點集區。

az aks nodepool wait

等候節點集區達到所需的狀態。

az aks nodepool add

將節點集區新增至受控 Kubernetes 叢集。

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-ultra-ssd]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--min-count]
                    [--mode {System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {CBLMariner, Ubuntu, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--vnet-subnet-id]
                    [--zones {1, 2, 3}]

範例

在已啟用暫時 os 的現有 AKS 叢集中建立 nodepool。

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

建立已啟用 EncryptionAtHost 的 nodepool。

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

建立已啟用 UltraSSD 的 nodepool。

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

建立具有特定 OS SKU 的 nodepool 叢集

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

使用已啟用 FIPS 的 OS 建立 nodepool

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

建立具有快照集識別碼的 kubernetes 叢集。

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

在具有主機群組識別碼的現有 AKS 叢集中建立 nodepool

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

必要參數

--cluster-name

叢集名稱。

--name --nodepool-name -n

節點集區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--aks-custom-headers

以逗號分隔的索引鍵/值組來指定自訂標頭。

--enable-cluster-autoscaler -e

啟用叢集自動調整程式。

--enable-encryption-at-host

啟用 EncryptionAtHost,預設值為 false。

--enable-fips-image

在代理程式節點上使用已啟用 FIPS 的 OS。

--enable-node-public-ip

啟用 VMSS 節點公用 IP。

--enable-ultra-ssd

啟用 UltraSSD,預設值為 false。

--eviction-policy

現成節點集區的收回原則。 只有在 --priority 為 Spot 時,才能設定它。

接受的值: Deallocate, Delete
預設值: Delete
--gpu-instance-profile

用來分割多 gpu Nvidia GPU 的 GPU 實例設定檔。

接受的值: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

用來布建代理程式節點集區的完整專用主機群組識別碼。

--kubelet-config

包含代理程式節點 Kubelet 組態的 JSON 檔案路徑。 https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

用來建立叢集的 Kubernetes 版本,例如 「1.16.9」。

值來自: `az aks get-versions`
--labels

節點集區的節點標籤。 如需標籤的語法,請參閱 https://aka.ms/node-labels

--linux-os-config

包含 Linux 代理程式節點作業系統設定的 JSON 檔案路徑。 https://aka.ms/aks/custom-node-config.

--max-count

指定 「--enable-cluster-autoscaler」 時,用於自動調整程式的最大節點計數。 請為使用者 nodepool 指定 [0, 1000] 範圍中的值,並針對系統 nodepool 指定 [1,1000]。

--max-pods -m

可部署至節點的 Pod 數目上限。

--max-surge

用來加速升級的額外節點。 指定時,它代表所使用的數位或百分比,例如5 或 33%。

--min-count

指定 「--enable-cluster-autoscaler」 時,用於自動調整程式的最低節點計數。 請為使用者 nodepool 指定 [0, 1000] 範圍中的值,並針對系統 nodepool 指定 [1,1000]。

--mode

節點集區的模式,定義節點集區的主要函式。 如果設定為 「System」,AKS 偏好使用模式 System 排程至節點集區。 深入了解:https://aka.ms/aks/nodepool/mode

接受的值: System, User
預設值: User
--no-wait

不等候長時間執行的作業完成。

--node-count -c

Kubernetes 代理程式組件區中的節點數目。 建立叢集之後,您可以使用 來變更其節點集區 az aks scale 的大小。

預設值: 3
--node-osdisk-size

代理程式組件區中每個節點的 OS 磁片大小以 GB 為單位。 最小 30 GB。

--node-osdisk-type

要用於指定代理程式組件區中機器的 OS 磁片類型。 當可能與 VM 大小和 OS 磁片大小搭配使用時,預設為 「暫時」。 建立之後可能無法變更此集區。 ('Ephemeral' 或 'Managed') 。

接受的值: Ephemeral, Managed
--node-public-ip-prefix-id

用來將公用 IP 指派給 VMSS 節點的公用 IP 前置詞識別碼。

--node-taints

節點集區的節點污點 (taint)。

--node-vm-size -s

要建立為 Kubernetes 節點的虛擬機器大小。

--os-sku

代理程式節點集區的 OS SKU。 適用于 Linux 的 Ubuntu 或 CBLMariner。 Windows2019 或 Windows2022 for Windows。

接受的值: CBLMariner, Ubuntu, Windows2019, Windows2022
--os-type

OS 類型。 Linux 或 Windows。

--pod-subnet-id

要指派叢集中 Pod 的現有 VNet 中的子網資源識別碼 (需要 azure 網路外掛程式) 。

--ppg

PPG 的識別碼。

--priority

節點集區的優先順序。

接受的值: Regular, Spot
預設值: Regular
--scale-down-mode

描述如何將 VM 新增至 nodepools 或從 nodepools 中移除。

接受的值: Deallocate, Delete
預設值: Delete
--snapshot-id

用來建立這個 nodepool 的來源快照集識別碼。

--spot-max-price

只有在 --priority 為 Spot 時,才能設定它。 指定您願意以美元支付的最高價格。 可能的值為大於零或 -1 的任何十進位值,表示預設價格為隨選。 它最多隻能包含 5 個小數位數。

預設值: nan
--tags

空格分隔標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標籤。

--vnet-subnet-id

要在其中部署叢集的現有 VNet 中子網的資源識別碼。

--zones -z

將放置代理程式節點的可用性區域。

接受的值: 1, 2, 3

az aks nodepool delete

刪除受控 Kubernetes 叢集中的代理程式組件區。

az aks nodepool delete --cluster-name
                       --name
                       --resource-group
                       [--no-wait]

必要參數

--cluster-name

叢集名稱。

--name --nodepool-name -n

節點集區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--no-wait

不等候長時間執行的作業完成。

az aks nodepool get-upgrades

取得受控 Kubernetes 叢集代理程式組件區可用的升級版本。

az aks nodepool get-upgrades --cluster-name
                             --nodepool-name
                             --resource-group

範例

取得受控 Kubernetes 叢集代理程式組件區可用的升級版本。

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

必要參數

--cluster-name

叢集名稱。

--nodepool-name

節點集區的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az aks nodepool list

列出受控 Kubernetes 叢集中的節點集區。 若要取得叢集執行 kubectl get nodes 命令中的節點清單。

az aks nodepool list --cluster-name
                     --resource-group

必要參數

--cluster-name

叢集名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az aks nodepool operation-abort

中止 nodepool 上上次執行的作業。

az aks nodepool operation-abort --cluster-name
                                --nodepool-name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

範例

代理程式組件區上的中止作業

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

必要參數

--cluster-name

叢集名稱。

--nodepool-name

代理程式組件區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--aks-custom-headers

傳送自訂標頭。 指定時,格式應該是 Key1=Value1,Key2=Value2。

--no-wait

不等候長時間執行的作業完成。

az aks nodepool scale

調整受控 Kubernetes 叢集中的節點集區。

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--no-wait]
                      [--node-count]

必要參數

--cluster-name

叢集名稱。

--name --nodepool-name -n

節點集區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--no-wait

不等候長時間執行的作業完成。

--node-count -c

Kubernetes 節點集區中的節點數目。

預設值: 3

az aks nodepool show

顯示受控 Kubernetes 叢集中節點集區的詳細資料。

az aks nodepool show --cluster-name
                     --name
                     --resource-group

必要參數

--cluster-name

叢集名稱。

--name --nodepool-name -n

節點集區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

az aks nodepool start

在受控 Kubernetes 叢集中啟動已停止的代理程式組件區。

az aks nodepool start --cluster-name
                      --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

範例

在受控叢集中啟動代理程式組件區

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

必要參數

--cluster-name

叢集名稱。

--nodepool-name

代理程式組件區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--aks-custom-headers

傳送自訂標頭。 指定時,格式應該是 Key1=Value1,Key2=Value2。

--no-wait

不等候長時間執行的作業完成。

az aks nodepool stop

停止在受控 Kubernetes 叢集中執行代理程式組件區。

az aks nodepool stop --cluster-name
                     --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

範例

停止受控叢集中的代理程式組件區

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

必要參數

--cluster-name

叢集名稱。

--nodepool-name

代理程式組件區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--aks-custom-headers

傳送自訂標頭。 指定時,格式應該是 Key1=Value1,Key2=Value2。

--no-wait

不等候長時間執行的作業完成。

az aks nodepool update

更新節點集區屬性。

更新節點集區以啟用/停用叢集自動調整程式,或變更 min-count 或 max-count。 在沒有選擇性引數的情況下呼叫時,這會嘗試將節點集區移至其目標狀態,而不需要變更目前的節點集區組態。 這可用來移出非成功狀態。

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--disable-cluster-autoscaler]
                       [--enable-cluster-autoscaler]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-taints]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--update-cluster-autoscaler]

範例

將 nodepool 重新協調回其目前狀態。

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

在節點計數範圍內啟用叢集自動調整程式 [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

停用現有叢集的叢集自動調整程式

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

更新叢集自動調整程式的最小計數或最大值計數。

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

必要參數

--cluster-name

叢集名稱。

--name --nodepool-name -n

節點集區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--aks-custom-headers

以逗號分隔的索引鍵/值組,以指定自訂標頭。

--disable-cluster-autoscaler -d

停用叢集自動調整程式。

--enable-cluster-autoscaler -e

啟用叢集自動調整程式。

--labels

節點集區的節點標籤。 如需標籤的語法,請參閱 https://aka.ms/node-labels

--max-count

指定 「--enable-cluster-autoscaler」 時,用於自動調整程式的最大節點計數。 請為使用者 nodepool 指定 [0, 1000] 範圍的值,並針對系統 nodepool 指定 [1,1000]。

--max-surge

用來加速升級的額外節點。 指定時,它代表所使用的數位或百分比,例如5 或 33%。

--min-count

指定 「--enable-cluster-autoscaler」 時,用於自動調整程式的最低節點計數。 請為使用者 nodepool 指定 [0, 1000] 範圍的值,並針對系統 nodepool 指定 [1,1000]。

--mode

定義節點集區主要函式的節點集區模式。 如果設定為 「System」,AKS 偏好使用模式 System 排程至節點集區。 深入了解:https://aka.ms/aks/nodepool/mode

接受的值: System, User
--no-wait

不等候長時間執行的作業完成。

--node-taints

節點集區的節點污點 (taint)。 您可以更新 nodepool 的現有節點點,或為 nodepool 建立新的節點點。

--scale-down-mode

描述如何將 VM 新增至 nodepools 或從 nodepools 中移除。

接受的值: Deallocate, Delete
--tags

空格分隔標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標籤。

--update-cluster-autoscaler -u

更新叢集自動調整程式的最小計數或最大值計數。

az aks nodepool upgrade

升級受控 Kubernetes 叢集中的節點集區。

az aks nodepool upgrade --cluster-name
                        --name
                        --resource-group
                        [--aks-custom-headers]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--snapshot-id]

必要參數

--cluster-name

叢集名稱。

--name --nodepool-name -n

節點集區名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--aks-custom-headers

以逗號分隔的索引鍵/值組來指定自訂標頭。

--kubernetes-version -k

要升級節點集區的 Kubernetes 版本,例如 「1.16.9」。

--max-surge

用來加速升級的額外節點。 指定時,它代表所使用的數位或百分比,例如5 或 33% (與 「--node-image-only」 互斥。請參閱「az aks nodepool update --max-surge」,以在升級 「--node-image-only」 ) 之前更新最大激增。

--no-wait

不等候長時間執行的作業完成。

--node-image-only

僅升級代理程式組件區的節點映射。

--snapshot-id

用來升級此 nodepool 的來源快照集識別碼。

az aks nodepool wait

等候節點集區達到所需的狀態。

如果節點集區上的作業中斷或已開始使用 --no-wait ,請使用此命令等候它完成。

az aks nodepool wait --agent-pool-name
                     --name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

範例

等候節點集區達到所需的狀態,每分鐘輪詢最多 30 分鐘。

az aks nodepool wait --created --interval 60 --name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

必要參數

--agent-pool-name --nodepool-name

節點集區名稱。

--name -n

受控叢集的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--created

等候在 'Succeeded' 使用 'provisioningState' 建立。

--custom

等候條件符合自訂 JMESPath 查詢。 例如 provisioningState!='InProgress',instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

--exists

等候資源存在。

--interval

以秒為單位輪詢間隔。

預設值: 30
--timeout

等候時間上限,以秒為單位。

預設值: 3600
--updated

等候在 'Succeeded' 上使用 provisioningState 進行更新。