Montages liés

Avec les montages par liaison, un fichier ou un répertoire sur un hôte, tel qu'une instance Amazon EC2, est monté dans un conteneur. Les montages liés sont pris en charge lorsque vous exécutez des tâches sur des instances Fargate ou Amazon EC2. Les montages de liaison sont liés au cycle de vie du conteneur qui les utilise. Une fois que tous les conteneurs qui utilisent un montage lié sont arrêtés, par exemple lorsqu'une tâche est arrêtée, les données sont supprimées. Pour les tâches hébergées sur des instances Amazon EC2, les données peuvent être liées au cycle de vie de l'instance Amazon EC2 hôte en spécifiant host une valeur sourcePath facultative dans votre définition de tâche. Pour de plus amples informations, veuillez consulter Utilisation de montages liés dans la documentation Docker.

Voici quelques cas d'utilisation courants pour les montages liés.

• Pour fournir un volume de données vide à monter dans un ou plusieurs conteneurs.

• Pour monter un volume de données hôte dans un ou plusieurs conteneurs.

• Pour partager un volume de données d'un conteneur source avec d'autres conteneurs dans la même tâche.

• Pour exposer un chemin d'accès et son contenu d'un fichier Dockerfile à un ou plusieurs conteneurs.

Considérations relatives à l'utilisation des montages liés

Lorsque vous utilisez des montages liés, tenez compte des éléments suivants.

• Pour les tâches hébergées sur AWS Fargate une version de plate-forme 1.4.0 ou ultérieure (Linux) 1.0.0 ou ultérieure (Windows), elles reçoivent par défaut un minimum de 20 GiB de stockage éphémère pour les montages liés. Pour les tâches Linux, la quantité totale de stockage éphémère peut être augmentée, jusqu'à un maximum de 200 Gio, en spécifiant le paramètre ephemeralStorage dans votre définition de tâche. Par défaut, les tâches Amazon ECS Windows sur Fargate utilisant la version de plateforme 1.0.0 ou ultérieure reçoivent un minimum de 20 Gio de stockage éphémère. Vous pouvez augmenter la quantité totale de stockage éphémère jusqu'à un maximum de 200 Gio en spécifiant le paramètre ephemeralStorage dans votre définition de tâche.

• Pour exposer des fichiers d'un fichier Dockerfile à un volume de données lorsqu'une tâche est exécutée, le plan de données Amazon ECS recherche une directive VOLUME. Si le chemin absolu spécifié dans la directive VOLUME est le même que le containerPath spécifié dans la définition de tâche, les données du chemin de directive VOLUME sont copiées sur le volume de données. Dans l'exemple Dockerfile suivant, un fichier nommé examplefile dans le répertoire /var/log/exported est écrit sur l'hôte, puis monté à l'intérieur du conteneur.

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

  Par défaut, les autorisations de volume sont définies sur 0755 et le propriétaire en tant que root. Vous pouvez personnaliser ces autorisations dans le fichier Dockerfile. L'exemple suivant définit le propriétaire du répertoire en tant que 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"]

• Pour les tâches hébergées sur des instances Amazon EC2, lorsque les valeurs host et sourcePath ne sont pas spécifiées, le démon Docker gère le montage lié à votre place. Lorsqu'aucun conteneur ne fait référence à ce montage lié, le service de nettoyage des tâches de l'agent de conteneur Amazon ECS finit par le supprimer. Par défaut, cela se produit trois heures après la sortie du conteneur. Toutefois, vous pouvez configurer cette durée avec la variable de l'agent ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION. Pour plus d’informations, consultez Configuration de l'agent de conteneur Amazon ECS. Si vous avez besoin de conserver ces données au-delà du cycle de vie de conteneur, spécifiez une valeur sourcePath pour le montage lié.