Azure-címkék használata Azure Kubernetes Service (AKS)

  • Cikk

A Azure Kubernetes Service (AKS) használatával Azure-címkéket állíthat be egy AKS-fürtön és annak kapcsolódó erőforrásain az Azure Resource Manager és az Azure CLI használatával. A Kubernetes jegyzékfájljaival azure-címkéket is beállíthat bizonyos erőforrásokhoz. Az Azure-címkék hasznos nyomon követési erőforrásként szolgálnak bizonyos üzleti folyamatokhoz, például a díjvisszafizetéshez.

Ez a cikk bemutatja, hogyan állíthat be Azure-címkéket az AKS-fürtökhöz és a kapcsolódó erőforrásokhoz.

Előkészületek

A kezdés előtt tekintse át a következő információkat:

  • Az AKS-fürtön beállított címkék a fürthöz kapcsolódó összes erőforrásra vonatkoznak, a csomópontkészletekre azonban nem. Ez a művelet felülírja a meglévő kulcsok értékeit.
  • A csomópontkészleten beállított címkék csak az adott csomópontkészlethez kapcsolódó erőforrásokra vonatkoznak. Ez a művelet felülírja a meglévő kulcsok értékeit. A csomópontkészleten kívüli erőforrások, beleértve a fürt többi részéhez és más csomópontkészletekhez tartozó erőforrásokat, nincsenek hatással.
  • A nyilvános IP-címek, fájlok és lemezek címkéit a Kubernetes egy Kubernetes-jegyzéken keresztül állíthatja be. Az így beállított címkék akkor is megőrzik a Kubernetes-értékeket, ha később egy másik módszerrel frissíti őket. Amikor nyilvános IP-címeket, fájlokat vagy lemezeket távolít el a Kubernetesen keresztül, a Kubernetes által beállított címkék el lesznek távolítva. A Kubernetes által nem követett erőforrások címkéi változatlanok maradnak.

Előfeltételek

  • Az Azure CLI 2.0.59-es vagy újabb verziója. A verzió megkereséséhez futtassa a parancsot az --version. Ha telepítenie vagy frissítenie kell a verziót, olvassa el az Azure CLI telepítése című témakört.
  • A Kubernetes 1.20-es vagy újabb verziója.

Korlátozások

  • Az Azure-címkék kulcsai nem különböztetik meg a kis- és nagybetűket a műveletek során, például amikor címkét kér le a kulcsra való kereséssel. Ebben az esetben a rendszer frissíti vagy lekéri a megadott kulccsal rendelkező címkét, függetlenül a burkolattól. A címkeértékek megkülönböztetik a kis- és nagybetűket.
  • Ha több címkét azonos kulcsokkal, ám eltérő kis- és nagybetűkkel állít be, a címkék betűrendben lesznek felhasználva. Például az {"Key1": "val1", "kEy1": "val2", "key1": "val3"} eredmény és val1 a Key1 beállítás.
  • Megosztott erőforrások esetén a címkék önmagukban nem tudják meghatározni az erőforrás-használat felosztását.

Azure-címkék és AKS-fürtök

Amikor létrehoz vagy frissít egy AKS-fürtöt a --tags paraméterrel, a rendszer a következőket rendeli hozzá a megadott Azure-címkékhez:

  • Maga az AKS-fürt és a hozzá kapcsolódó erőforrások:
    • Útválasztási táblázat
    • Nyilvános IP-cím
    • Terheléselosztóval
    • Hálózati biztonsági csoporttal
    • Virtuális hálózat
    • AKS által felügyelt kubelet msi
    • AKS által felügyelt bővítmény msi
    • saját DNS privát fürthöz társított zóna
    • Privát fürthöz társított privát végpont
  • A csomópont erőforráscsoportja

Megjegyzés

Az Azure saját DNS csak 15 címkét támogat. További információt a címkeerőforrásokban talál.

Címkék létrehozása vagy frissítése AKS-fürtön

Új AKS-fürt létrehozása

Fontos

Ha meglévő erőforrásokat használ egy új fürt létrehozásakor, például EGY IP-cím vagy útvonaltábla létrehozásakor, a az aks create parancs felülírja a címkék készletét. Ha később törli a fürtöt, a fürt által beállított címkék el lesznek távolítva.

  1. Hozzon létre egy fürtöt, és rendeljen Hozzá Azure-címkéket a az aks create--tags paraméterrel rendelkező paranccsal.

    Megjegyzés

    Ha címkéket szeretne beállítani a kezdeti csomópontkészleten, a virtuálisgép-méretezési csoporton és a kezdeti csomópontkészlethez társított összes virtuálisgép-méretezési csoportpéldányon, beállíthatja a paramétert --nodepool-tags is.

    az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --tags dept=IT costcenter=9999 \
    --generate-ssh-keys

  2. A paranccsal ellenőrizze, hogy a címkéket alkalmazták-e a fürtre és a az aks show kapcsolódó erőforrásokra.

    az aks show -g myResourceGroup -n myAKSCluster --query '[tags]'

    Az alábbi példakimenet a fürtre alkalmazott címkéket mutatja be:

    {
  "clusterTags": {
    "dept": "IT",
    "costcenter": "9999"
  }
}

Meglévő AKS-fürt frissítése

Fontos

