Adição de etiquetas a uma instância de contêiner do Amazon ECS - Amazon Elastic Container Service
Instâncias de contêiner externas

Adição de etiquetas a uma instância de contêiner do Amazon ECS

É possível associar tags a suas instâncias de contêiner usando um dos métodos a seguir:

  • Método 1: ao criar a instância de contêiner usando a API, a CLI ou o console do Amazon EC2, especifique as etiquetas transmitindo os dados do usuário para a instância usando o parâmetro de configuração do agente de contêiner ECS_CONTAINER_INSTANCE_TAGS. Isso cria etiquetas que são associadas à instância de contêiner somente no Amazon ECS. Elas não podem ser listadas usando a API do Amazon EC2. Para ter mais informações, consulte Inicialização de instâncias de contêiner do Linux no Amazon ECS para transmitir dados.

    Importante

    Se você iniciar as instâncias de contêiner usando um grupo do Amazon EC2 Auto Scaling, deverá usar o parâmetro de configuração do agente ECS_CONTAINER_INSTANCE_TAGS para adicionar etiquetas. Isso é decorrente da maneira como as etiquetas são adicionadas às instâncias do Amazon EC2 que são iniciadas por meio de grupos do Auto Scaling.

    Veja a seguir um exemplo de um script de dados do usuário que associa tags à sua instância de contêiner:

    #!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
EOF

  • Método 2: ao criar sua instância de contêiner usando a API, a CLI ou o console do Amazon EC2, especifique primeiramente as tags usando o parâmetro TagSpecification.N. Em seguida, transmita os dados do usuário para a instância usando o parâmetro ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM de configuração do agente de contêiner. Essa ação propaga os dados do Amazon EC2 para o Amazon ECS.

    Veja a seguir um exemplo de um script de dados do usuário que propaga as tags associadas a uma instância do Amazon EC2 e registra a instância em um cluster denominado MyCluster.

    #!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
EOF

    Para fornecer acesso para permitir que as etiquetas de instância de contêiner se propaguem do Amazon EC2 para o Amazon ECS, adicione manualmente as seguintes permissões, como uma política alinhada, à função do IAM da instância de contêiner do Amazon ECS. Para obter mais informações, consulte Adicionar e remover políticas do IAM.

    • ec2:DescribeTags

    Veja a seguir um exemplo de política usada para adicionar essas permissões.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
            	"ec2:DescribeTags"
            ],
            "Resource": "*"
        }
    ]
}

Instâncias de contêiner externas

É possível associar tags às instâncias de contêiner externas usando um dos métodos a seguir.

  • Método 1: antes de executar o script de instalação para registrar a instância externa no cluster, crie ou edite o arquivo de configuração do agente de contêiner do Amazon ECS em /etc/ecs/ecs.config e adicione o parâmetro ECS_CONTAINER_INSTANCE_TAGS de configuração do agente de contêiner. Isso cria etiquetas associadas à instância externa.

    Veja a seguir um exemplo de sintaxe.

    ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}

  • Método 2: depois que a instância externa for registrada no cluster, será possível usar o AWS Management Console para adicionar tags. Para ter mais informações, consulte Adicionar etiquetas a recursos existentes (console do Amazon ECS).