View a markdown version of this page

Récupération d'Amazon ECS-optimized Métadonnées AMI Linux - Amazon Elastic Container Service

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 d'Amazon ECS-optimized Métadonnées AMI Linux

Vous pouvez récupérer l'Amazon par programmation ECS-optimized Métadonnées AMI. 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é.

Quand vous utilisez CloudFormation pour créer 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, voir Créez un cluster Amazon ECS avec Amazon ECS-optimized AMI Amazon Linux 2023 dans le AWS CloudFormation Guide de l'utilisateur.

L'ID 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 pour chaque variante d'Amazon ECS-optimized Les AMI peuvent être récupérées par programmation en interrogeant l'API Systems Manager Parameter Store. Pour plus d'informations sur l'API Systems Manager Parameter Store, voir GetParameters et GetParametersByPath.

Note

Votre utilisateur administratif doit disposer des autorisations IAM suivantes pour récupérer l'Amazon ECS-optimized Métadonnées AMI. Ces autorisations ont été ajoutées à la politique IAM AmazonECS_FullAccess.

  • sms :GetParameters

  • sms :GetParameter

  • sms :GetParametersByPath

Format de paramètre Systems Manager Parameter Store

Voici le format du nom des paramètres pour chaque Amazon ECS-optimized Variante AMI.

Amazon pour Linux ECS-optimized AMI

  • Métadonnées d'AMI Amazon Linux 2023 :

    /aws/service/ecs/optimized-ami/amazon-linux-2023/<version>
  • Métadonnées d'AMI Amazon Linux 2023 (arm64) :

    /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/<version>
  • Métadonnées d'AMI Amazon Linux 2023 (Neuron) :

    /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/<version>
  • Métadonnées de l’AMI Amazon Linux 2023 (GPU) :

    /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/<version>

    Métadonnées d'AMI Amazon Linux 2 :

    /aws/service/ecs/optimized-ami/amazon-linux-2/<version>
  • Métadonnées d'AMI Amazon Linux 2 noyau 5.10 :

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/<version>
  • Métadonnées d'AMI Amazon Linux 2 (arm64) :

    /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>
  • Métadonnées d'AMI Amazon Linux 2 noyau 5.10 (arm64) :

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>
  • Amazon ECS GPU-optimized métadonnées AMI du noyau 5.10 :

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>
  • Métadonnées d'AMI Amazon Linux 2 (GPU) :

    /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>
  • Métadonnées de l’AMI Amazon Linux 2 (Neuron) avec noyau 5.10 optimisée pour Amazon ECS :

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/<version>
  • Métadonnées d'AMI Amazon Linux 2 (Neuron) :

    /aws/service/ecs/optimized-ami/amazon-linux-2/inf/<version>

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

  • Amazon ECS-optimized Métadonnées AMI Amazon Linux 2 :

    /aws/service/ecs/optimized-ami/amazon-linux-2/amzn2-ami-ecs-hvm-2.0.20181112-x86_64-ebs
Note

Toutes les versions d'Amazon ECS-optimized Les AMI Amazon Linux 2 peuvent être récupérées. Amazon uniquement ECS-optimized Versions de l'AMI amzn-ami-2017.09.l-amazon-ecs-optimized (Linux) et versions ultérieures peuvent être récupérées.

Exemples

Les exemples suivants montrent comment vous pouvez récupérer les métadonnées de chaque Amazon. ECS-optimized Variante AMI.

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

Vous pouvez récupérer la dernière version recommandée d'Amazon ECS-optimized AMI utilisant le AWS CLI avec les éléments suivants AWS CLI commandes.

Amazon pour Linux ECS-optimized AMI

  • Pour l'Amazon ECS-optimized AMI Amazon Linux 2023 :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI Amazon Linux 2023 (arm64) :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI Amazon Linux 2023 (Neuron) :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI GPU Amazon Linux 2023 :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI du noyau 5.10 d'Amazon Linux 2 :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI Amazon Linux 2 :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI du noyau 5.10 (arm64) d'Amazon Linux 2 :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region us-east-1
  • Pour l'Amazon ECS-optimized AMI Amazon Linux 2 (arm64) :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region us-east-1
  • Pour Amazon ECS GPU-optimized AMI du noyau 5.10 :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/recommended --region us-east-1
  • Pour Amazon ECS GPU-optimized AMI :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Pour les AMI Amazon Linux 2 (Neuron) avec noyau 5.10 optimisées pour Amazon ECS :

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region us-east-1
  • Pour les AMI Amazon Linux 2 (Neuron) optimisées pour Amazon ECS :

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

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

Vous pouvez récupérer l'identifiant de l'image de la dernière version recommandée d'Amazon ECS-optimized ID AMI Amazon Linux 2023 à l'aide du 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"

Récupération des métadonnées d'un Amazon spécifique ECS-optimized Version AMI d'Amazon Linux 2

Récupérez les métadonnées d'un Amazon spécifique ECS-optimized Version de l'AMI Amazon Linux utilisant le AWS CLI avec les éléments suivants AWS CLI commande. Remplacez le nom de l'AMI par le nom de l'Amazon ECS-optimized AMI 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 de l'Amazon ECS-optimized Métadonnées AMI du noyau 5.10 d'Amazon Linux 2 à l'aide du gestionnaire de systèmes GetParametersByPath API

Récupérez l'Amazon ECS-optimized Métadonnées AMI Amazon Linux 2 avec le gestionnaire de systèmes GetParametersByPath API utilisant le AWS CLI à l'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'identifiant de l'image de la dernière version recommandée d'Amazon ECS-optimized AMI 5.10 du noyau Amazon Linux 2

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

Vous pouvez consulter la dernière version recommandée d'Amazon ECS-optimized AMI dans un CloudFormation modèle en faisant référence au nom du magasin de paramètres de 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