Ha címkéket állít be egy fürtön a az aks update paranccsal, felülírja a címkék készletét. Ha például a fürt rendelkezik a dept=IT és costcenter=9999 címkékkel, és a team=alpha és costcenter=1234 címkékkel használjaaz aks update, a címkék új listája a team=alpha és costcenter=1234 lesz.

  1. Frissítse a címkéket egy meglévő fürtön a az aks update paraméterrel rendelkező --tags paranccsal.

    az aks update \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --tags team=alpha costcenter=1234

  2. A paranccsal ellenőrizze, hogy a címkéket alkalmazták-e a fürtre és a az aks show kapcsolódó erőforrásokra.

    az aks show -g myResourceGroup -n myAKSCluster --query '[tags]'

    Az alábbi példakimenet a fürtre alkalmazott címkéket mutatja be:

    {
  "clusterTags": {
    "team": "alpha",
    "costcenter": "1234"
  }
}

Címkék hozzáadása csomópontkészletekhez

Az Azure-címkét alkalmazhatja egy új vagy meglévő csomópontkészletre az AKS-fürtben. A csomópontkészletre alkalmazott címkék a csomópontkészlet minden csomópontjára vonatkoznak, és a frissítésekkel megmaradnak. A rendszer címkéket alkalmaz azokra az új csomópontokra is, amelyek a felskálázási műveletek során hozzáadódnak egy csomópontkészlethez. A címke hozzáadása segíthet olyan feladatokban, mint a szabályzatkövetés vagy a költségbecslés.

Amikor létrehoz vagy frissít egy csomópontkészletet a --tags paraméterrel, a megadott címkék a következő erőforrásokhoz lesznek hozzárendelve:

  • A csomópontkészlet.
  • A virtuálisgép-méretezési csoport és a csomópontkészlethez társított összes virtuálisgép-méretezési csoportpéldány.

Új csomópontkészlet létrehozása

  1. Hozzon létre egy csomópontkészletet egy Azure-címkével a az aks nodepool add paraméterrel rendelkező --tags paranccsal.

    az aks nodepool add \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name tagnodepool \
    --node-count 1 \
    --tags abtest=a costcenter=5555 \
    --no-wait

  2. Ellenőrizze, hogy a címkék a parancs használatával lettek-e alkalmazva a csomópontkészletre az aks show .

    az aks show -g myResourceGroup -n myAKSCluster --query 'agentPoolProfiles[].{nodepoolName:name,tags:tags}'

    Az alábbi példakimenet a csomópontkészletre alkalmazott címkéket mutatja be:

    [
  {
    "nodepoolName": "nodepool1",
    "tags": null
  },
  {
    "nodepoolName": "tagnodepool",
    "tags": {
      "abtest": "a",
      "costcenter": "5555"
    }
  }
]

Meglévő csomópontkészlet frissítése

Fontos

Ha címkéket állít be egy csomópontkészleten a az aks nodepool update paranccsal, felülírja a címkék készletét. Ha például a csomópontkészletben az abtest=a és a costcenter=5555 címkék szerepelnek, és az appversion=0.0.2 és costcenter=4444 címkéket használjaaz aks nodepool update, a címkék új listája appversion=0.0.2 és costcenter=4444.

  1. Frissítsen egy csomópontkészletet egy Azure-címkével a az aks nodepool update paranccsal.

    az aks nodepool update \
    --resource-group myResourceGroup \
    --cluster-name myAKSCluster \
    --name tagnodepool \
    --tags appversion=0.0.2 costcenter=4444 \
    --no-wait

  2. Ellenőrizze, hogy a címkéket alkalmazták-e a csomópontkészletre a az aks show paranccsal.

    az aks show -g myResourceGroup -n myAKSCluster --query 'agentPoolProfiles[].{nodepoolName:name,tags:tags}'

    Az alábbi példakimenet a csomópontkészletre alkalmazott címkéket mutatja be:

    [
  {
    "nodepoolName": "nodepool1",
    "tags": null
  },
  {
    "nodepoolName": "tagnodepool",
    "tags": {
      "appversion": "0.0.2",
      "costcenter": "4444"
    }
  }
]

Címkék hozzáadása a Kubernetes használatával

Fontos

Ha címkéket állít be fájlokra, lemezekre és nyilvános IP-címekre a Kubernetes használatával, az frissíti a címkék készletét. Ha például a lemezen a dept=IT és costcenter=5555 címkék szerepelnek, és a Kubernetes használatával állítja be a team=béta és a costcenter=3333 címkéket, a címkék új listája a következő lenne: dept=IT, team=beta és costcenter=3333.

A Címkék kubernetesen keresztüli frissítései megőrzik a Kubernetesen beállított értéket. Ha például a lemezen a Kubernetes által beállított dept=IT és costcenter=5555 címkék szerepelnek, és a portálon beállítja a team=béta és costcenter=3333 címkéket, a címkék új listája a következő lenne: dept=IT, team=béta és costcenter=5555. Ha ezután eltávolítja a lemezt a Kubernetesen keresztül, a lemezen a team=beta címke található.

Egy Kubernetes-jegyzék használatával Azure-címkéket alkalmazhat nyilvános IP-címekre, lemezekre és fájlokra.

  • Nyilvános IP-címek esetén használja service.beta.kubernetes.io/azure-pip-tagsa széljegyzetek alatt. Például:

    apiVersion: v1
kind: Service
metadata:
  annotations:
    service.beta.kubernetes.io/azure-pip-tags: costcenter=3333,team=beta
spec:
  ...

  • Fájlokhoz és lemezekhez használjon címkéket a paraméterek alatt. Például:

    ---
apiVersion: storage.k8s.io/v1
...
parameters:
  ...
  tags: costcenter=3333,team=beta
...

Következő lépések

További információ a címkék AKS-fürtökben való használatáról.