Recupero di metadati AMI Linux ottimizzati per Amazon ECS - 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 di metadati AMI Linux ottimizzati per Amazon ECS

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

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

Quando si utilizza AWS 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 per utilizzare un parametro dinamico di Systems Manager per determinare quale AMI Amazon ECS Optimized distribuire. Questo parametro garantisce che ogni volta che distribuisci lo stack, venga verificato se è disponibile un aggiornamento 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 Linux 2023 ottimizzata per Amazon ECS nella Guida per AWS CloudFormation l'utente.

L'ID dell'AMI, il nome dell'immagine, il sistema operativo, la versione dell'agente del container, il nome dell'immagine di origine e la versione di runtime per ogni variante delle AMI ottimizzate per Amazon ECS possono essere recuperati a livello di programmazione eseguendo una query sull'API dell'archivio parametri di Systems Manager. Per ulteriori informazioni sull'API Systems Manager Parameter Store, vedere GetParameterse GetParametersByPath.

Nota

Per recuperare i metadati dell'AMI ottimizzata per Amazon ECS, l'utente di amministrazione deve disporre delle seguenti autorizzazioni IAM. Queste autorizzazioni sono state aggiunte alla policy IAM AmazonECS_FullAccess.

  • ssm: GetParameters

  • ssm: GetParameter

  • ssm: GetParameters ByPath

Formato del parametro dell'archivio parametri di Systems Manager

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

AMI Amazon Linux ottimizzate per Amazon ECS

  • 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 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/amazal2023neuronamion-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 kernel 5.10 ottimizzati per GPU 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) del kernel 5.10 ottimizzati 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 formato dei nomi di parametro seguente recupera l'ID immagine dell'AMI Amazon Linux 2 ottimizzata per Amazon ECS tramite il parametro secondario image_id.

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

Il formato dei nomi di parametro seguente recupera i metadati di una versione di AMI ottimizzata per Amazon ECS specifica indicando il nome dell'AMI.

  • Metadati dell'AMI Amazon Linux 2 ottimizzata per Amazon ECS:

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

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

Esempi

Negli esempi seguenti vengono illustrati i modi in cui è possibile recuperare i metadati per ogni variante dell'AMI ottimizzata per Amazon ECS.

Recupero dei metadati dell'AMI ottimizzata per Amazon ECS stabile più recente

Puoi recuperare l'ultima AMI stabile ottimizzata per Amazon ECS utilizzando AWS CLI i AWS CLI seguenti comandi.

AMI Amazon Linux ottimizzate per Amazon ECS

  • Per le AMI Amazon Linux 2023 ottimizzate per Amazon ECS:

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

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

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

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

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

    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 Amazon Linux 2 (arm64) ottimizzate per Amazon ECS:

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

    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 ottimizzate per GPU:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Per le AMI del kernel 5.10 Amazon Linux 2 (Neuron) 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'AMI Amazon Linux 2023 ottimizzata per Amazon ECS consigliata più recente

Puoi recuperare l'ID immagine dell'ID dell'AMI Amazon Linux 2023 ottimizzata per Amazon ECS consigliata più recente utilizzando il parametro secondario image_id.

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 Linux 2 ottimizzata per Amazon ECS

Recupera i metadati di una versione specifica dell'AMI Amazon Linux ottimizzata per Amazon ECS utilizzando AWS CLI il comando seguente. AWS CLI Sostituisci il nome dell'AMI con il nome dell'AMI ottimizzata per Amazon ECS 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 Amazon Linux 2 kernel 5.10 ottimizzati per Amazon ECS utilizzando l'API Systems Manager GetParametersByPath

Recupera i metadati AMI Amazon Linux 2 ottimizzati per Amazon ECS con l'API Systems GetParametersByPath Manager utilizzando AWS CLI il 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 Linux 2 kernel 5.10 consigliata e ottimizzata per Amazon ECS

Puoi recuperare l'ID immagine dell'ultimo ID AMI Amazon Linux Linux 2 kernel 5.10 consigliato per Amazon ECS 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 dell'ultima AMI ottimizzata per Amazon ECS consigliata in un modello AWS CloudFormation

Puoi consultare l'AMI ottimizzata per Amazon ECS più recente in un modello AWS CloudFormation facendo riferimento al nome dell'archivio 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