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.

Récupération des métadonnées de l'AMI Linux optimisées pour Amazon ECS

Vous pouvez récupérer par programmation les métadonnées de l'AMI optimisées pour Amazon ECS. Les métadonnées incluent le nom de l'AMI, la version de l'agent de conteneur Amazon ECS et la version d'exécution Amazon ECS qui inclut la version Docker.

Lorsque vous créez un cluster à l'aide de la console, Amazon ECS crée un modèle de lancement pour vos instances avec la dernière AMI associée au système d'exploitation sélectionné.

Lorsque vous créez AWS CloudFormation un cluster, le paramètre SSM fait partie du modèle de EC2 lancement Amazon pour les instances du groupe Auto Scaling. Vous pouvez configurer le modèle pour utiliser un paramètre dynamique de Systems Manager afin de déterminer l'AMI optimisée Amazon ECS à déployer. Ce paramètre garantit que chaque fois que vous déployez la pile, elle vérifie si une mise à jour disponible doit être appliquée aux EC2 instances. Pour un exemple d'utilisation du paramètre Systems Manager, consultez la section Créer un cluster Amazon ECS avec l'AMI Amazon Linux 2023 optimisée pour Amazon ECS dans le guide de l'AWS CloudFormation utilisateur.

L'ID de l'AMI, le nom de l'image, le système d'exploitation, la version de l'agent de conteneur, le nom de l'image source et la version d'exécution de chaque variante d'Amazon ECS-Optimized AMIs peuvent être récupérés par programmation en interrogeant l'API Systems Manager Parameter Store. Pour plus d'informations sur l'API Systems Manager Parameter Store, reportez-vous aux sections GetParameterset GetParametersByPath.

Format de paramètre Systems Manager Parameter Store

Les informations ci-dessous présentent le format de nom de paramètre pour chaque variante d'AMI optimisée pour Amazon ECS.

Optimisé pour Linux Amazon ECS AMIs

Le format de nom de paramètre suivant permet de récupérer l'ID d'image de la dernière AMI Amazon Linux 2 optimisée pour Amazon ECS recommandée à l'aide du sous-paramètre. image_id

/aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id

Le format de nom de paramètre suivant extrait les métadonnées d'une version spécifique d'AMI optimisée pour Amazon ECS en spécifiant le nom d'AMI.

Exemples

Les exemples suivants montrent comment vous pouvez récupérer les métadonnées de chaque variante d'AMI optimisée pour Amazon ECS.

Récupération des métadonnées de l'AMI optimisée pour Amazon ECS la plus récente recommandée

Vous pouvez récupérer la dernière AMI optimisée pour Amazon ECS recommandée à l' AWS CLI aide des commandes suivantes AWS CLI .

Optimisé pour Linux Amazon ECS AMIs

Extraction de l'ID d'image de la dernière AMI Amazon Linux 2023 optimisée pour Amazon ECS recommandée

Vous pouvez extraire l'ID d'image de l'ID de la dernière AMI Amazon Linux 2023 optimisée pour Amazon ECS recommandée en utilisant le sous-paramètre image_id.

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/image_id --region us-east-1

Pour extraire uniquement la valeur image_id, vous pouvez interroger la valeur de paramètre spécifique ; par exemple :

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/image_id --region us-east-1 --query "Parameters[0].Value"

Extraction des métadonnées d'une version spécifique d'AMI Amazon Linux 2 optimisée pour Amazon ECS

Récupérez les métadonnées d'une version spécifique de l'AMI Amazon Linux optimisée pour Amazon ECS à l' AWS CLI aide de la commande suivante AWS CLI . Remplacez le nom d'AMI par le nom d'AMI Amazon Linux optimisée pour Amazon ECS pour procéder à l'extraction.

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/amzn2-ami-ecs-hvm-2.0.20200928-x86_64-ebs --region us-east-1

Récupération des métadonnées AMI du noyau Amazon Linux 2 5.10 optimisées pour Amazon ECS à l'aide de l'API Systems Manager GetParametersByPath

Récupérez les métadonnées de l'AMI Amazon Linux 2 optimisées pour Amazon ECS avec l' GetParametersByPath API Systems Manager à l'aide de la AWS CLI commande suivante.

aws ssm get-parameters-by-path --path /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/ --region us-east-1

Récupération de l'ID d'image de la dernière AMI Amazon Linux 2 5.10 recommandée optimisée pour Amazon ECS

Vous pouvez récupérer l'ID d'image du dernier ID AMI Amazon Linux 2 5.10 recommandé optimisé pour Amazon ECS en utilisant le sous-paramètre. image_id

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended/image_id --region us-east-1

Pour extraire uniquement la valeur image_id, vous pouvez interroger la valeur de paramètre spécifique ; par exemple :

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id --region us-east-1 --query "Parameters[0].Value"

Utilisation de l'AMI optimisée pour Amazon ECS la plus récente recommandée dans un modèle AWS CloudFormation

Vous pouvez référencer la dernière AMI optimisée pour Amazon ECS recommandée dans un modèle AWS CloudFormation en référençant le nom du magasin de paramètres Systems Manager.

Exemple Linux

Parameters:kernel-5.10
  LatestECSOptimizedAMI:
    Description: AMI ID
    Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>
    Default: /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended/image_id