{{tag>sysadmin software docker docker-compose syntaxe}}

====== docker-compose: définition des volumes ======

Attention à la version de docker-compose déclarée en entête. Pour vérifier quelles versions sont utilisables en fonction de la version de Docker consulter la page [[https://docs.docker.com/compose/compose-file/]].

Pour afficher la version du Docker Engine
<code bash>
docker info
</code>

===== Syntaxe courte =====

La syntaxe condensée utilise le format générique
<code>
[SOURCE:]TARGET[:MODE]
</code>

Avec:
  * **SOURCE**: pouvant être un clhemin sur l'hote ou un nom de volume.
  * **TARGET**: Point de montage dans le conteneur.
  * **MODE**: le mode d'accès **rw** (par défaut) ou **ro**

<code YAML>
volumes:
  - $PWD/conf/service.conf:/etc/service.conf:ro
  - my_datavol:/srv/data
</code>

===== Syntaxe longue =====

Cette syntaxe plus explicite et verbeuse n'est disponible qu'à partir des versions 3.2 et supérieures

<code YAML>
version: "3.2" # Syntaxe version 3.2 ou supérieure
services:
  my_service:
    image: my:image
    volumes:
      - type: volume
        source: volume-name
        target: /path/in/container
        read_only: true
volumes:
  volume-name:
</code>


====== Références =====

  * https://docs.docker.com/compose/compose-file/
  * https://stackoverflow.com/questions/19158810/docker-mount-volumes-as-readonly