Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS Proton ressources et balisage

AWS Proton les ressources auxquelles est attribué un Amazon Resource Name (ARN) incluent les modèles d'environnement et leurs versions principales et secondaires, les modèles de service et leurs versions principale et mineure, les environnements, les services, les instances de service, les composants et les référentiels. Vous pouvez étiqueter ces ressources pour vous aider à les organiser et à les identifier. Vous pouvez utiliser les balises pour classer vos ressources par objectif, propriétaire, environnement ou selon d'autres critères. Pour de plus amples informations, consultez Politiques de balisage . Pour suivre et gérer vos AWS Proton ressources, vous pouvez utiliser les fonctionnalités de balisage décrites dans les sections suivantes.

AWS balisage

Vous pouvez attribuer des métadonnées à vos AWS ressources sous forme de balises. Chaque balise est composée d'une clé définie par le client et d'une valeur facultative. Les balises peuvent vous aider à gérer, identifier, organiser, rechercher et filtrer des ressources.

AWS Proton balisage

Avec AWS Proton, vous pouvez utiliser à la fois les balises que vous créez et les balises AWS Proton générées automatiquement pour vous.

AWS ProtonAWS balises gérées

Lorsque vous créez une AWS Proton ressource, des balises AWS gérées sont AWS Proton automatiquement générées pour votre nouvelle ressource, comme indiqué dans le schéma suivant. AWS les balises gérées se propagent ensuite à d'autres AWS Proton ressources basées sur votre nouvelle ressource. Par exemple, les balises gérées d'un modèle d'environnement se propagent vers ses versions, et les balises gérées d'un service se propagent vers ses instances de service.

Propagation des balises vers les ressources provisionnées

Si les ressources provisionnées, telles que celles définies dans les modèles de service et d'environnement, prennent en charge le AWS balisage, les balises gérées se propagent sous forme de balises AWS gérées par le client vers les ressources provisionnées. Ces balises ne se propageront pas à une ressource provisionnée qui ne prend pas en charge AWS le balisage.

AWS Proton applique des balises à vos ressources en fonction AWS Proton des comptes, des modèles enregistrés et des environnements déployés, ainsi que des services et des instances de services, comme décrit dans le tableau suivant. Vous pouvez utiliser des balises AWS gérées pour afficher et gérer vos AWS Proton ressources, mais vous ne pouvez pas les modifier.

Voici un exemple de balise AWS gérée pour une AWS Proton ressource.

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

Voici un exemple de balise gérée par le client appliquée à une ressource provisionnée qui a été propagée à partir d'une balise AWS gérée.

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

Avec AWS-managed provisioning, AWS Proton applique des balises propagées directement aux ressources provisionnées.

Avec le provisionnement autogéré, AWS Proton met à disposition les balises propagées ainsi que les fichiers iAc rendus qu'il soumet dans la pull request (PR) de provisionnement. Les balises sont fournies dans la variable string mapproton_tags. Nous vous recommandons de faire référence à cette variable dans votre configuration Terraform pour y inclure des AWS Proton balises. default_tags Cela propage les AWS Proton balises à toutes les ressources provisionnées.

L'exemple suivant montre cette méthode de propagation de balises dans un modèle Terraform d'environnement.

Voici la définition de la proton_tags variable :

proton.environment.variables.tf :

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

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

Voici comment les valeurs de balise sont attribuées à cette 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"
  }
}

Et voici comment vous pouvez ajouter des AWS Proton balises à votre configuration Terraform afin qu'elles soient ajoutées aux ressources provisionnées :

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

Tags gérés par le client

Chaque AWS Proton ressource dispose d'un quota maximum de 50 balises gérées par le client. Les balises gérées par le client se propagent aux AWS Proton ressources enfants de la même manière que les balises AWS gérées, sauf qu'elles ne se propagent pas aux AWS Proton ressources existantes ou aux ressources provisionnées. Si vous appliquez une nouvelle balise à une AWS Proton ressource contenant des ressources enfants existantes et que vous souhaitez que les ressources enfants existantes soient étiquetées avec la nouvelle balise, vous devez étiqueter chaque ressource enfant existante manuellement, à l'aide de la console ou AWS CLI.

Création de balises à l'aide de la console et de la CLI

Lorsque vous créez une AWS Proton ressource à l'aide de la console, vous avez la possibilité de créer des balises gérées par le client sur la première ou la deuxième page de la procédure de création, comme indiqué dans l'instantané de console suivant. Choisissez Ajouter une nouvelle étiquette, entrez la clé et la valeur et continuez.

Après avoir créé une nouvelle ressource à l'aide de la AWS Proton console, vous pouvez consulter sa liste de balises AWS gérées et gérées par le client sur la page détaillée.

Créez des balises à l'aide du AWS ProtonAWS CLI

Vous pouvez afficher, créer, supprimer et modifier des balises à l'aide du AWS Proton AWS CLI.

Vous pouvez créer ou modifier une balise pour une ressource, comme indiqué dans l'exemple suivant.

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

Vous pouvez supprimer une balise pour une ressource, comme indiqué dans l'exemple suivant.

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

Vous pouvez répertorier les balises d'une ressource comme indiqué dans le dernier exemple.

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