Címkék használata Egy Azure Kubernetes Service-fürtben (AKS)

  • Cikk

If you have multiple node pools, you may want to add a label during node pool creation. A Kubernetes-címkék kezelik a csomópontok ütemezési szabályait. A csomópontkészlethez bármikor hozzáadhat címkéket, és alkalmazhatja őket a csomópontkészlet összes csomópontja számára.

Ebben az útmutatóban megtudhatja, hogyan használhat címkéket egy Azure Kubernetes Service-fürtben.

Előfeltételek

Telepítenie és konfigurálnia kell az Azure CLI 2.2.0-s vagy újabb verzióját. A verzió azonosításához futtassa a következőt: az --version. Ha telepíteni vagy frissíteni szeretne: Az Azure CLI telepítése.

Create an AKS cluster with a label

  1. Hozzon létre egy AKS-fürtöt egy címkével a az aks create parancs használatával, és adja meg a --node-labels címkék beállításához használt paramétert. A címkéknek kulcs/érték párnak kell lenniük, és érvényes szintaxissal kell rendelkezniük.

    az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --node-count 2 \
    --nodepool-labels dept=IT costcenter=9000

  2. Ellenőrizze, hogy a címkék a kubectl get nodes --show-labels parancs használatával lettek-e beállítva.

    kubectl get nodes --show-labels | grep -e "costcenter=9000" -e "dept=IT"

Create a node pool with a label

  1. Hozzon létre egy csomópontkészletet egy címkével a az aks nodepool add parancs használatával, és adja meg a --name paraméter paramétereinek és címkéinek --labels nevét. A címkéknek kulcs/érték párnak kell lenniük, és érvényes szintaxissal kell rendelkezniük

    Az alábbi példaparancs létrehoz egy labelnp nevű csomópontkészletet a dept=HR és costcenter=5000 címkékkel.

    az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name labelnp \
    --node-count 1 \
    --labels dept=HR costcenter=5000 \
    --no-wait

    A parancs következő példakimenete az aks nodepool list azt mutatja, hogy a labelnp csomópontkészlet a megadott nodeLabels csomópontokkal hoz létre csomópontokat:

    [
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]

  2. Ellenőrizze, hogy a címkék a kubectl get nodes --show-labels parancs használatával lettek-e beállítva.

    kubectl get nodes --show-labels | grep -e "costcenter=5000" -e "dept=HR"

Updating labels on existing node pools

  1. Egy meglévő csomópontkészlet címkéjének frissítése a az aks nodepool update parancs használatával. A meglévő csomópontkészletek címkéinek frissítése felülírja a régi címkéket az új címkékkel. A címkéknek kulcs/érték párnak kell lenniük, és érvényes szintaxissal kell rendelkezniük.

    az aks nodepool update \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name labelnp \
    --labels dept=ACCT costcenter=6000 \
    --no-wait

  2. Ellenőrizze, hogy a címkék a kubectl get nodes --show-labels parancs használatával lettek-e beállítva.

    kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"

Nem érhető el címkék

Fenntartott rendszercímkék

A 2021-08-19-es AKS-kiadás óta az AKS leállította a fenntartott AKS-címkék módosítását. Ha megkísérli módosítani ezeket a címkéket, hibaüzenet jelenik meg.

A következő címkék a fenntartott AKS-címkék. A virtuális csomópontok használata meghatározza, hogy ezek a címkék támogatott rendszerfunkciók lehetnek-e a virtuális csomópontokon. Egyes tulajdonságok, amelyeket ezek a rendszerfunkciók módosítanak, nem érhetők el a virtuális csomópontokon, mert módosítaniuk kell a gazdagépet.

