Megosztás a következőn keresztül:

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

  • Cikk

Az 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ékek használatával 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 költségtéríté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.

Mielőtt elkezdené

Mielőtt hozzákezdene, 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ére és más csomópontkészletekre vonatkozó erőforrásokat, nem érintik.
  • 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 ily módon 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 törlődnek. A Kubernetes által nem nyomon 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 következőt 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 megadott kulccsal rendelkező címke a burkolattól függetlenül frissül vagy lekérhető. 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 be {"Key1": "val1", "kEy1": "val2", "key1": "val3"} Key1 van állítva és val1 be van állítva.
  • 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 kapcsolódó erőforrások:
    • Útvonaltábla
    • Nyilvános IP-cím
    • Terheléselosztóval
    • Hálózati biztonsági csoport
    • 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

Feljegyzés

Az Azure saját DNS csak 15 címkét támogat. További információ: címkeerőforrások.

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 új fürt létrehozásakor, például 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 rendszer eltávolítja a fürt által beállított címkéket.

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

    Feljegyzé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 minden egyes 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 parancs használatával 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 --resource-group myResourceGroup --name 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 parancs használatával, 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éket 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 parancs használatával 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 --resource-group myResourceGroup --name 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

Azure-címkét alkalmazhat egy új vagy meglévő csomópontkészletre az AKS-fürtben. A csomópontkészletre alkalmazott címkéket a rendszer a csomópontkészlet minden csomópontja esetében alkalmazza, és frissítésekkel megőrzi. A rendszer címkéket alkalmaz azokra az új csomópontokra is, amelyek a kiská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 --resource-group myResourceGroup --name 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

A csomópontkészlet címkéinek a az aks nodepool update parancs használatával történő beállítása felülírja a címkék készletét. Ha például a csomópontkészletben az abtest=a és costcenter=5555 címkék szerepelnek, és az appversion=0.0.2 és a costcenter=4444 címkéket használjaaz aks nodepool update, a címkék új listája az appversion=0.0.2 és a costcenter=4444 lesz.

  1. A parancs használatával az aks nodepool update frissítheti a csomópontkészletet egy Azure-címkével.

    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 parancs használatával.

    az aks show --resource-group myResourceGroup --name 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

A fájlokon, lemezeken és nyilvános IP-címeken a Kubernetes használatával történő címkék beállítása 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 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 dept=IT és costcenter=5555 címkék vannak beállítva a Kubernetes által, és a portál használatával állítja be 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=béta címke található.

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

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

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

  • Fájlok és lemezek esetén használjon címkéket a paraméterek alatt. Példa:

    ---
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.