Merge pull request #172829 from zr-msft/zr-aks-rp-tags

[AKS] added Azure tags for AKS

Author: ShannonLeavitt

articles/aks/TOC.yml

@@ -217,6 +217,8 @@
           maintainContext: true
         - name: Azure portal Kubernetes resource view
           href: kubernetes-portal.md
+        - name: Use tags
+          href: use-tags.md
     - name: Security and authentication
       items:
         - name: Overview of Defender for Containers

articles/aks/azure-disk-csi.md

@@ -393,6 +393,10 @@ $ kubectl exec -it busybox-azuredisk-0 -- cat c:\mnt\azuredisk\data.txt # on Win
 (...)
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 - To learn how to use CSI drivers for Azure Files, see [Use Azure Files with CSI drivers](azure-files-csi.md).
@@ -425,3 +429,4 @@ $ kubectl exec -it busybox-azuredisk-0 -- cat c:\mnt\azuredisk\data.txt # on Win
 [az-feature-register]: /cli/azure/feature#az_feature_register
 [az-feature-list]: /cli/azure/feature#az_feature_list
 [az-provider-register]: /cli/azure/provider#az_provider_register
+[use-tags]: use-tags.md

articles/aks/azure-disk-customer-managed-keys.md

@@ -137,6 +137,10 @@ az aks get-credentials --name myAksCluster --resource-group myResourceGroup --ou
 kubectl apply -f byok-azure-disk.yaml
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 Review [best practices for AKS cluster security][best-practices-security]
@@ -152,3 +156,4 @@ Review [best practices for AKS cluster security][best-practices-security]
 [customer-managed-keys-linux]: ../virtual-machines/disk-encryption.md#customer-managed-keys
 [key-vault-generate]: ../key-vault/general/manage-with-cli2.md
 [supported-regions]: ../virtual-machines/disk-encryption.md#supported-regions
+[use-tags]: use-tags.md

articles/aks/azure-disk-volume.md

