Actualización manual del agente de contenedor de Amazon ECS (para AMI no optimizadas para Amazon ECS)

Para actualizar manualmente el agente de contenedor de Amazon ECS (para AMI no optimizadas para Amazon ECS)

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.

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

2. Compruebe si su agente utiliza la variable de entorno ECS_DATADIR para guardar su estado.

   ubuntu:~$ docker inspect ecs-agent | grep ECS_DATADIR

   Salida:

   "ECS_DATADIR=/data",

   importante

   Si el comando anterior no devuelve la variable de entorno ECS_DATADIR, debe detener las tareas en ejecución en esta instancia de contenedor antes de actualizar el agente. Los agentes más recientes con la variable de entorno ECS_DATADIR guardan su estado y usted puede actualizarlos mientras que las tareas se ejecuten sin problemas.

3. Detenga el agente de contenedor de Amazon ECS.

   ubuntu:~$ docker stop ecs-agent

4. Elimine el contenedor de agente.

   ubuntu:~$ docker rm ecs-agent

5. Asegúrese de que el directorio /etc/ecs y el archivo de configuración del agente de contenedor de Amazon ECS existan en /etc/ecs/ecs.config.

   ubuntu:~$ sudo mkdir -p /etc/ecs && sudo touch /etc/ecs/ecs.config

6. Edite el archivo /etc/ecs/ecs.config y asegúrese de que contenga al menos las siguientes declaraciones de variables. Si no desea que su instancias de contenedor se registre en el clúster predeterminado, especifique el nombre del clúster como el valor para ECS_CLUSTER.

   ECS_DATADIR=/data
   ECS_ENABLE_TASK_IAM_ROLE=true
   ECS_ENABLE_TASK_IAM_ROLE_NETWORK_HOST=true
   ECS_LOGFILE=/log/ecs-agent.log
   ECS_AVAILABLE_LOGGING_DRIVERS=["json-file","awslogs"]
   ECS_LOGLEVEL=info
   ECS_CLUSTER=default

   Para obtener más información acerca de estas y otras opciones de tiempo de ejecución de agente, consulte Configuración del agente de contenedor de Amazon ECS.

   nota

   Si lo desea, puede almacenar las variables de entorno del agente en Amazon S3 (se pueden descargar en las instancias de contenedor en el momento del lanzamiento utilizando datos de usuario de Amazon EC2). Se recomienda su uso para información confidencial como las credenciales de autenticación para repositorios privados. Para obtener más información, consulte Almacenamiento de la configuración de instancia de contenedor en Amazon S3 y Autenticación de registros privados para tareas.

7. Extraiga la imagen más reciente del agente de contenedor de Amazon ECS de Amazon Elastic Container Registry Public.

   ubuntu:~$ docker pull public.ecr.aws/ecs/amazon-ecs-agent:latest

   Salida:

   Pulling repository amazon/amazon-ecs-agent
   a5a56a5e13dc: Download complete
   511136ea3c5a: Download complete
   9950b5d678a1: Download complete
   c48ddcf21b63: Download complete
   Status: Image is up to date for amazon/amazon-ecs-agent:latest

8. Ejecute el agente de contenedor de Amazon ECS más reciente en la instancia de contenedor.

   nota

   Utilice las políticas de reinicio de Docker o un administrador de procesos (como upstart o systemd) para tratar al agente de contenedor como un servicio o un daemon y asegurarse de que se reinicie después de finalizar su ejecución. Para obtener más información, consulte Automatically start containers (Iniciar contenedores automáticamente) y Restart policies (Reiniciar políticas) en la documentación de Docker. La AMI optimizada para Amazon ECS utiliza el ecs-init RPM para este fin y puede ver el código fuente de este RPM en. GitHub

   En el siguiente ejemplo, el comando de ejecución del agente está dividido en líneas separadas para mostrar cada opción. Para obtener más información acerca de estas y otras opciones de tiempo de ejecución de agente, consulte Configuración del agente de contenedor de Amazon ECS.

   importante

   Los sistemas operativos con SELinux habilitado requieren la opción --privileged en el comando docker run. Además, para las instancias de contenedor con SELinux habilitado, recomendamos añadir la opción :Z a los montajes de volúmenes /log y /data. No obstante, los montajes de hosts para estos volúmenes deben existir antes de que ejecute el comando; de lo contrario, recibirá un error no such file or directory. Realice la siguiente acción si tiene dificultades para ejecutar el agente de Amazon ECS en una instancia de contenedor con SELinux habilitado:

   • Cree los puntos de montaje de volumen del host en su instancia de contenedor.

     ubuntu:~$ sudo mkdir -p /var/log/ecs /var/lib/ecs/data

   • Añada la opción --privileged al siguiente comando docker run.

   • Añada la opción :Z a los montajes del volumen de contenedor /log y /data (por ejemplo, --volume=/var/log/ecs/:/log:Z) para el siguiente comando docker run.

   ubuntu:~$ sudo docker run --name ecs-agent \
   --detach=true \
   --restart=on-failure:10 \
   --volume=/var/run:/var/run \
   --volume=/var/log/ecs/:/log \
   --volume=/var/lib/ecs/data:/data \
   --volume=/etc/ecs:/etc/ecs \
   --volume=/etc/ecs:/etc/ecs/pki \
   --net=host \
   --env-file=/etc/ecs/ecs.config \
   amazon/amazon-ecs-agent:latest

   nota

   Si recibe el mensaje Error response from daemon: Cannot start container, puede eliminar el contenedor con errores con el comando sudo docker rm ecs-agent e intentar volver a ejecutar el agente.