Ajudar a melhorar esta página

Quer contribuir para este guia do usuário? Role até o final desta página e selecione Editar esta página no GitHub. Suas contribuições ajudarão a tornar nosso guia do usuário melhor para todos.

Organizar recursos do Amazon EKS com tags

É possível usar tags para ajudar você a gerenciar seus recursos do Amazon EKS. Este tópico fornece uma visão geral da função de etiquetas e mostra como você pode criá-las.

Conceitos Básicos de Tags

Uma tag um rótulo atribuído a um recurso AWS. Cada tag consiste em uma chave e um valor opcional.

Com tags, é possível categorizar seus recursos da AWS. Por exemplo, você pode categorizar recursos por finalidade, proprietário ou ambiente. Quando você tem muitos recursos do mesmo tipo; é possível identificar rapidamente um recurso específico com base nas tags que você atribuiu a ele. Por exemplo, você pode definir um conjunto de etiquetas para os clusters do Amazon EKS para ajudar a monitorar o proprietário e o nível da pilha de cada cluster. Recomendamos planejar um conjunto consistente de chaves de etiquetas para cada tipo de recurso. Você pode pesquisar e filtrar os recursos de acordo com as tags que adicionar.

Após adicionar uma tag, você pode editar as chaves e os valores das tags ou removê-las de um recurso a qualquer momento. Caso exclua um recurso, todas as respectivas tags também serão excluídas.

As etiquetas não têm significado semântico no Amazon EKS e são interpretadas estritamente como uma sequência de caracteres. É possível definir o valor de uma tag como uma string vazia. No entanto, você não pode definir o valor de uma tag como nulo. Se você adicionar uma etiqueta que tenha a mesma chave de uma etiqueta existente nesse recurso, o novo valor substituirá o antigo.

Se você estiver usando o AWS Identity and Access Management (IAM), poderá controlar quais usuários na sua conta da AWS têm permissão para gerenciar etiquetas.

Marcando seus Recursos

As seguintes etiquetas de suporte para recursos do Amazon EKS:

Você pode etiquetar esses recursos usando o seguinte:

Ao usar algumas ações de criação de recursos, você também pode especificar tags para o recurso ao mesmo tempo em que o cria. Se as tags não puderem ser aplicadas enquanto um recurso estiver sendo criado, o recurso falhará ao ser criado. Esse mecanismo garante que os recursos que você pretende aplicar tags sejam criados com as etiquetas especificadas por você ou não sejam criados. Se você aplicar tags nos recursos no momento da criação, não precisará executar os scripts de aplicação de tags personalizados após a criação do recurso.

As tags não são propagadas para nenhum outro recurso associado ao recurso criado. Por exemplo, as tags de perfil do Fargate não se propagam para outros recursos associados ao perfil do Fargate, como os Pods que são agendados com ele.

Restrições de tags

As restrições a seguir se aplicam às tags:

Marcar recursos para faturamento

Ao aplicar tags aos clusters do Amazon EKS, é possível pode usá-las para alocação de custos em seus Cost & Usage Reports (Relatórios de custos e uso). Os dados de medição do seu Cost & Usage Reports (Relatório de custos e uso) mostram o uso em todos ps clusters do Amazon EKS. Para obter mais informações, consulte Relatório de custos e uso da AWS no Guia do usuário do AWS Billing.

A tag de alocação de custos gerada pela AWS, especificamente aws:eks:cluster-name, permite que você divida os custos de instância do Amazon EC2 pelo cluster individual do Amazon EKS no Explorador de custos. No entanto, essa tag não captura as despesas do ambiente de gerenciamento. A tag é automaticamente adicionada às instâncias do Amazon EC2 que participam de um cluster do Amazon EKS. Esse comportamento acontece independentemente de as instâncias serem provisionadas com o uso de grupos de nós gerenciados do Amazon EKS, com o Karpenter ou diretamente com o Amazon EC2. Essa tag específica não conta para o limite de 50 tags. Para usar a tag, o proprietário da conta deve ativá-la no console do AWS Billing ou usando a API. Quando o proprietário de uma conta de gerenciamento do AWS Organizations ativar a tag, ela também será ativada para todas as contas-membro da organização.

