az aks nodepool

  • Reference

Příkazy pro správu fondů uzlů v clusteru Kubernetes Kubernetes

Příkazy

az aks nodepool add

Přidejte fond uzlů do spravovaného clusteru Kubernetes.
az aks nodepool delete

Odstraňte fond agentů ve spravovaném clusteru Kubernetes.
az aks nodepool get-upgrades

Získejte dostupné verze upgradu pro fond agentů spravovaného clusteru Kubernetes.
az aks nodepool list

Výpis fondů uzlů ve spravovaném clusteru Kubernetes Pokud chcete získat seznam uzlů v clusteru, spusťte kubectl get nodes příkaz .
az aks nodepool operation-abort

Přerušení poslední spuštěné operace ve fondu uzlů
az aks nodepool scale

Škálování fondu uzlů ve spravovaném clusteru Kubernetes
az aks nodepool show

Zobrazení podrobností o fondu uzlů ve spravovaném clusteru Kubernetes
az aks nodepool snapshot

Příkazy pro správu snímků fondu uzlů
az aks nodepool snapshot create

Vytvořte snímek fondu uzlů.
az aks nodepool snapshot delete

Odstraňte snímek fondu uzlů.
az aks nodepool snapshot list

Výpis snímků fondu uzlů
az aks nodepool snapshot show

Zobrazí podrobnosti o snímku fondu uzlů.
az aks nodepool snapshot wait

Počkejte, až se snímek fondu uzlů dostane do požadovaného stavu.
az aks nodepool start

Spusťte fond zastavených agentů ve spravovaném clusteru Kubernetes.
az aks nodepool stop

Zastavte spouštění fondu agentů ve spravovaném clusteru Kubernetes.
az aks nodepool update

Aktualizujte vlastnosti fondu uzlů.
az aks nodepool upgrade

Upgradujte fond uzlů ve spravovaném clusteru Kubernetes.
az aks nodepool wait

Počkejte, až fond uzlů dosáhne požadovaného stavu.

az aks nodepool add

Upravit

Přidejte fond uzlů do spravovaného clusteru 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, Mariner, 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}]

Příklady

Vytvořte fond uzlů v existujícím clusteru AKS s povoleným dočasným operačním systémem.

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

Vytvořte fond uzlů s povolenou službou EncryptionAtHost.

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

Vytvořte fond uzlů s povolenou funkcí UltraSSD.

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

Vytvoření clusteru fondu uzlů s konkrétní skladovou položkou operačního systému

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

Vytvoření fondu uzlů s operačním systémem s podporou FIPS

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

vytvořte cluster Kubernetes s ID snímku.

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"

Vytvoření fondu uzlů v existujícím clusteru AKS s ID skupiny hostitelů

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--aks-custom-headers

Dvojice klíč-hodnota oddělené čárkami pro určení vlastních hlaviček.

--enable-cluster-autoscaler -e

Povolte automatické škálování clusteru.

výchozí hodnota: False
--enable-encryption-at-host

Povolte EncryptionAtHost, výchozí hodnota je false.

výchozí hodnota: False
--enable-fips-image

Na uzlech agentů používejte operační systém s podporou FIPS.

výchozí hodnota: False
--enable-node-public-ip

Povolte veřejnou IP adresu uzlu VMSS.

výchozí hodnota: False
--enable-ultra-ssd

Povolte UltraSSD, výchozí hodnota je false.

výchozí hodnota: False
--eviction-policy

Zásady vyřazení fondu spotových uzlů. Dá se nastavit jenom v případech, kdy je --priority spot.

přijímané hodnoty: Deallocate, Delete
výchozí hodnota: Delete
--gpu-instance-profile

Profil instance GPU pro dělení grafických procesorů Nvidia s více gpu

přijímané hodnoty: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

Plně kvalifikované ID vyhrazené skupiny hostitelů, které se používá ke zřízení fondu uzlů agenta.

--kubelet-config

