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 de métadonnées Linux ECS optimisées pour Amazon AMI

Vous pouvez récupérer par programmation les métadonnées optimisées pour AmazonECS. AMI Les métadonnées incluent le AMI nom, la version de l'agent de ECS conteneur Amazon et la version ECS d'exécution Amazon, 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 version AMI associée au système d'exploitation sélectionné.

Lorsque vous créez AWS CloudFormation un cluster, le SSM paramètre 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 ce qu'Amazon ECS Optimized AMI doit 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 Create an Amazon ECS cluster with Amazon Linux 2023 ECS optimisé pour Amazon AMI dans le guide de l'AWS CloudFormation utilisateur.

L'AMIID, 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 ECS optimisée pour Amazon AMIs peuvent être récupérés par programmation en interrogeant le magasin de paramètres de Systems Manager. API Pour plus d'informations sur le magasin de paramètres Systems ManagerAPI, reportez-vous GetParametersaux sections et GetParametersByPath.

Format de paramètre Systems Manager Parameter Store

Le format du nom du paramètre pour chaque AMI variante ECS optimisée pour Amazon est le suivant.

Optimisé pour Linux pour Amazon ECS AMIs

Le format de nom de paramètre suivant permet de récupérer l'ID d'image de la dernière version stable d'Amazon Linux 2 ECS AMI optimisée pour Amazon à 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 récupère les métadonnées d'une AMI version spécifique ECS optimisée pour Amazon en spécifiant le AMI nom.

Exemples

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

Récupération des métadonnées de la dernière version stable optimisée pour Amazon ECS AMI

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

Optimisé pour Linux pour Amazon ECS AMIs

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

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

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'Amazon Linux 2 ECS optimisée pour Amazon AMI

Récupérez les métadonnées d'une AMI version spécifique d'Amazon Linux ECS optimisée pour Amazon à l' AWS CLI aide de la AWS CLI commande suivante. Remplacez le AMI nom par le nom de l'Amazon Linux ECS optimisé pour Amazon AMI à 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 AMI métadonnées du noyau ECS Amazon Linux 2 5.10 optimisées pour Amazon à l'aide du Systems Manager GetParametersByPath API

Récupérez les AMI métadonnées Amazon Linux 2 ECS optimisées pour Amazon avec le Systems Manager GetParametersByPath API à 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 du dernier noyau Amazon Linux 2 ECS 5.10 optimisé pour Amazon recommandé AMI

Vous pouvez récupérer l'ID d'image du dernier AMI identifiant du noyau Amazon Linux 2 ECS optimisé pour Amazon recommandé pour Amazon 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 la dernière version recommandée ECS optimisée pour Amazon AMI dans un modèle AWS CloudFormation

Vous pouvez référencer la dernière version ECS optimisée pour Amazon recommandée AMI dans un AWS 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