É possível organizar suas informações de faturamento com base nos recursos com os mesmos valores da chave da tag. Por exemplo, é possível aplicar tags a vários recursos com um nome de aplicação específico, e depois organizar suas informações de faturamento. Dessa forma, é possível ver o custo total daquela aplicação em vários serviços. Para obter mais informações sobre como configurar um relatório de alocação de custos com etiquetas, consulte Relatório mensal de alocação de custos no Guia do usuário do AWS Billing.

O Cost Explorer é uma ferramenta de geração de relatórios que está disponível como parte do nível gratuito da AWS. É possível usar o Cost Explorer para visualizar gráficos dos seus recursos do Amazon EKS dos últimos 13 meses. Também é possível prever o provável valor que você gastará nos próximos três meses. É possível exibir os padrões de quanto você gasta nos recursos da AWS ao longo do tempo. Por exemplo, você pode usar o Cost Explorer para identificar áreas que precisam de uma investigação mais profunda e observar tendências que podem ser usadas para o entendimento dos custos. Também é possível especificar os períodos dos dados e visualizar os dados de tempo por dia ou mês.

Trabalhando com tags usando o console

Usando o console do Amazon EKS, é possível gerenciar as etiquetas associadas aos clusters e grupos de nós gerenciados novos ou existentes.

Quando você selecionar uma página específica do recurso no console do Amazon EKS, a página exibirá uma lista desses recursos. Por exemplo, se você selecionar Clusters no painel de navegação esquerdo, o console exibirá uma lista dos clusters do Amazon EKS. Ao selecionar um recurso de uma dessas listas (por exemplo, um cluster específico), que seja compatível com as etiquetas, será possível vê-las e gerenciá-las na guia Tags (Etiquetas).

Também é possível usar o Editor de etiquetas no AWS Management Console que fornece uma maneira unificada de gerenciar etiquetas. Para obter mais informações, consulte Marcar recursos da AWS com o Tag Editor no Guia do usuário do AWS Tag Editor.

Adição de tags a um recurso na sua criação

Você pode adicionar etiquetas aos clusters, grupos de nós gerenciados e perfis do Fargate do Amazon EKS quando os criar. Para ter mais informações, consulte Criar um cluster do Amazon EKS..

Adição e exclusão de tags a um recurso

É possível adicionar ou excluir tags associadas aos seus clusters diretamente a partir da página do recurso.

Trabalhar com etiquetas usando a CLI, a API ou o eksctl

Use os seguintes comandos da AWS CLI ou operações da API do Amazon EKS para adicionar, atualizar, listar e remover as etiquetas dos recursos. Somente é possível usar eksctl para adicionar etiquetas durante a criação dos novos recursos com um único comando.

Os exemplos a seguir mostram como marcar ou desmarcar recursos usando AWS CLI.

Exemplo 1: marcar um cluster existente

O comando a seguir marca um cluster existente.

aws eks tag-resource --resource-arn resource_ARN --tags team=devs

Exemplo 2: desmarcar um cluster existente

O comando a seguir exclui uma etiqueta de um cluster existente.

aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key

Exemplo 3: listar etiquetas para um recurso

O comando a seguir lista as tags que estão associadas a um recurso existente.

aws eks list-tags-for-resource --resource-arn resource_ARN

Ao usar algumas ações de criação de recursos, você também pode especificar tags ao mesmo tempo em que cria o recurso. As ações a seguir são compatíveis com a especificação de tags na criação de um recurso.

* Se você quiser aplicar tags também a instâncias do Amazon EC2 ao criar um grupo de nós gerenciados, crie o grupo de nós gerenciados usando um modelo de execução. Para ter mais informações, consulte Etiquetar instâncias do Amazon EC2. Se as instâncias já existirem, você pode etiquetá-las manualmente. Para obter mais informações, consulte Marcar seus recursos, no Guia do usuário do Amazon EC2.