Actualización del agente de contenedor de Amazon ECS en una AMI optimizada para Amazon ECS

Si está utilizando la AMI optimizada para Amazon ECS, dispone de varias opciones para obtener la versión más reciente del agente de contenedor de Amazon ECS (se muestran por orden de recomendación):

• Termine las instancias de contenedor actuales y lance la versión más reciente de la AMI de Amazon Linux 2 optimizada para Amazon ECS (ya sea manualmente o actualizando la configuración de lanzamiento de Auto Scaling con la AMI más reciente). Esto proporciona una instancia de contenedor nueva con las versiones probadas y validadas más recientes de Amazon Linux, Docker, ecs-init y el agente de contenedor de Amazon ECS. Para obtener más información, consulte AMI optimizada para Amazon ECS.

• Conecte a la instancia con SSH y actualice el paquete ecs-init (y sus dependencias) a la versión más reciente. Esta operación ofrece las versiones probadas y validadas más recientes de Docker y ecs-init que están disponibles en los repositorios de Amazon Linux, así como la versión más reciente del agente de contenedor de Amazon ECS. Para obtener más información, consulte Para actualizar el paquete ecs-init en la AMI optimizada para Amazon ECS.

• Actualice el agente contenedor con la operación de la UpdateContainerAgent API, ya sea a través de la consola AWS CLI o con AWS los SDK. Para obtener más información, consulte Actualización del agente de contenedor de Amazon ECS mediante la operación de la API UpdateContainerAgent.

nota

Las actualizaciones del agente no se aplican a instancias de contenedor de Windows. Le recomendamos que lance nuevas instancias de contenedor para actualizar la versión del agente en sus clústeres Windows.

Para actualizar el paquete ecs-init en la AMI optimizada para Amazon ECS

1. Inicie sesión en su instancia de contenedor mediante SSH.

2. Actualice el paquete ecs-init con el siguiente comando.

   sudo yum update -y ecs-init

   nota

   El paquete ecs-init y el agente de contenedor de Amazon ECS se actualizan de forma inmediata. Sin embargo, las versiones más recientes de Docker no se cargan hasta que se reinicia el daemon de Docker. Para efectuar el reinicio, puede reiniciar la instancia o ejecutar los siguientes comandos en su instancia:

   • AMI de Amazon Linux 2 optimizada para Amazon ECS:

     sudo systemctl restart docker

   • AMI de Amazon Linux optimizada para Amazon ECS:

     sudo service docker restart && sudo start ecs

Actualización del agente de contenedor de Amazon ECS mediante la operación de la API UpdateContainerAgent

importante

La API UpdateContainerAgent solo se admite en variantes de Linux de la AMI optimizada para Amazon ECS, a excepción de la AMI de Amazon Linux 2 (arm64) optimizada para Amazon ECS. Para instancias de contenedor que utilizan la AMI de Amazon Linux 2 (arm64) optimizada para Amazon ECS, actualice el paquete ecs-init para actualizar el agente. Para instancias de contenedor que están ejecutando otros sistemas operativos, consulte Actualización manual del agente de contenedor de Amazon ECS (para AMI no optimizadas para Amazon ECS). Si utiliza instancias de contenedor de Windows, le recomendamos que lance nuevas instancias de contenedor para actualizar la versión del agente en los clústeres Windows.

El proceso de la UpdateContainerAgent API comienza cuando solicitas una actualización del agente, ya sea a través de la consola o con los AWS CLI AWS SDK. Amazon ECS compara la versión actual del agente con la versión del agente más reciente disponible y, si es posible una actualización, el proceso de actualización progresa como se muestra en el diagrama que se incluye a continuación. Si no es posible una actualización, por ejemplo, si el agente ya está ejecutando la versión más reciente, se devuelve NoUpdateAvailableException.

Las fases en el proceso de actualización mostradas más arriba son las siguientes:

PENDING

Hay una actualización de agente disponible y el proceso de actualización se ha iniciado.

STAGING

El agente ha comenzado a descargar la actualización del agente. Si el agente no puede descargar la actualización o si el contenido de la actualización es incorrecto o está dañada, entonces el agente envía una notificación del error y la actualización pasa al estado FAILED.

STAGED

La descarga del agente se ha completado y se ha verificado el contenido del agente.

UPDATING

El servicio ecs-init se reinicia y recoge la nueva versión del agente. Si, por alguna razón, el agente no puede reiniciarse, la actualización pasa al estado FAILED; de lo contrario, el agente indica a Amazon ECS que la actualización está completa.

nota

Las actualizaciones del agente no se aplican a instancias de contenedor de Windows. Le recomendamos que lance nuevas instancias de contenedor para actualizar la versión del agente en sus clústeres Windows.

Para actualizar el agente de contenedor de Amazon ECS en una AMI optimizada para Amazon ECS desde la consola

1. Abra la consola en https://console.aws.amazon.com/ecs/v2.

2. En la barra de navegación, elija la región en la que se encuentra registrada la instancia externa.

3. En el panel de navegación, elija Clusters y seleccione el clúster.

4. En la página de Cluster : name (Clúster; nombre), elija la pestaña Infrastructure (Infraestructura).

5. En Instancias de contenedor, seleccione las instancias que desea actualizar y, a continuación, elija Acciones, Actualización del agente.