Cesta k souboru JSON obsahujícího konfigurace Kubeletu pro uzly agentů https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Verze Kubernetes, která se použije k vytvoření clusteru, například 1.16.9.

hodnota od: `az aks get-versions`
--labels

Popisky uzlů pro fond uzlů. Projděte si https://aka.ms/node-labels syntaxi popisků.

--linux-os-config

Cesta k souboru JSON obsahujícího konfigurace operačního systému pro uzly agenta linuxu https://aka.ms/aks/custom-node-config.

--max-count

Maximální počet uzlů použitých pro automatické škálování při zadání parametru --enable-cluster-autoscaler Zadejte hodnotu v rozsahu [0, 1000] pro fond uzlů uživatelů a [1 1000] pro fond uzlů systému.

--max-pods -m

Maximální počet podů, které lze nasadit do uzlu.

výchozí hodnota: 0
--max-surge

Další uzly používané k urychlení upgradu Pokud je zadaný, představuje počet nebo procento využití, např. 5 nebo 33 %.

--min-count

Minimální počet uzlů použitých pro automatické škálování, pokud je zadán parametr --enable-cluster-autoscaler. Zadejte hodnotu v rozsahu [0, 1000] pro fond uzlů uživatelů a [1 1000] pro fond uzlů systému.

--mode

Režim pro fond uzlů, který definuje primární funkci fondu uzlů. Pokud je nastavená hodnota Systém, dává AKS přednost plánování systémových podů před fondy uzlů s režimem System. Další informace najdete v tématu https://aka.ms/aks/nodepool/mode.

přijímané hodnoty: System, User
výchozí hodnota: User
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False
--node-count -c

Počet uzlů ve fondu agentů Kubernetes Po vytvoření clusteru můžete změnit velikost jeho fondu uzlů pomocí az aks scalepříkazu .

výchozí hodnota: 3
--node-osdisk-size

Velikost disku s operačním systémem pro každý uzel ve fondu agentů v GB Minimálně 30 GB.

výchozí hodnota: 0
--node-osdisk-type

Typ disku s operačním systémem, který se má použít pro počítače v daném fondu agentů. Pokud je to možné, ve spojení s velikostí virtuálního počítače a velikostí disku s operačním systémem je výchozí hodnota dočasný. Po vytvoření se pro tento fond nemusí změnit. ("Dočasné" nebo "spravované").

přijímané hodnoty: Ephemeral, Managed
--node-public-ip-prefix-id

ID předpony veřejné IP adresy používané k přiřazení veřejných IP adres uzlům VMSS.

--node-taints

Taints uzlu pro fond uzlů.

--node-vm-size -s

Velikost Virtual Machines, které se mají vytvořit jako uzly Kubernetes.

--os-sku

Skladová položka operačního systému fondu uzlů agenta. Ubuntu nebo CBLMariner pro Linux. Windows2019 nebo Windows2022 pro Windows.

přijímané hodnoty: CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

Typ operačního systému. Linux nebo Windows.

--pod-subnet-id

ID prostředku podsítě v existující virtuální síti, do které se mají přiřadit pody v clusteru (vyžaduje modul plug-in sítě Azure).

--ppg

The ID of a PPG.

--priority

Priorita fondu uzlů

přijímané hodnoty: Regular, Spot
výchozí hodnota: Regular
--scale-down-mode

Popište, jak se virtuální počítače přidávají do fondů uzlů nebo jak je z fondu uzlů odebírají.

přijímané hodnoty: Deallocate, Delete
výchozí hodnota: Delete
--snapshot-id

ID zdrojového snímku použitého k vytvoření tohoto fondu uzlů.

--spot-max-price

Dá se nastavit jenom v případech, kdy je priorita spotová. Zadejte maximální cenu, kterou jste ochotni zaplatit, v amerických dolarech. Možné hodnoty jsou jakákoli desetinná hodnota větší než nula nebo -1, která označuje výchozí cenu až na vyžádání. Může obsahovat maximálně 5 desetinných míst.

