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.

Recursos y etiquetado de AWS Proton

Los recursos de AWS Proton a los que se les asigna un nombre de recurso de Amazon (ARN) incluyen plantillas de entorno y sus versiones principales y secundarias, así como plantillas de servicio y sus versiones principales y secundarias, entornos, servicios, instancias de servicio, componentes y 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.

Etiquetado de AWS

Puede asignar metadatos a los recursos de AWS 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.

Etiquetado de AWS Proton

Con AWS Proton, puede utilizar tanto las etiquetas que cree como las que AWS Proton genere automáticamente.

Etiquetas administradas por AWS ProtonAWS

Al crear un recurso de AWS Proton, AWS Proton genera automáticamente etiquetas administradas por AWS para el nuevo recurso, como se muestra en el siguiente diagrama. Las etiquetas administradas por AWS se propagan posteriormente a otros recursos de AWS Proton 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 etiquetado de AWS, las etiquetas administradas por AWS se propagan como etiquetas administradas por el cliente a los recursos aprovisionados. Estas etiquetas no se propagarán a un recurso aprovisionado que no admita el etiquetado de AWS.

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

A continuación, se muestra un ejemplo de una etiqueta administrada por AWS para un recurso de AWS Proton.

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

A continuación, se muestra un ejemplo de una etiqueta administrada por el cliente aplicada a un recurso aprovisionado que se propagó desde una etiqueta administrada por AWS.

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

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

Con el aprovisionamiento autoadministrado, AWS Proton permite que las etiquetas propagadas estén disponibles junto con los archivos de IaC representados 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. Le recomendamos que haga referencia a esta variable en su configuración de Terraform para incluirla en etiquetas de AWS Proton en 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 así es como puede agregar etiquetas de AWS Proton a su 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 recurso de AWS Proton tiene una cuota máxima de 50 etiquetas administradas por el cliente. Las etiquetas administradas por el cliente se propagan a los recursos de AWS Proton secundarios de la misma manera que las etiquetas administradas por AWS, excepto que no se propagan a los recursos de AWS Proton existentes ni a los recursos aprovisionados. Si aplica una etiqueta nueva a un recurso de AWS Proton con recursos secundarios existentes y desea etiquetar los recursos secundarios existentes con la nueva etiqueta, deberá etiquetar cada recurso secundario existente manualmente, mediante la consola o la AWS CLI.

Creación de etiquetas mediante la consola y la CLI

Cuando el usuario crea un recurso de AWS Proton mediante la consola, tiene la oportunidad de crear etiquetas administradas por el cliente tanto en la primera como en la 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 nuevo recurso mediante la consola de AWS Proton, podrá ver su lista de etiquetas administradas por AWS y administradas por el cliente en la página de detalles.

Creación de etiquetas mediante la AWS ProtonAWS CLI

Puede ver, crear, eliminar y editar etiquetas mediante la 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"