As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Recursos do AWS Proton e marcação

Recursos do AWS Proton que recebem um nome do recurso da Amazon (ARN) incluem modelos de ambiente e suas versões principais e secundárias, modelos de serviço e suas versões principais e secundárias, ambientes, serviços, instâncias de serviço, componentes e repositórios. Você pode colocar tags nesses recursos para ajudar a organizá-los e identificá-los. Você pode usar tags para categorizar recursos por finalidade, proprietário, ambiente ou outros critérios. Para obter mais informações, consulte Estratégias de marcação da . Para rastrear e gerenciar seus atributos do AWS Proton, você pode usar os atributos de marcação descritos nas seções a seguir.

Marcação de AWS

Você pode atribuir metadados aos seus recursos da AWS na forma de tags. Cada tag consiste em uma chave definida pelo cliente e um valor opcional. As tags podem ajudar você a gerenciar, identificar, organizar, pesquisar e filtrar recursos.

Marcação de AWS Proton

Com o AWS Proton, você pode usar tanto as tags que você cria quanto as tags que o AWS Proton gera automaticamente para você.

Tags gerenciadas pelo AWS ProtonAWS

Quando você cria um recurso do AWS Proton, o AWS Proton gera automaticamente tags gerenciadas pelo AWS para seu novo recurso, conforme mostrado no diagrama a seguir. Posteriormente, as tags gerenciadas pelo AWS se propagam para outros recursos do AWS Proton baseados em seu novo recurso. Por exemplo, as tags gerenciadas de um modelo de ambiente se propagam para suas versões e as tags gerenciadas de um serviço se propagam para suas instâncias de serviço.

Propagação de tags para recursos provisionados

Se os recursos provisionados, como aqueles definidos nos modelos de serviço e ambiente, oferecerem suporte à marcação do AWS, as tags gerenciadas pelo AWS se propagarão como tags gerenciadas pelo cliente para os recursos provisionados. Essas tags não se propagarão para um recurso provisionado que não ofereça suporte à marcação do AWS.

O AWS Proton aplica tags aos seus recursos por contas do AWS Proton, modelos registrados e ambientes implantados, bem como serviços e instâncias de serviço, conforme descrito na tabela a seguir. Você pode usar tags gerenciadas pelo AWS para visualizar e gerenciar seus recursos do AWS Proton, mas não pode modificá-las.

Veja a seguir um exemplo de uma tag gerenciado pelo AWS para um recurso do AWS Proton.

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

Veja a seguir um exemplo de uma tag gerenciada pelo cliente aplicada a um recurso provisionado que foi propagada a partir de uma tag gerenciada pelo AWS.

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

Com o provisionamento gerenciado pelo AWS, o AWS Proton aplica tags propagadas diretamente aos recursos provisionados.

Com o provisionamento autogerenciado, o AWS Proton disponibiliza tags propagadas junto com os arquivos IaC renderizados que ele envia no pull request (PR) de provisionamento. As tags são fornecidas na variável proton_tags do mapa de cadeias de caracteres. Recomendamos que você faça uma referência a essa variável em sua configuração do Terraform para incluir tags do AWS Proton em default_tags. Isso propaga tags do AWS Proton para todos os recursos provisionados.

O exemplo a seguir mostra esse método de propagação de tags em um modelo de ambiente do Terraform.

Aqui está a definição da variável proton_tags:

proton.environment.variables.tf:

variable "environment" {
  type = object({
    inputs = map(string)
    name = string
  })
}

variable "proton_tags" {
  type = map(string)
  default = null
}

Veja como os valores das tags são atribuídos a essa variável:

proton.auto.tfvars.json:

{
  "environment": {
    "name": "dev",
    "inputs": {
      "ssm_parameter_value": "MyNewParamValue"
    }
  }

  "proton_tags" : {
    "proton:account" : "123456789012",
    "proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
    "proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
  }
}

E veja como você pode adicionar tags do AWS Proton à sua configuração do Terraform para que elas sejam adicionadas aos recursos provisionados:

# Configure the AWS Provider
provider "aws" {
  region = var.aws_region
  default_tags {
    tags = var.proton_tags
  }
}

Tags gerenciadas pelo cliente

Cada recurso do AWS Proton tem uma cota máxima de 50 tags gerenciadas pelo cliente. As tags gerenciadas pelo cliente se propagam para os recursos secundários dp AWS Proton da mesma forma que as tags gerenciadas pelo AWS, exceto por não se propagarem para os recursos existentes do AWS Proton ou provisionados. Se você aplicar uma nova tag a um recurso do AWS Proton com recursos secundários existentes e quiser que os recursos secundários existentes sejam marcados com a nova tag, você precisará marcar cada recurso secundário existente manualmente, usando o console ou o AWS CLI.

Crie tags usando o console e a CLI

Ao criar um recurso do AWS Proton usando o console, você tem a oportunidade de criar tags gerenciadas pelo cliente na primeira ou na segunda página do procedimento de criação, conforme mostrado no instantâneo do console a seguir. Escolha Adicionar nova tag, insira a chave e o valor e prossiga.

Depois de criar um novo recurso usando o console do AWS Proton, você pode ver sua lista de tags gerenciadas pelo AWS e gerenciadas pelo cliente na página de detalhes.

Crie tags usando o AWS ProtonAWS CLI

Você pode visualizar, criar, remover e editar tags usando o AWS Proton AWS CLI.

É possível criar ou editar uma tag para um recurso, conforme mostrado no exemplo a seguir.

$ aws proton tag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'

Você pode remover uma tag de um recurso, conforme mostrado no próximo exemplo.

$ aws proton untag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tag-keys '["mykey1","mykey2"]'

Você pode listar as tags de um recurso, conforme mostrado no exemplo final.

$ aws proton list-tags-for-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"