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.
Abrufen von Amazon ECS-optimierten Linux-AMI-Metadaten
Sie können die Amazon ECS-optimierten AMI-Metadaten programmgesteuert abrufen. Die Metadaten umfassen den AMI-Namen, die Amazon ECS-Container-Agent-Version 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 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, welches Amazon ECS-optimierte AMI bereitgestellt werden soll. Dieser Parameter stellt sicher, dass der Stack bei jeder Bereitstellung überprüft, 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 Amazon ECS-Clusters mit dem Amazon ECS-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 des 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 GetParametersund GetParametersByPath.
Anmerkung
Ihr administrativer Benutzer muss über die folgenden IAM-Berechtigungen verfügen, um die 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 ist das Format des Parameternamens für jede Amazon-ECS-optimierte AMI-Variante aufgeführt.
Linux Amazon ECS-optimiert 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>
-
GPU-optimierte Amazon ECS 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-optimierte 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 Parameternamenformat ruft mithilfe des Unterparameters die Image-ID des neuesten empfohlenen Amazon ECS-optimierten Amazon Linux 2-AMIs ab. image_id
/aws/service/ecs/optimized-ami/amazon-linux-2/
recommended/image_id
Das folgende Parameternamen-Format ruft die Metadaten einer bestimmten Amazon-ECS-optimierten AMI-Version ab, indem der AMI-Name angegeben wird.
-
Amazon-ECS-optimierte 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 des Amazon-ECS-optimierten Amazon Linux 2-AMI stehen zum Abrufen bereit. Nur 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 Amazon-ECS-optimierte AMI-Variante abrufen können.
Abrufen der Metadaten des neuesten empfohlenen Amazon ECS-optimierten AMI
Sie können das neueste empfohlene Amazon ECS-optimierte AMI AWS CLI mit den folgenden AWS CLI Befehlen abrufen.
Linux Amazon ECS-optimiert AMIs
-
Für das Amazon ECS-optimierte Amazon Linux 2023: AMIs
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region
us-east-1
-
Für das Amazon ECS-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 Amazon ECS-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 die Amazon ECS-optimierte Amazon Linux 2023-GPU: AMIs
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region
us-east-1
-
Für den Amazon ECS-optimierten 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 das Amazon ECS-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 Amazon ECS-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 Amazon ECS-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 GPU-optimierten Amazon ECS-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 AMIs GPU-optimierte Amazon ECS:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region
us-east-1
-
Für den 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 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 Amazon-ECS-optimierten AMIs für Amazon Linux 2023
Sie können die Image-ID der aktuellen empfohlenen Amazon-ECS-optimierten AMI-ID für Amazon Linux 2023 mit dem Sub-Parameter image_id
abrufen.
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/
recommended/image_id
--regionus-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 Amazon-ECS-optimierten Amazon Linux 2-AMI-Version
Rufen Sie mit dem folgenden AWS CLI Befehl die Metadaten einer bestimmten Amazon ECS-optimierten Amazon Linux AWS CLI AMI-Version ab. Ersetzen Sie den AMI-Namen durch den Namen des abzurufenden Amazon-ECS-optimierten Amazon Linux AMI.
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/
amzn2-ami-ecs-hvm-2.0.20200928-x86_64-ebs
--regionus-east-1
Abrufen der Amazon ECS-optimierten Amazon Linux 2-Kernel-5.10-AMI-Metadaten mithilfe der Systems Manager Manager-API GetParametersByPath
Rufen Sie die Amazon ECS-optimierten Amazon Linux 2-AMI-Metadaten mit der Systems Manager GetParametersByPath Manager-API ab, 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 Amazon ECS-optimierten Amazon Linux 2-Kernel-5.10-AMI
Sie können die Image-ID der neuesten empfohlenen Amazon ECS-optimierten Amazon Linux 2 Kernel 5.10 AMI-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
--regionus-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 des neuesten empfohlenen Amazon ECS-optimierten AMI in einer Vorlage AWS CloudFormation
Sie können auf das neueste empfohlene Amazon-ECS-optimierte AMI in einer AWS CloudFormation -Vorlage verweisen, indem Sie auf den Systems Manager Parameterspeichernamen 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