View a markdown version of this page

Recupero dei metadati ECS-optimized AMI Amazon Linux - Amazon Elastic Container Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Recupero dei metadati ECS-optimized AMI Amazon Linux

Puoi recuperare in modo programmatico i metadati di Amazon AMI ECS-optimized . I metadati includono il nome AMI, la versione dell'agente container Amazon ECS e la versione runtime Amazon ECS che include la versione Docker.

Quando crei un cluster usando la console, Amazon ECS crea un modello di avvio per le tue istanze con l'ultima AMI associata al sistema operativo selezionato.

Quando si utilizza CloudFormation per creare un cluster, il parametro SSM fa parte del modello di avvio di Amazon EC2 per le istanze del gruppo Auto Scaling. Puoi configurare il modello in modo da usare un parametro dinamico di Systems Manager per determinare quale AMI Amazon ECS Optimized implementare. Questo parametro garantisce che, ogni volta che implementi lo stack, venga verificata la disponibilità di aggiornamenti da applicare alle istanze EC2. Per un esempio di come utilizzare il parametro Systems Manager, consulta Creare un cluster Amazon ECS con l'AMI Amazon ECS-optimized Amazon Linux 2023 nella Guida per l'AWS CloudFormation utente.

L'ID AMI, il nome dell'immagine, il sistema operativo, la versione dell'agente contenitore, il nome dell'immagine di origine e la versione di runtime per ogni variante delle AMI Amazon possono essere recuperati a livello di codice interrogando l'API Systems Manager ECS-optimized Parameter Store. Per ulteriori informazioni sull'API Systems Manager Parameter Store, vedere GetParameterse GetParametersByPath.

Nota

L'utente amministrativo deve disporre delle seguenti autorizzazioni IAM per recuperare i metadati Amazon ECS-optimized AMI. Queste autorizzazioni sono state aggiunte alla policy IAM AmazonECS_FullAccess.

  • ssm: GetParameters

  • ssm: GetParameter

  • ssm: GetParametersByPath

Formato del parametro dell'archivio parametri di Systems Manager

Di seguito è riportato il formato del nome del parametro per ogni variante di Amazon ECS-optimized AMI.

ECS-optimized AMI Amazon Linux

  • Metadati dell'AMI Amazon Linux 2023:

    /aws/service/ecs/optimized-ami/amazon-linux-2023/<version>
  • Metadati dell'AMI Amazon Linux 2023 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/<version>
  • Metadati dell'AMI Amazon Linux 2023 (Neuron):

    /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/<version>
  • Metadati AMI Amazon Linux 2023 (GPU):

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

    Metadati AMI Amazon Linux 2:

    /aws/service/ecs/optimized-ami/amazon-linux-2/<version>
  • Metadati AMI Amazon Linux 2 kernel 5.10:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/<version>
  • Metadati AMI Amazon Linux 2 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>
  • Metadati AMI Amazon Linux 2 (arm64) kernel 5.10:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>
  • Metadati AMI del GPU-optimized kernel 5.10 di Amazon ECS:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>
  • Metadati AMI Amazon Linux 2 (GPU):

    /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>
  • Metadati AMI Amazon Linux 2 (Neuron) kernel 5.10 ottimizzata per Amazon ECS:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/<version>
  • Metadati dell'AMI Amazon Linux 2 (Neuron):

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

Il seguente formato del nome del parametro recupera l'ID immagine dell'ultima AMI Amazon Linux 2 consigliata di ECS-optimized Amazon Linux 2 utilizzando il image_id sottoparametro.

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

Il seguente formato del nome del parametro recupera i metadati di una versione specifica di Amazon ECS-optimized AMI specificando il nome dell'AMI.

  • Metadati delle AMI ECS-optimized Amazon Amazon Linux 2:

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

Tutte le versioni dell'AMI ECS-optimized Amazon Amazon Linux 2 sono disponibili per il recupero. È possibile recuperare solo le versioni Amazon ECS-optimized AMI amzn-ami-2017.09.l-amazon-ecs-optimized (Linux) e successive.

Esempi

Gli esempi seguenti mostrano i modi in cui è possibile recuperare i metadati per ogni variante di Amazon ECS-optimized AMI.

Recupero dei metadati dell'ultima AMI Amazon consigliata ECS-optimized

Puoi recuperare l'ultima ECS-optimized AMI Amazon consigliata utilizzando AWS CLI i seguenti AWS CLI comandi.

ECS-optimized AMI Amazon Linux

  • Per le AMI ECS-optimized Amazon Amazon Linux 2023:

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

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

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

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

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

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

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

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

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

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Per le AMI Amazon Linux 2 (Neuron) kernel 5.10 ottimizzate per Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region us-east-1
  • Per le AMI Amazon Linux 2 (Neuron) ottimizzate per Amazon ECS:

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

Recupero dell'ID immagine dell'ultima AMI Amazon ECS-optimized Amazon Linux 2023 consigliata

Puoi recuperare l'ID immagine dell'ultimo ID AMI Amazon ECS-optimized Amazon Linux 2023 consigliato utilizzando il image_id sottoparametro.

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

Per recuperare solo il valore image_id, è possibile eseguire query sul valore di parametro specifico, ad esempio:

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

Recupero dei metadati di una versione specifica dell'AMI Amazon ECS-optimized Amazon Linux 2

Recupera i metadati di una versione specifica dell'AMI ECS-optimized Amazon Amazon Linux utilizzando il AWS CLI comando seguente AWS CLI . Sostituisci il nome dell'AMI con il nome dell'AMI ECS-optimized Amazon Amazon Linux da recuperare.

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

Recupero dei metadati AMI ECS-optimized Amazon Amazon Linux 2 kernel 5.10 utilizzando l'API Systems Manager GetParametersByPath

Recupera i metadati AMI ECS-optimized Amazon Amazon Linux 2 con l' GetParametersByPath API Systems Manager utilizzando il AWS CLI comando seguente.

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

Recupero dell'ID immagine dell'ultima AMI Amazon ECS-optimized Amazon Linux 2 kernel 5.10 consigliata

Puoi recuperare l'ID immagine dell'ultimo ID AMI Amazon ECS-optimized Amazon Linux 2 kernel 5.10 consigliato utilizzando il sottoparametro. 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

Per recuperare solo il valore image_id, è possibile eseguire query sul valore di parametro specifico, ad esempio:

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

Utilizzo della versione più recente di Amazon ECS-optimized AMI consigliata in un CloudFormation modello

Puoi fare riferimento all'ultima Amazon ECS-optimized AMI consigliata in un CloudFormation modello facendo riferimento al nome dell'archivio dei parametri di Systems Manager.

Esempio per 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