@@ -119,6 +119,10 @@ Events:
 [...]
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 For associated best practices, see [Best practices for storage and backups in AKS][operator-best-practices-storage].
@@ -142,3 +146,4 @@ For more information about AKS clusters interact with Azure disks, see the [Kube
 [azure-files-volume]: azure-files-volume.md
 [operator-best-practices-storage]: operator-best-practices-storage.md
 [concepts-storage]: concepts-storage.md
+[use-tags]: use-tags.md

articles/aks/azure-disks-dynamic-pv.md

@@ -254,6 +254,10 @@ Volumes:
 [...]
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 For associated best practices, see [Best practices for storage and backups in AKS][operator-best-practices-storage].
@@ -293,3 +297,4 @@ Learn more about Kubernetes persistent volumes using Azure disks.
 [az-feature-register]: /cli/azure/feature#az_feature_register
 [az-feature-list]: /cli/azure/feature#az_feature_list
 [az-provider-register]: /cli/azure/provider#az_provider_register
+[use-tags]: use-tags.md

articles/aks/azure-files-csi.md

@@ -337,6 +337,10 @@ $ kubectl exec -it busybox-azurefile-0 -- cat c:\mnt\azurefile\data.txt # on Win
 (...)
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 - To learn how to use CSI drivers for Azure disks, see [Use Azure disks with CSI drivers](azure-disk-csi.md).
@@ -372,3 +376,4 @@ $ kubectl exec -it busybox-azurefile-0 -- cat c:\mnt\azurefile\data.txt # on Win
 [az-provider-register]: /cli/azure/provider#az_provider_register
 [node-resource-group]: faq.md#why-are-two-resource-groups-created-with-aks
 [storage-skus]: ../storage/common/storage-redundancy.md
+[use-tags]: use-tags.md

articles/aks/azure-files-dynamic-pv.md

@@ -184,6 +184,10 @@ parameters:
   skuName: Standard_LRS
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 For associated best practices, see [Best practices for storage and backups in AKS][operator-best-practices-storage].
@@ -226,3 +230,4 @@ Learn more about Kubernetes persistent volumes using Azure Files.
 [operator-best-practices-storage]: operator-best-practices-storage.md
 [concepts-storage]: concepts-storage.md
 [node-resource-group]: faq.md#why-are-two-resource-groups-created-with-aks
+[use-tags]: use-tags.md

articles/aks/azure-files-volume.md

@@ -194,6 +194,10 @@ kubectl delete pod mypod
 kubectl apply -f azure-files-pod.yaml
 ```
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 For Azure File CSI driver parameters, see [CSI driver parameters][CSI driver parameters].
@@ -218,3 +222,4 @@ For associated best practices, see [Best practices for storage and backups in AK
 [operator-best-practices-storage]: operator-best-practices-storage.md
 [concepts-storage]: concepts-storage.md
 [persistent-volume-example]: #mount-file-share-as-a-persistent-volume
+[use-tags]: use-tags.md

articles/aks/azure-netapp-files.md

@@ -512,6 +512,10 @@ Astra Trident supports many features with Azure NetApp Files, such as:
 * [On-demand volume snapshots](https://docs.netapp.com/us-en/trident/trident-use/vol-snapshots.html)
 * [Importing volumes](https://docs.netapp.com/us-en/trident/trident-use/vol-import.html)
 
+## Using Azure tags
+
+For more details on using Azure tags, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
+
 ## Next steps
 
 * For more information on Azure NetApp Files, see [What is Azure NetApp Files][anf].
@@ -535,3 +539,4 @@ Astra Trident supports many features with Azure NetApp Files, such as:
 [kubectl-apply]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply
 [kubectl-describe]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#describe
 [kubectl-exec]: https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#exec
+[use-tags]: use-tags.md

articles/aks/use-multiple-node-pools.md

@@ -557,53 +557,7 @@ $ az aks nodepool list -g myResourceGroup --cluster-name myAKSCluster
 
 ### Setting nodepool Azure tags
 
-You can apply an Azure tag to node pools in your AKS cluster. Tags applied to a node pool are applied to each node within the node pool and are persisted through upgrades. Tags are also applied to new nodes added to a node pool during scale-out operations. Adding a tag can help with tasks such as policy tracking or cost estimation.
-
-Azure tags have keys which are case-insensitive for operations, such as when retrieving a tag by searching the key. In this case a tag with the given key will be updated or retrieved regardless of casing. Tag values are case-sensitive.
-
-In AKS, if multiple tags are set with identical keys but different casing, the tag used is the first in alphabetical order. For example, `{"Key1": "val1", "kEy1": "val2", "key1": "val3"}` results in `Key1` and `val1` being set.
-
-Create a node pool using the [az aks nodepool add][az-aks-nodepool-add]. Specify the name *tagnodepool* and use the `--tag` parameter to specify *dept=IT* and *costcenter=9999* for tags.
-
-```azurecli-interactive
-az aks nodepool add \
-    --resource-group myResourceGroup \
-    --cluster-name myAKSCluster \
-    --name tagnodepool \
-    --node-count 1 \
-    --tags dept=IT costcenter=9999 \
-    --no-wait
-```
-
-> [!NOTE]
-> You can also use the `--tags` parameter when using [az aks nodepool update][az-aks-nodepool-update] command as well as during cluster creation. During cluster creation, the `--tags` parameter applies the tag to the initial node pool created with the cluster. All tag names must adhere to the limitations in [Use tags to organize your Azure resources][tag-limitation]. Updating a node pool with the `--tags` parameter updates any existing tag values and appends any new tags. For example, if your node pool had *dept=IT* and *costcenter=9999* for tags and you updated it with *team=dev* and *costcenter=111* for tags, you nodepool would have *dept=IT*, *costcenter=111*, and *team=dev* for tags.
-
-The following example output from the [az aks nodepool list][az-aks-nodepool-list] command shows that *tagnodepool* is *Creating* nodes with the specified *tag*:
-
-```azurecli
-az aks nodepool list -g myResourceGroup --cluster-name myAKSCluster
-```
-
-```output
-[
-  {
-    ...
-    "count": 1,
-    ...
-    "name": "tagnodepool",
-    "orchestratorVersion": "1.15.7",
-    ...
-    "provisioningState": "Creating",
-    ...
-    "tags": {
-      "dept": "IT",
-      "costcenter": "9999"
-    },
-    ...
-  },
- ...
-]
-```
+For more details on using Azure tags with node pools, see [Use Azure tags in Azure Kubernetes Service (AKS)][use-tags].
 
 ## Add a FIPS-enabled node pool
 
@@ -928,3 +882,4 @@ Use [proximity placement groups][reduce-latency-ppg] to reduce latency for your
 [az-public-ip-prefix-create]: /cli/azure/network/public-ip/prefix#az_network_public_ip_prefix_create
 [node-image-upgrade]: node-image-upgrade.md
 [fips]: /azure/compliance/offerings/offering-fips-140-2
+[use-tags]: use-tags.md