View a markdown version of this page

Amazon wird abgerufen ECS-optimized Linux-AMI-Metadaten - Amazon Elastic Container Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon wird abgerufen ECS-optimized Linux-AMI-Metadaten

Sie können Amazon programmgesteuert abrufen ECS-optimized AMI-Metadaten. Die Metadaten umfassen den AMI-Namen, die Version des Amazon-ECS-Container-Agent und die Amazon-ECS-Laufzeitversion, die die Docker-Version enthält.

Wenn Sie mit der Konsole einen Cluster erstellen, erstellt Amazon ECS eine Startvorlage für Ihre Instances mit dem neuesten AMI, das dem ausgewählten Betriebssystem zugeordnet ist.

Wenn Sie verwenden CloudFormation Um einen Cluster zu erstellen, ist der SSM-Parameter Teil der Amazon EC2-Startvorlage für die Auto Scaling-Gruppeninstanzen. Sie können die Vorlage so konfigurieren, dass ein dynamischer Systems-Manager-Parameter verwendet wird, um zu bestimmen, welches Amazon-ECS-optimierte AMI bereitgestellt werden soll. Dieser Parameter stellt sicher, dass der Stack bei jeder Bereitstellung überprüft, ob eine Aktualisierung verfügbar ist, die auf die EC2-Instances angewendet werden muss. Ein Beispiel für die Verwendung des Systems Manager-Parameters finden Sie unter Erstellen Sie einen Amazon ECS-Cluster mit Amazon ECS-optimized Amazon Linux 2023 AMI in der AWS CloudFormation Benutzerleitfaden.

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 die Systems Manager Parameter Store API abgefragt wird. Weitere Informationen zur Systems Manager Parameter Store API finden Sie unter GetParameters und GetParametersByPath.

Anmerkung

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

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems Manager Parameterspeicher-Parameterformat

Das Folgende ist das Format des Parameternamens für jeden Amazon ECS-optimized AMI-Variante.

Linux, Amazon ECS-optimized AMIs

  • AMI-Metadaten für Amazon Linux 2023:

    /aws/service/ecs/optimized-ami/amazon-linux-2023/<version>
  • AMI-Metadaten für Amazon Linux 2023 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/<version>
  • AMI-Metadaten für Amazon Linux 2023 (Neuron):

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

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

    Amazon Linux 2-AMI Metadaten:

    /aws/service/ecs/optimized-ami/amazon-linux-2/<version>
  • Amazon Linux 2 AMI-Metadaten mit Kernel 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>
  • Amazon Linux 2 (arm64) AMI-Metadaten mit Kernel 5.10:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>
  • Amazon ECS GPU-optimized Kernel 5.10 AMI-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-ECS-optimiertes Amazon Linux 2 (Neuron) Kernel 5,10 AMI – Metadaten:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/<version>
  • AMI-Metadaten für Amazon Linux 2 (Neuron):

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

Das folgende Parameternamensformat ruft die Bild-ID der zuletzt empfohlenen Amazon-Version ab ECS-optimized Amazon Linux 2 AMI mithilfe des Unterparameters image_id.

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

Das folgende Parameternamensformat ruft die Metadaten eines bestimmten Amazon ab ECS-optimized AMI-Version durch Angabe des AMI-Namens.

  • Amazon ECS-optimized Amazon Linux 2 AMI-Metadaten:

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

Alle Versionen von Amazon ECS-optimized Amazon Linux 2 AMI stehen zum Abruf zur Verfügung. Nur Amazon ECS-optimized AMI-Versionen amzn-ami-2017.09.l-amazon-ecs-optimized (Linux) und spätere Versionen können abgerufen werden.

Beispiele

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

Abrufen der Metadaten der neuesten empfohlenen Amazon-Version ECS-optimized AMI

Sie können das neueste empfohlene Amazon abrufen ECS-optimized AMI verwendet den AWS CLI mit den folgenden AWS CLI Befehle.

Linux, Amazon. ECS-optimized AMIs

  • Für den Amazonas ECS-optimized Amazon Linux 2023 AMIs:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region us-east-1
  • Für den Amazonas ECS-optimized 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 den Amazonas ECS-optimized 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 Amazonas ECS-optimized GPU-AMIs für Amazon Linux 2023:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region us-east-1
  • Für den Amazonas ECS-optimized Amazon Linux 2 Kernel 5.10 AMIs:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region us-east-1
  • Für den Amazonas ECS-optimized 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 Amazonas ECS-optimized AMIs für 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
  • Für den Amazonas ECS-optimized 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 das Amazon ECS GPU-optimized Kernel-5.10-AMIs:

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

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Für die Amazon-ECS-optimierten AMIs für Amazon Linux 2 (Neuron) Kernel 5.10:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region us-east-1
  • Amazon-ECS-optimiertes AMI für Amazon Linux 2 (Neuron):

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

Abrufen der Bild-ID der zuletzt empfohlenen Amazon-Version ECS-optimized Amazon Linux 2023 AMI

Sie können die Image-ID des zuletzt empfohlenen Amazon abrufen ECS-optimized Amazon Linux 2023 AMI-ID mithilfe des Unterparameters image_id.

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 eines bestimmten Amazon ECS-optimized Amazon Linux 2 AMI-Version

Rufen Sie die Metadaten eines bestimmten Amazon ab ECS-optimized Amazon Linux AMI-Version unter Verwendung der AWS CLI mit den folgenden AWS CLI Befehl. Ersetzen Sie den AMI-Namen durch den Namen von Amazon ECS-optimized Amazon Linux AMI zum Abrufen.

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

Amazon wird abgerufen ECS-optimized AMI-Metadaten für Amazon Linux 2 Kernel 5.10 mithilfe des Systems Manager GetParametersByPath API

Rufen Sie den Amazon ab ECS-optimized Amazon Linux 2 AMI-Metadaten mit dem Systems Manager GetParametersByPath API unter Verwendung der AWS CLI mit dem folgenden Befehl.

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

Abrufen der Bild-ID der zuletzt empfohlenen Amazon-Version ECS-optimized Amazon Linux 2-Kernel 5.10 AMI

Sie können die Image-ID der zuletzt empfohlenen Amazon-Version abrufen ECS-optimized AMI-ID für Amazon Linux 2 Kernel 5.10 mithilfe des Unterparameters 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 Sie das neueste empfohlene Amazon ECS-optimized AMI in einem CloudFormation Vorlage

Sie können auf das zuletzt empfohlene Amazon verweisen ECS-optimized AMI in einem CloudFormation Vorlage durch Verweis auf den Namen des Systems Manager-Parameterspeichers.

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