výchozí hodnota: nan
--tags

Značky oddělené mezerami: key[=value] [klíč[=hodnota] ...]. Pomocí příkazu vymažte existující značky.

--vnet-subnet-id

ID prostředku podsítě v existující virtuální síti, do které se má cluster nasadit.

--zones -z

Zóny dostupnosti, ve kterých budou umístěny uzly agentů. Pokud chcete nainstalovat uzly agenta do více než jedné zóny, musíte předat čísla zón oddělených prázdnými hodnotami. Například – Pokud chcete mít všechny 3 zóny, očekává se, že zadáte --zones 1 2 3.

přijímané hodnoty: 1, 2, 3

az aks nodepool delete

Upravit

Odstraňte fond agentů ve spravovaném clusteru Kubernetes.

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False

az aks nodepool get-upgrades

Upravit

Získejte dostupné verze upgradu pro fond agentů spravovaného clusteru Kubernetes.

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

Příklady

Získejte dostupné verze upgradu pro fond agentů spravovaného clusteru Kubernetes.

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

az aks nodepool list

Upravit

Výpis fondů uzlů ve spravovaném clusteru Kubernetes Pokud chcete získat seznam uzlů v clusteru, spusťte kubectl get nodes příkaz .

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

Povinné parametry

--cluster-name

Název clusteru.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

az aks nodepool operation-abort

Přerušení poslední spuštěné operace ve fondu uzlů

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

Příklady

Operace přerušení ve fondu agentů

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--aks-custom-headers

Odeslat vlastní hlavičky. Při zadání by měl být formát Key1=Hodnota1,Klíč2=Hodnota2.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False

az aks nodepool scale

Upravit

Škálujte fond uzlů ve spravovaném clusteru Kubernetes.

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False
--node-count -c

Počet uzlů ve fondu uzlů Kubernetes

výchozí hodnota: 3

az aks nodepool show

Upravit

Zobrazení podrobností o fondu uzlů ve spravovaném clusteru Kubernetes

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

az aks nodepool start

Upravit

Spusťte zastavený fond agentů ve spravovaném clusteru Kubernetes.

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

Příklady

Spuštění fondu agentů ve spravovaném clusteru

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--aks-custom-headers

Odeslat vlastní hlavičky. Při zadání by měl být formát Key1=Hodnota1,Klíč2=Hodnota2.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False

az aks nodepool stop

Upravit

Zastavte spouštění fondu agentů ve spravovaném clusteru Kubernetes.

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

Příklady

Zastavení fondu agentů ve spravovaném clusteru

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--aks-custom-headers

Odeslat vlastní hlavičky. Při zadání by měl být formát Key1=Hodnota1,Klíč2=Hodnota2.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False

az aks nodepool update

Upravit

Aktualizujte vlastnosti fondu uzlů.

Aktualizujte fond uzlů a povolte nebo zakažte automatické škálování clusteru nebo změňte minimální nebo maximální počet. Při volání bez volitelných argumentů se tento nástroj pokusí přesunout fond uzlů do cílového stavu beze změny aktuální konfigurace fondu uzlů. Můžete ho použít k přechodu z neúspěšného stavu.

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]

Příklady

Odsouhlaste fond uzlů zpět do aktuálního stavu.

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

Povolení automatického škálování clusteru v rozsahu počtu uzlů [1,5]

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

Zakázání automatického škálování clusteru pro existující cluster

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

Aktualizujte minimální nebo maximální počet pro automatické škálování clusteru.

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--aks-custom-headers

Dvojice klíč-hodnota oddělené čárkami pro určení vlastních hlaviček.

--disable-cluster-autoscaler -d

Zakažte automatické škálování clusteru.

výchozí hodnota: False
--enable-cluster-autoscaler -e

Povolte automatické škálování clusteru.

výchozí hodnota: False
--labels

