Recuperación de metadatos de las AMI de Linux optimizadas para Amazon ECS - Amazon Elastic Container Service

Recuperación de metadatos de las AMI de Linux optimizadas para Amazon ECS

Puede recuperar mediante programación los metadatos de la AMI optimizada para Amazon ECS. Los metadatos incluyen el nombre de la AMI, la versión del agente de contenedor de Amazon ECS y la versión del tiempo de ejecución de ECS que incluye la versión de Docker.

Al crear un clúster mediante la consola, Amazon ECS crea una plantilla de lanzamiento para las instancias con la AMI más reciente asociada al sistema operativo seleccionado.

Cuando se utiliza AWS CloudFormation para crear un clúster, el parámetro de SSM forma parte de la plantilla de lanzamiento de Amazon EC2 para las instancias del grupo de escalado automático. Puede configurar la plantilla para que utilice un parámetro dinámico de Systems Manager a fin de determinar qué AMI optimizada de Amazon ECS debe implementar. Este parámetro garantiza que, cada vez que implemente la pila, se compruebe si hay alguna actualización disponible que deba aplicarse a las instancias de EC2. Para ver un ejemplo de cómo utilizar el parámetro de Systems Manager, consulte Crear un clúster de Amazon ECS con la AMI de Amazon Linux 2023 optimizada para Amazon ECS en la Guía del usuario AWS CloudFormation.

Para recuperar el ID de la AMI, el nombre de la imagen, el sistema operativo, la versión del agente de contenedor, el nombre de la imagen de origen y la versión del tiempo de ejecución de las AMI optimizada para Amazon ECS mediante programación, consulte la API del Parameter Store de Systems Manager. Para obtener más información acerca de la API del Parameter Store de Systems Manager, consulte GetParameters y GetParametersByPath.

nota

La cuenta administrativa debe tener los siguientes permisos de IAM para recuperar los metadatos de la AMI optimizada para Amazon ECS. Estos permisos se han añadido a la política de IAM AmazonECS_FullAccess.

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Formato de los parámetros de Parameter Store de Systems Manager

A continuación, se muestra el formato del nombre del parámetro para cada variante de AMI optimizada para Amazon ECS.

AMI de Linux optimizadas para Amazon ECS

  • Metadatos de AMI de Amazon Linux 2023:

    /aws/service/ecs/optimized-ami/amazon-linux-2023/<version>
  • Metadatos de AMI de Amazon Linux 2023 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/<version>
  • Metadatos de AMI de Amazon Linux 2023 (Neuron):

    /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/<version>
  • Metadatos de AMI de Amazon Linux 2:

    /aws/service/ecs/optimized-ami/amazon-linux-2/<version>
  • Metadatos de AMI de Amazon Linux 2 con kernel 5.10:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/<version>
  • Metadatos de AMI de Amazon Linux 2 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>
  • Metadatos de AMI de Amazon Linux 2 con kernel 5.10 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/<version>
  • Metadatos de la AMI de kernel 5.10 optimizada para GPU de Amazon ECS:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>
  • Metadatos de AMI de Amazon Linux 2 (GPU):

    /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>
  • Metadatos de la AMI de kernel 5.10 de Amazon Linux 2 (Neuron) optimizada para Amazon ECS:

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

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

El siguiente formato de nombre de parámetro recupera el ID de imagen de la última versión estable de la AMI Amazon Linux 2 optimizada para Amazon ECS mediante el parámetro secundario image_id.

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

El siguiente formato de nombre de parámetro recupera los metadatos de una versión específica de la AMI optimizada para Amazon ECS mediante la especificación del nombre de la AMI.

  • Metadatos de AMI de Amazon Linux 2 optimizada para Amazon ECS:

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

Todas las versiones de AMI Amazon Linux 2 optimizadas para Amazon ECS están disponibles para su recuperación. Solo se pueden recuperar las versiones amzn-ami-2017.09.l-amazon-ecs-optimized de AMI (Linux) optimizadas para Amazon ECS y versiones posteriores.

Ejemplos

Los siguientes ejemplos muestran formas en las que pueden recuperar los metadatos de cada variante de AMI optimizada para Amazon ECS.

Recuperación de los metadatos de la AMI optimizada para Amazon ECS estable más reciente

Utilice los siguientes comandos de la AWS CLI para recuperar la AMI optimizada para Amazon ECS estable más reciente mediante la AWS CLI.

AMI de Linux optimizadas para Amazon ECS

  • Para las AMI de Amazon Linux 2023 optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2023 (arm64) optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2023 (Neuron) optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2 con kernel 5.10 optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2 optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2 con kernel 5.10 (arm64) optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2 (arm64) optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region us-east-1
  • Para las AMI de kernel 5.10 optimizadas para GPU de Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/recommended --region us-east-1
  • Para las AMI optimizadas para GPU de Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Para las AMI de kernel 5.10 de Amazon Linux 2 (Neuron) optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region us-east-1
  • Para las AMI de Amazon Linux 2 (Neuron) optimizadas para Amazon ECS:

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

Recuperación del ID de imagen de la AMI de Amazon Linux 2023 optimizada para Amazon ECS más reciente recomendada

Puede recuperar el ID de imagen del ID de la AMI de Amazon Linux 2023 optimizada para Amazon ECS más reciente recomendada mediante el parámetro secundario image_id.

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

Para recuperar solo el valor de image_id, puede consultar el valor de parámetro específico; por ejemplo:

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

Recuperación de los metadatos de una versión específica de AMI de Amazon Linux 2 optimizada para Amazon ECS

Utilice el siguiente comando de la AWS CLI para recuperar los metadatos de una versión específica de AMI de Amazon Linux optimizada para Amazon ECS mediante la AWS CLI. Sustituya el nombre de la AMI por el nombre de la AMI de Amazon Linux optimizada para Amazon ECS que va a recuperar.

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

Recuperación de los metadatos de la AMI de kernel 5.10 de Amazon Linux 2 optimizada para Amazon ECS mediante la API GetParametersByPath de Systems Manager

Utilice el siguiente comando de la AWS CLI para recuperar los metadatos de la AMI de Amazon Linux 2 optimizada para Amazon ECS mediante la API GetParametersByPath de Systems Manager.

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

Recuperación del ID de imagen de la AMI de kernel 5.10 de Amazon Linux 2 optimizada para Amazon ECS más reciente recomendada

Puede recuperar el ID de imagen del ID de la AMI de kernel 5.10 de Amazon Linux 2 optimizada para Amazon ECS más reciente recomendada mediante el parámetro secundario 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

Para recuperar solo el valor de image_id, puede consultar el valor de parámetro específico; por ejemplo:

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

Utilización de la AMI optimizada para Amazon ECS más reciente recomendada en una plantilla de AWS CloudFormation

Para hacer referencia a la AMI optimizada para Amazon ECS recomendada en una plantilla de AWS CloudFormation, pude hacer referencia al nombre del almacén de parámetros de Systems Manager.

Ejemplo de 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