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 a livello di codice 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 lo utilizzi AWS CloudFormation per creare un cluster, il parametro SSM fa parte del modello di EC2 lancio di Amazon 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, verifichi se sono disponibili 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 Linux 2023 ottimizzata per Amazon ECS nella Guida per AWS CloudFormation l'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 di Amazon ECS Optimized AMIs possono essere recuperati a livello di codice interrogando l'API Systems Manager Parameter Store. 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: GetParametersByPath

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.

Ottimizzato per Linux Amazon ECS AMIs

  • 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 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 seguente formato del nome del parametro recupera l'ID immagine dell'ultima AMI Amazon Linux 2 ottimizzata per Amazon ECS consigliata utilizzando il sottoparametro. 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'ultima AMI ottimizzata per Amazon ECS consigliata

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

Ottimizzato per Linux Amazon ECS AMIs

  • Per Amazon Linux 2023 ottimizzato per Amazon ECS: AMIs

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

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

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

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

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

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

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

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

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

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

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

    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