Popisky uzlů pro fond uzlů. Projděte si https://aka.ms/node-labels syntaxi popisků.

--max-count

Maximální počet uzlů použitý pro automatické škálování, pokud je zadaný parametr "--enable-cluster-autoscaler". Zadejte hodnotu v rozsahu [0, 1000] pro fond uzlů uživatele a [1 1000] pro systémový fond uzlů.

--max-surge

Další uzly používané k urychlení upgradu. Pokud je zadaný, představuje počet nebo procento použití, např. 5 nebo 33 %.

--min-count

Minimální počet uzlů použitý pro automatické škálování, pokud je zadán parametr --enable-cluster-autoscaler. Zadejte hodnotu v rozsahu [0, 1000] pro fond uzlů uživatele a [1 1000] pro systémový fond uzlů.

--mode

Režim pro fond uzlů, který definuje primární funkci fondu uzlů. Pokud je nastavená možnost Systém, AKS dává přednost plánování systémových podů před fondy uzlů s režimem System. Další informace najdete na stránce https://aka.ms/aks/nodepool/mode.

přijímané hodnoty: System, User
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False
--node-taints

Taints uzlu pro fond uzlů. Můžete aktualizovat stávající taint uzlu fondu uzlů nebo vytvořit nový taint uzlu pro fond uzlů. Předáním prázdného řetězce "" odeberte všechny tainty.

--scale-down-mode

Popište, jak se virtuální počítače přidávají do fondů uzlů nebo jak se z fondu uzlů odebírají.

přijímané hodnoty: Deallocate, Delete
--tags

Značky oddělené mezerami: key[=value] [klíč[=hodnota] ...]. Pomocí příkazu vymažte existující značky.

--update-cluster-autoscaler -u

Aktualizujte minimální nebo maximální počet pro automatické škálování clusteru.

výchozí hodnota: False

az aks nodepool upgrade

Upravit

Upgradujte fond uzlů ve spravovaném clusteru Kubernetes.

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--aks-custom-headers

Dvojice klíč-hodnota oddělené čárkami pro určení vlastních hlaviček.

--kubernetes-version -k

Verze Kubernetes pro upgrade fondu uzlů na, například 1.16.9.

--max-surge

Další uzly používané k urychlení upgradu Pokud je zadaný, představuje počet nebo procento využití, např. 5 nebo 33 % (vzájemně se vylučují s "--node-image-only". Informace o aktualizaci maximálního přepětí před upgradem pomocí příkazu "---node-image-only" najdete v tématu az aks nodepool update --max-surge.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

výchozí hodnota: False
--node-image-only

Upgradujte jenom image uzlu fondu agentů.

výchozí hodnota: False
--snapshot-id

ID zdrojového snímku použitého k upgradu tohoto fondu uzlů.

az aks nodepool wait

Upravit

Počkejte, až fond uzlů dosáhne požadovaného stavu.

Pokud byla operace ve fondu uzlů přerušena nebo byla spuštěna pomocí --no-waitpříkazu , použijte tento příkaz a počkejte na dokončení.

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

Příklady

Počkejte, až fond uzlů dosáhne požadovaného stavu, a každou minutu se budete dotazovat až na třicet minut.

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

Povinné parametry

--cluster-name

Název clusteru.

--name --nodepool-name -n

Název fondu uzlů.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí příkazu az configure --defaults group=<name>.

Volitelné parametry

--created

Počkejte, až se vytvoří s provisioningState v úspěšném stavu.

výchozí hodnota: False
--custom

Počkejte, až podmínka splní vlastní dotaz JMESPath. Např. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte, až se odstraní.

výchozí hodnota: False
--exists

Počkejte, až prostředek bude existovat.

výchozí hodnota: False
--interval

Interval dotazování v sekundách.

výchozí hodnota: 30
--timeout

Maximální čekání v sekundách.

výchozí hodnota: 3600
--updated

Počkejte, až se aktualizuje s provisioningState na "Succeeded".

výchozí hodnota: False