Todos os produtos
Search
Central de documentação

Elastic Container Instance:Associar tags personalizadas a um pod

Última atualização: Aug 25, 2026

Tags são pares chave-valor que identificam instâncias de contêiner elásticas. Use tags para agrupar, pesquisar ou executar operações em lote nas instâncias. Associe tags personalizadas a um pod para gerenciá-lo por tag — por exemplo, para analisar custos.

Informações básicas

Uma tag é um par chave-valor com funcionamento semelhante ao de um rótulo do Kubernetes. As tags da Alibaba Cloud identificam recursos na cloud e permitem o gerenciamento por categoria. Por padrão, as instâncias de contêiner elásticas criadas pelo Container Service for Kubernetes (ACK) têm as seguintes tags:

  • ManagedBy: o tipo de cluster.

  • ClusterId: o ID do cluster.

  • NameSpace: o namespace do cluster.

  • OwnerReferenceKind: o tipo de carga de trabalho criada no cluster, como Deployment ou Job.

  • OwnerReferenceName: o nome da carga de trabalho criada no cluster, como o nome de um Deployment ou de um Job.

  • PodName: o nome do pod.

Configurações

Adicione a anotação k8s.aliyun.com/eci-custom-tags a um pod para associar tags personalizadas. Um pod pode ter até três tags. Separe a chave e o valor da tag com dois pontos (:). Para múltiplas tags, use vírgulas (,) como separador.

Importante
  • Adicione as anotações aos metadados no arquivo de configuração do pod. Ao criar um Deployment, por exemplo, adicione as anotações na seção spec.template.metadata.

  • As anotações relacionadas ao Elastic Container Instance são aplicadas apenas durante a criação do pod. Adicionar ou modificar essas anotações em um pod existente não surte efeito.

Exemplo de configuração:

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

Após associar as tags, execute o comando kubectl describe para visualizar os detalhes do pod. As tags personalizadas aparecem como valor de k8s.aliyun.com/eci-custom-tags na seção 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

Para visualizar as tags associadas a um pod, acesse a página Container Group no console do Elastic Container Instance.