Uso de montajes de unión con Amazon ECS

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.

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.

En el caso de las tareas alojadas en instancias administradas por Amazon ECS, algunas partes del sistema de archivos del host son de solo lectura. Los montajes de enlace de lectura/escritura deben utilizar directorios que admitan escritura, por ejemplo, /var para datos persistentes o /tmp para datos temporales. Si se intenta crear montajes de enlace de lectura y escritura en otros directorios, la tarea no se podrá iniciar y se producirá un error similar al siguiente:

error creating empty volume: error while creating volume path '/path': mkdir /path: read-only file system

Los montajes de enlace de solo lectura (configurados con "readOnly": true en el parámetro mountPoints) pueden apuntar a cualquier directorio accesible del host.

Para ver una lista completa de rutas que admiten escritura, puede ejecutar una tarea en una instancia administrada por Amazon ECS y utilizarla para inspeccionar la tabla de montaje de la instancia. Cree una definición de tarea con los siguientes ajustes para acceder al sistema de archivos del host:

{
    "pidMode": "host",
    "containerDefinitions": [{
        "privileged": true,
        ...
    }]
}

A continuación, ejecute los siguientes comandos desde dentro del contenedor:

# List writable mounts
cat /proc/1/root/proc/1/mounts | awk '$4 ~ /^rw,/ || $4 == "rw" {print $2}' | sort

# List read-only mounts
cat /proc/1/root/proc/1/mounts | awk '$4 ~ /^ro,/ || $4 == "ro" {print $2}' | sort

Para obtener más información sobre la ejecución de comandos interactivos en contenedores, consulte Supervisión de los contenedores de Amazon ECS con ECS Exec.