Felirat Érték Példa/beállítások Virtuális csomópontok használata
kubernetes.azure.com/agentpool <ügynökkészlet neve> nodepool1 Ugyanaz
kubernetes.io/arch amd64 Runtime. GOARCH N/A
kubernetes.io/os <Operációs rendszer típusa> Linux/Windows Ugyanaz
node.kubernetes.io/instance-type <Virtuális gép mérete> Standard_NC6s_v3 Virtuális
topology.kubernetes.io/region <Azure-régió> westus2 Ugyanaz
topology.kubernetes.io/zone <Azure-zóna> 0 Ugyanaz
kubernetes.azure.com/cluster <MC_RgName> MC_aks_myAKSCluster_westus2 Ugyanaz
kubernetes.azure.com/mode <mód> Felhasználó vagy rendszer User
kubernetes.azure.com/role agent Agent Ugyanaz
kubernetes.azure.com/scalesetpriority <VMSS-prioritás> Direkt vagy normál N/A
kubernetes.io/hostname <Hostname> aks-nodepool-00000000-vmss000000 Ugyanaz
kubernetes.azure.com/storageprofile <Operációsrendszer-lemez tárolási profilja> Felügyelt N/A
kubernetes.azure.com/storagetier <Operációsrendszer-lemez tárolási szintje> Premium_LRS N/A
kubernetes.azure.com/instance-sku <Termékváltozat-család> Standard_N Virtuális
kubernetes.azure.com/node-image-version <VHD-verzió> AKSUbuntu-1804-2020.03.05 Virtuális csomópont verziója
kubernetes.azure.com/subnet <nodepool alhálózat neve> alhálózatnév Virtuális csomópont alhálózatának neve
kubernetes.azure.com/vnet <nodepool virtuális hálózat neve> vnetName Virtuális csomópont virtuális hálózata
kubernetes.azure.com/ppg <nodepool ppg neve> ppgName N/A
kubernetes.azure.com/encrypted-set <nodepool encrypted-set name> titkosított-set-name N/A
kubernetes.azure.com/accelerator <Gyorsító> nvidia N/A
kubernetes.azure.com/fips_enabled <engedélyezve van a fips?> true N/A
kubernetes.azure.com/os-sku <operációs rendszer/termékváltozat> Operációsrendszer-termékváltozat létrehozása vagy frissítése Linux
  • Ugyanez vonatkozik azokra a helyekre is, ahol a címkék várt értékei nem különböznek a standard csomópontkészlet és a virtuális csomópontkészlet között. Mivel a virtuális csomópont podjai nem teszik elérhetővé az alapul szolgáló virtuális gépet (VM), a virtuálisgép-termékváltozat értékeit a rendszer lecseréli az SKU-virtuálisra.
  • A virtuális csomópont verziója a virtuális Kubelet-ACI-összekötő kiadásának aktuális verziójára utal.
  • A virtuális csomópont alhálózatának neve annak az alhálózatnak a neve, amelyben a virtuális csomópontok podjai üzembe vannak helyezve az Azure Container Instance (ACI) szolgáltatásban.
  • A virtuális csomópont virtuális hálózata a virtuális hálózat neve, amely tartalmazza azt az alhálózatot, amelyen a virtuális csomópont podjai üzembe vannak helyezve az ACI-n.

Fenntartott előtagok

A következő előtagok a fenntartott AKS-előtagok, és nem használhatók csomópontokhoz:

  • kubernetes.azure.com/
  • kubernetes.io/

A fenntartott előtagokkal kapcsolatos további információkért lásd a Kubernetes jól ismert címkéit, széljegyzeteit és jelöléseit.

Deprecated labels

A kubernetes 1.24-es verziójának kiadásával az alábbi címkék elavulnak. A címkehivatkozásokat a javasolt helyettesítőre kell módosítania.

Felirat Javasolt helyettesítő Karbantartó
failure-domain.beta.kubernetes.io/region topology.kubernetes.io/region Kubernetes
failure-domain.beta.kubernetes.io/zone topology.kubernetes.io/zone Kubernetes
beta.kubernetes.io/arch kubernetes.io/arch Kubernetes
beta.kubernetes.io/instance-type node.kubernetes.io/instance-type Kubernetes
beta.kubernetes.io/os kubernetes.io/os Kubernetes
node-role.kubernetes.io/agent* kubernetes.azure.com/role=agent Azure Kubernetes Service
kubernetes.io/role* kubernetes.azure.com/role=agent Azure Kubernetes Service
Agentpool* kubernetes.azure.com/agentpool Azure Kubernetes Service
Storageprofile* kubernetes.azure.com/storageprofile Azure Kubernetes Service
Storagetier* kubernetes.azure.com/storagetier Azure Kubernetes Service
Gyorsító* kubernetes.azure.com/accelerator Azure Kubernetes Service

*Újonnan elavult. További információkért tekintse meg a kibocsátási megjegyzéseket.

Következő lépések

További információ a Kubernetes-címkékről a Kubernetes-címkék dokumentációjában.