Uso de montajes de unión con Amazon ECS - Amazon Elastic Container Service
Consideraciones acerca del uso de los montajes de enlace

Uso de montajes de unión con Amazon ECS

Con los montajes de unión, se monta un archivo o directorio de un host en un contenedor, como, por ejemplo, una instancia de Amazon EC2. Se admiten montajes de enlace para tareas que están alojadas en instancias de Fargate y Amazon EC2. Los montajes de unión están vinculados al ciclo de vida del contenedor que los utiliza. Una vez que se detienen todos los contenedores que utilizan un montaje de enlace, como cuando se detiene una tarea, se eliminan los datos. En el caso de las tareas que están alojadas en instancias de Amazon EC2, para vincular los datos al ciclo de vida de la instancia de Amazon EC2 del host, se puede especificar un host y un valor de sourcePath opcional en la definición de tareas. Para obtener más información, consulte Montajes vinculados en la documentación de Docker.

A continuación, se indican algunos casos de uso comunes de los montajes de enlace.

  • Para proporcionar un volumen de datos vacío y montarlo en uno o más contenedores.

  • Para montar un volumen de datos del host en uno o más contenedores.

  • Para compartir un volumen de datos de un contenedor de origen con otros contenedores de la misma tarea.

  • Para exponer una ruta de acceso y su contenido desde un Dockerfile a uno o más contenedores.

Consideraciones acerca del uso de los montajes de enlace

Al utilizar montajes de enlace, tenga en cuenta lo siguiente.

  • De manera predeterminada, las tareas alojadas en AWS Fargate que utilizan la versión de la plataforma 1.4.0 o una posterior (Linux) o 1.0.0 o una posterior (Windows) reciben un mínimo de 20 GiB de almacenamiento efímero para los montajes de unión. Para aumentar la cantidad total de almacenamiento efímero, hasta un máximo de 200 GiB, indique el parámetro ephemeralStorage en la definición de tareas.

  • Para exponer los archivos de un Dockerfile a un volumen de datos cuando se ejecuta una tarea, el plano de datos de Amazon ECS busca una directiva VOLUME. Si la ruta absoluta especificada en la directiva VOLUME es la misma que la containerPath especificada en la definición de tarea, los datos de la ruta de la directiva VOLUME se copian en el volumen de datos. En el siguiente ejemplo de Dockerfile, un archivo con el nombre examplefile en el directorio /var/log/exported se escribe en el host y, a continuación, se monta dentro del contenedor.

    FROM public.ecr.aws/amazonlinux/amazonlinux:latest
RUN mkdir -p /var/log/exported
RUN touch /var/log/exported/examplefile
VOLUME ["/var/log/exported"]

    De forma predeterminada, los permisos de los volúmenes se establecen en0755 y el propietario como root. Puede personalizar estos permisos en el Dockerfile. En el siguiente ejemplo, se define al propietario del directorio como node.

    FROM public.ecr.aws/amazonlinux/amazonlinux:latest
RUN yum install -y shadow-utils && yum clean all
RUN useradd node
RUN mkdir -p /var/log/exported && chown node:node /var/log/exported
RUN touch /var/log/exported/examplefile
USER node
VOLUME ["/var/log/exported"]

  • Para las tareas que están alojadas en instancias de Amazon EC2, cuando no se especifica el valor de host ni de sourcePath, es el daemon de Docker el que administra el montaje de enlace. Cuando ningún contenedor hace referencia a este montaje de enlace, el servicio de limpieza de tareas del agente de contenedor de Amazon ECS lo elimina finalmente. De forma predeterminada, esto sucede tres horas después de que el contenedor se cierre. Sin embargo, es posible configurar esta duración con la variable de agente ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION. Para obtener más información, consulte Configuración del agente de contenedor de Amazon ECS. Si necesita que estos datos persistan más allá del ciclo de vida del contenedor, especifique un valor de sourcePath para el montaje de enlace.