Tous les produits
Search
Centre de documentation

Elastic Container Instance:Associer des tags personnalisés à un pod

Dernière mise à jour :Aug 25, 2026

Les tags sont des paires clé-valeur qui identifient les instances de conteneur élastique. Utilisez-les pour regrouper, rechercher ou exécuter des opérations par lot sur vos instances. Associez des tags personnalisés à un pod afin de le gérer via ces tags, par exemple pour analyser les coûts.

Informations générales

Un tag est une paire clé-valeur dont le fonctionnement est similaire à celui d'un libellé Kubernetes. Les tags Alibaba Cloud identifient les ressources cloud et vous permettent de les gérer par catégorie. Par défaut, les instances de conteneur élastique créées par Container Service for Kubernetes (ACK) comportent les tags suivants :

  • ManagedBy : le type de cluster.

  • ClusterId : l'ID du cluster.

  • NameSpace : le namespace du cluster.

  • OwnerReferenceKind : le type de charge de travail créé dans le cluster, tel que Deployment ou Job.

  • OwnerReferenceName : le nom de la charge de travail créée dans le cluster, par exemple un nom de Deployment ou un nom de Job.

  • PodName : le nom du pod.

Configurations

Ajoutez l'annotation k8s.aliyun.com/eci-custom-tags à un pod pour lui associer des tags personnalisés. Un pod peut comporter jusqu'à trois tags. Séparez la clé et la valeur d'un tag par deux-points (:). Séparez plusieurs tags par des virgules (,).

Important
  • Ajoutez les annotations aux métadonnées dans le fichier de configuration du pod. Par exemple, lorsque vous créez un Deployment, ajoutez les annotations dans la section spec.template.metadata.

  • Les annotations liées à Elastic Container Instance ne s'appliquent qu'à la création du pod. L'ajout ou la modification de ces annotations sur un pod existant n'aura aucun effet.

Exemples de configurations :

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test
  labels:
    app: test
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      name: nginx-test
      labels:
        app: nginx
        alibabacloud.com/eci: "true" 
      annotations:
        k8s.aliyun.com/eci-custom-tags: "env:test,name:alice"   # Apply custom tags
    spec:
      containers:
      - name: nginx
        image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
        ports:
        - containerPort: 80

Après avoir associé les tags, exécutez la commande kubectl describe pour consulter les détails du pod. Les tags personnalisés apparaissent comme valeur de k8s.aliyun.com/eci-custom-tags dans la section Annotations.

~$ kubectl get pod
NAME                    READY   STATUS    RESTARTS   AGE
test-555f6995c6-jrmtl   1/1     Running   0          31m
test-555f6995c6-tqjjk   1/1     Running   0          31m
~$ kubectl describe pod test-555f6995c6-jrmtl
Name:         test-555f6995c6-jrmtl
Namespace:    default
Priority:     0
Node:         virtual-kubelet-cn-beijing-k/172.16.xxx.xxx
Start Time:   Tue, 22 Nov 2022 02:49:42 +0000
Labels:       alibabacloud.com/eci=true
              app=nginx
              pod-template-hash=555f6995c6
Annotations:  ProviderCreate: done
              k8s.aliyun.com/cluster-dns:
              k8s.aliyun.com/cluster-domain: cluster.local
              k8s.aliyun.com/eci-client-token: bbb1a0f7-ad20-440c-a95c-00d9c064f4bc
              k8s.aliyun.com/eci-created-by-template: true
              k8s.aliyun.com/eci-custom-tags: env:test,name:alice
              k8s.aliyun.com/eci-drop-apiserver-interactive-caps:
              k8s.aliyun.com/eci-instance-cpu: 2.0

Pour consulter les tags associés à un pod, accédez à la page Container Group de la console Elastic Container Instance.