Abrufen von ECS Amazon-optimierten Linux-Metadaten AMI

Sie können die für Amazon ECS optimierten Metadaten programmgesteuert abrufen. AMI Die Metadaten umfassen den AMI Namen, die ECS Amazon-Container-Agent-Version und die ECS Amazon-Runtime-Version, die die Docker-Version enthält.

Wenn Sie mit der Konsole einen Cluster erstellen, ECS erstellt Amazon eine Startvorlage für Ihre Instances, wobei die neueste Version mit dem ausgewählten Betriebssystem AMI verknüpft ist.

Wenn Sie AWS CloudFormation einen Cluster erstellen, ist der SSM Parameter Teil der EC2 Amazon-Startvorlage für die Auto Scaling Scaling-Gruppeninstanzen. Sie können die Vorlage so konfigurieren, dass ein dynamischer Systems Manager Manager-Parameter verwendet wird, um zu bestimmen, welche von Amazon ECS Optimized bereitgestellt werden AMI sollen. Dieser Parameter stellt sicher, dass bei jeder Bereitstellung des Stacks geprüft wird, ob ein Update verfügbar ist, das auf die EC2 Instances angewendet werden muss. Ein Beispiel für die Verwendung des Systems Manager Manager-Parameters finden Sie unter Erstellen eines ECS Amazon-Clusters mit dem ECS für Amazon optimierten Amazon Linux 2023 AMI im AWS CloudFormation Benutzerhandbuch.

Die AMI ID, der Image-Name, das Betriebssystem, die Container-Agent-Version, der Quell-Image-Name und die Laufzeitversion für jede Variante von Amazon ECS -optimized AMIs können programmgesteuert abgerufen werden, indem der Systems Manager Parameter Store abgefragt wird. API Weitere Informationen zum Systems Manager Manager-Parameterspeicher API finden Sie unter GetParametersund GetParametersByPath.

Anmerkung

Ihr Administratorbenutzer muss über die folgenden IAM Berechtigungen verfügen, um die für Amazon ECS optimierten AMI Metadaten abzurufen. Diese Berechtigungen wurden der AmazonECS_FullAccess IAM Richtlinie hinzugefügt.

• ssm: GetParameters

• ssm: GetParameter

• ssm: GetParametersByPath

Systems Manager Parameterspeicher-Parameterformat

Im Folgenden finden Sie das Format des Parameternamens für jede für Amazon ECS optimierte AMI Variante.

Linux Amazon ECS -optimiert AMIs

• Amazon Linux AMI 2023-Metadaten:

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

• Amazon Linux 2023 (arm64) AMI -Metadaten:

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

• AMIMetadaten zu Amazon Linux 2023 (Neuron):

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

• Amazon Linux AMI 2-Metadaten:

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

• AMIMetadaten des Amazon Linux 2-Kernels 5.10:

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

• Amazon Linux 2 (arm64) AMI -Metadaten:

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

• Metadaten des Amazon Linux 2-Kernels 5.10 (arm64)AMI:

  /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>

• ECSGPUAmazon-optimierte AMI Kernel-5.10-Metadaten:

  /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>

• Amazon Linux 2 (GPU) AMI -Metadaten:

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

• Amazon hat Amazon Linux 2 (Neuron) -Kernel AMI 5.10-Metadaten ECS optimiert:

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

• Amazon Linux 2 (Neuron) AMI -Metadaten:

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

Das folgende Parameternamenformat ruft die Image-ID des neuesten stabilen, für Amazon Linux 2 ECS optimierten Amazon Linux 2 AMI mithilfe des Unterparameters ab. image_id

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

Das folgende Parameternamenformat ruft die Metadaten einer bestimmten, für Amazon ECS optimierten AMI Version ab, indem der AMI Name angegeben wird.

• ECSAmazon-optimierte Amazon Linux AMI 2-Metadaten:

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

Anmerkung

