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 Amazon ECS-optimized Linux

Vous pouvez récupérer les métadonnées Amazon ECS-optimized AMI par programmation. Les métadonnées incluent le nom de l’AMI, la version de l’agent de conteneur Amazon ECS et la version de l’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 CloudFormation un cluster, le paramètre SSM fait partie du modèle de lancement Amazon EC2 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 pour Amazon ECS à déployer. Ce paramètre garantit que chaque fois que vous déployez la pile, une vérification est effectuée pour voir s’il existe une mise à jour disponible qui doit être appliquée aux instances EC2. Pour un exemple d'utilisation du paramètre Systems Manager, consultez la section Créer un cluster Amazon ECS avec l'AMI Amazon ECS-optimized Amazon Linux 2023 dans le guide de AWS CloudFormation l'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 des ECS-optimized AMI Amazon 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

Le format du nom du paramètre pour chaque variante d'Amazon ECS-optimized AMI est le suivant.

ECS-optimized AMI Amazon pour Linux

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

/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'Amazon ECS-optimized AMI en spécifiant le nom de l'AMI.

Exemples

Les exemples suivants montrent comment récupérer les métadonnées pour chaque variante d'Amazon ECS-optimized AMI.

Récupération des métadonnées de la dernière AMI Amazon ECS-optimized recommandée

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

ECS-optimized AMI Amazon pour Linux

Récupération de l'ID d'image de la dernière AMI Amazon ECS-optimized Amazon Linux 2023 recommandée

Vous pouvez récupérer l'ID d'image du dernier identifiant AMI Amazon ECS-optimized Amazon Linux 2023 recommandé en utilisant le sous-paramètreimage_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 de l'AMI ECS-optimized Amazon Amazon Linux 2

Récupérez les métadonnées d'une version spécifique de l'AMI ECS-optimized Amazon Amazon Linux à l' AWS CLI aide de la AWS CLI commande suivante. Remplacez le nom de l'AMI par le nom de l'AMI ECS-optimized Amazon Amazon Linux à récupérer.

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 de l'AMI du noyau 5.10 d' ECS-optimized Amazon Amazon Linux 2 à l'aide de l'API Systems Manager GetParametersByPath

Récupérez les métadonnées de l'AMI ECS-optimized Amazon Amazon Linux 2 avec l' GetParametersByPath API Systems Manager à l' AWS CLI aide de la 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 recommandée pour le noyau ECS-optimized Amazon Amazon Linux 2 5.10

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

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 la dernière ECS-optimized AMI Amazon recommandée dans un CloudFormation modèle

Vous pouvez faire référence à la dernière ECS-optimized AMI Amazon recommandée dans un CloudFormation modèle en faisant référence au 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