Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS Proton recursos y etiquetado

AWS Proton Los recursos a los que se les asigna un nombre de recurso de Amazon (ARN) incluyen las plantillas de entorno y sus versiones principales y secundarias, las plantillas de servicio y sus versiones principales y secundarias, los entornos, los servicios, las instancias de servicio, los componentes y los repositorios. Puede etiquetar estos recursos como ayuda para identificarlos y organizarlos. Utilice etiquetas para clasificar los recursos según su finalidad, propietario, entorno u otro criterio. Para obtener más información, consulte Estrategias de etiquetado de . Para realizar un seguimiento de sus recursos de AWS Proton y administrarlos, puede utilizar las características de etiquetado que se describen en las siguientes secciones.

AWS etiquetado

Puede asignar metadatos a sus AWS recursos en forma de etiquetas. Cada etiqueta consta de una clave definida por el cliente y un valor opcional. Las etiquetas pueden ayudarle a administrar, identificar, organizar, buscar y filtrar recursos.

AWS Proton etiquetado

Con AWS Protonél, puedes usar tanto las etiquetas que crees como las que AWS Proton se generan automáticamente para ti.

AWS ProtonAWS etiquetas gestionadas

Al crear un AWS Proton recurso, genera AWS Proton automáticamente etiquetas AWS administradas para el nuevo recurso, como se muestra en el siguiente diagrama. AWS Las etiquetas administradas se propagan posteriormente a otros AWS Proton recursos que se basan en el nuevo recurso. Por ejemplo, las etiquetas administradas de una plantilla de entorno se propagan a sus versiones y las etiquetas administradas de un servicio se propagan a sus instancias de servicio.

Propagación de etiquetas a recursos aprovisionados

Si los recursos aprovisionados, como los definidos en las plantillas de servicio y entorno, admiten el AWS etiquetado, las etiquetas gestionadas se propagan como etiquetas AWS gestionadas por el cliente a los recursos aprovisionados. Estas etiquetas no se propagarán a un recurso aprovisionado que no admita el etiquetado. AWS

AWS Proton aplica etiquetas a los recursos por AWS Proton cuentas, plantillas registradas y entornos implementados, así como por servicios e instancias de servicio, tal como se describe en la siguiente tabla. Puede usar etiquetas AWS administradas para ver y administrar sus AWS Proton recursos, pero no puede modificarlas.

El siguiente es un ejemplo de una etiqueta AWS administrada para un AWS Proton recurso.

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

El siguiente es un ejemplo de una etiqueta administrada por el cliente aplicada a un recurso aprovisionado que se propagó desde una etiqueta AWS administrada.

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

Con el aprovisionamiento AWS administrado, AWS Proton aplica las etiquetas propagadas directamente a los recursos aprovisionados.

Con el aprovisionamiento autogestionado, AWS Proton permite que las etiquetas propagadas estén disponibles junto con los archivos IaC renderizados que envía en la solicitud de extracción (PR) de aprovisionamiento. Las etiquetas se proporcionan en la variable de mapa de cadenas proton_tags. Te recomendamos que hagas referencia a esta variable en tu configuración de Terraform para incluirla en ella las etiquetas. AWS Proton default_tags Esto propaga las etiquetas de AWS Proton a todos los recursos aprovisionados.

El siguiente ejemplo muestra este método de propagación de etiquetas en una plantilla de Terraform de entorno.

Esta es la definición de la variable proton_tags:

proton.environment.variables.tf:

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

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

Así es como se asignan los valores de las etiquetas a esta variable:

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"
  }
}

Y aquí te explicamos cómo puedes agregar AWS Proton etiquetas a tu configuración de Terraform para que se agreguen a los recursos aprovisionados:

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

Etiquetas administradas por el cliente

Cada AWS Proton recurso tiene una cuota máxima de 50 etiquetas administradas por el cliente. Las etiquetas administradas por el cliente se propagan a AWS Proton los recursos secundarios de la misma manera que las etiquetas AWS administradas, excepto que no se propagan a AWS Proton los recursos existentes ni a los recursos aprovisionados. Si aplicas una etiqueta nueva a un AWS Proton recurso con recursos secundarios existentes y deseas etiquetar los recursos secundarios existentes con la nueva etiqueta, debes etiquetar cada recurso secundario existente manualmente, mediante la consola o. AWS CLI

Creación de etiquetas mediante la consola y la CLI

Cuando crea un AWS Proton recurso con la consola, tiene la oportunidad de crear etiquetas administradas por el cliente en la primera o segunda página del procedimiento de creación, como se muestra en la siguiente instantánea de la consola. Seleccione Agregar nueva etiqueta e introduzca la clave y el valor.

Tras crear un recurso nuevo mediante la AWS Proton consola, puede ver su lista de etiquetas AWS gestionadas y gestionadas por el cliente en la página de detalles.

Cree etiquetas mediante el AWS ProtonAWS CLI

Puede ver, crear, eliminar y editar etiquetas utilizando el AWS Proton AWS CLI.

También puede crear o editar una etiqueta para un recurso, tal y como se muestra en el siguiente ejemplo.

$ 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"}]'

Puede eliminar una etiqueta de un recurso, como se muestra en el siguiente ejemplo.

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

Puede enumerar las etiquetas de un recurso, como se muestra en el ejemplo final.

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