Alle Versionen des für Amazon ECS optimierten Amazon Linux 2 AMI stehen zum Abruf zur Verfügung. Nur für Amazon ECS optimierte AMI Versionen amzn-ami-2017.09.l-amazon-ecs-optimized (Linux) und höher können abgerufen werden.

Beispiele

Die folgenden Beispiele zeigen, wie Sie die Metadaten für jede für Amazon ECS optimierte AMI Variante abrufen können.

Abrufen der Metadaten der neuesten stabilen ECS Amazon-Version AMI

Sie können die neueste stabile Version von Amazon ECS -optimized AMI AWS CLI mit den folgenden AWS CLI Befehlen abrufen.

Linux Amazon ECS -optimiert AMIs

• Für das ECS Amazon-optimierte Amazon Linux 2023AMIs:

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

• Für das ECS Amazon-optimierte Amazon Linux 2023 (arm64): AMIs

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

• Für das ECS Amazon-optimierte Amazon Linux 2023 (Neuron): AMIs

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

• Für den ECS Amazon-optimierten Amazon Linux 2-Kernel AMIs 5.10:

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

• Für das ECS Amazon-optimierte Amazon Linux 2: AMIs

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

• Für den ECS Amazon-optimierten Amazon Linux 2-Kernel 5.10 (arm64): AMIs

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

• Für das ECS Amazon-optimierte Amazon Linux 2 (arm64): AMIs

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

• Für den ECS GPU Amazon-optimierten Kernel AMIs 5.10:

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

• Für ECS GPU Amazon-OptimierteAMIs:

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

• Für den von Amazon ECS optimierten Amazon Linux 2 (Neuron) -Kernel AMIs 5.10:

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

• Für das von Amazon ECS optimierte Amazon Linux 2 (Neuron)AMIs:

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

Abrufen der Image-ID des neuesten empfohlenen ECS Amazon-optimierten Amazon Linux 2023 AMI

Sie können die Image-ID der neuesten empfohlenen, für Amazon ECS optimierten Amazon Linux AMI 2023-ID mithilfe des image_id Unterparameters abrufen.

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

Um nur den image_id-Wert abzurufen, können Sie den spezifischen Parameterwert abzufragen, z. B.:

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

Abrufen der Metadaten einer bestimmten ECS Amazon-optimierten Amazon Linux 2-Version AMI

Rufen Sie AWS CLI mit dem folgenden AWS CLI Befehl die Metadaten einer bestimmten ECS Amazon-optimierten Amazon AMI Linux-Version ab. Ersetzen Sie den AMI Namen durch den Namen des ECS Amazon-optimierten Amazon Linux, das abgerufen AMI werden soll.

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

Abrufen der ECS Amazon-optimierten Amazon Linux AMI 2-Kernel-5.10-Metadaten mit dem Systems Manager GetParametersByPath API

Rufen Sie die für Amazon ECS optimierten Amazon Linux AMI 2-Metadaten mit dem Systems Manager ab, GetParametersByPath API indem Sie den AWS CLI folgenden Befehl verwenden.

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

Abrufen der Image-ID des neuesten empfohlenen ECS Amazon-optimierten Amazon Linux 2-Kernels 5.10 AMI

Sie können die Image-ID der neuesten empfohlenen ECS Amazon-optimierten Amazon Linux AMI 2-Kernel-5.10-ID mithilfe des Unterparameters abrufen. 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

Um nur den image_id-Wert abzurufen, können Sie den spezifischen Parameterwert abzufragen, z. B.:

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

Verwenden der neuesten empfohlenen ECS Amazon-optimierten Version AMI in einer Vorlage AWS CloudFormation

Sie können AMI in einer AWS CloudFormation Vorlage auf die neueste empfohlene Version von Amazon ECS -optimized verweisen, indem Sie auf den Namen des Systems Manager Manager-Parameterspeichers verweisen.

Linux-Beispiel

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