Quelle est la différence entre un fichier de pile et un fichier Compose ?

Question

J'apprends à utiliser Docker Compose pour déployer des applications dans plusieurs conteneurs, sur plusieurs hôtes. Et je suis tombé sur deux fichiers de configuration - le fichier stack et le fichier Compose.

De la Référence YAML du fichier de la pile du nuage Elle stipule un fichier de pile est un fichier au format YAML qui définit un ou plusieurs services, de manière similaire à une docker-compose.yml mais avec quelques extensions.

Et de ce poste il indique que les piles sont très similaires à docker-compose, sauf qu'elles définissent des services alors que docker-compose définit des conteneurs .

Ils se ressemblent beaucoup, et je me demande donc quand utiliser le fichier stack et quand utiliser le fichier Compose ?

Answer 1

D'un point de vue conceptuel, les deux fichiers ont le même objectif : le déploiement et la configuration de vos conteneurs sur les moteurs Docker.

L'outil Docker-compose a été créé en premier et son but est "de définir et d'exécuter des applications Docker multi-conteneurs" sur un seul moteur Docker. (voir aperçu de docker compose )

Vous utilisez docker-compose up pour créer/mettre à jour vos conteneurs, réseaux, volumes, etc.

Où Pile Docker est utilisé dans Docker Swarm (l'outil d'orchestration et de planification de Docker) et, par conséquent, il possède des paramètres de configuration supplémentaires (c'est-à-dire répliques, déploiement, rôles) qui ne sont pas nécessaires sur un moteur Docker unique.

Le fichier de pile est interprété par docker stack commande. Cette commande ne peut être invoquée qu'à partir d'un gestionnaire d'essaims Docker.

Vous pouvez convertir docker-compose.yml en docker-cloud.yml et inversement. Cependant, comme indiqué dans votre question, vous devez faire attention aux différences. De plus, vous devez garder à l'esprit qu'il existe différentes versions pour docker-compose. Actuellement, la dernière version est la version 3. ( https://docs.docker.com/compose/compose-file/ )

Edit : Un blog intéressant, qui pourrait aider à comprendre les différences, peut être trouvé ici https://blog.nimbleci.com/2016/09/14/docker-stacks-and-why-we-need-them/

Answer 2

Nota: La question suppose que la référence Docker Cloud est la référence pour comprendre stack, et elle est utile, mais ce n'est pas la source qui fait autorité sur stack vs compose -- il s'agit plutôt d'un guide spécifique au service hébergé de Docker : "Docker Cloud fournit un service de registre hébergé avec des facilités de construction et de test." Pour la documentation sur les fichiers, voir le Format du fichier de composition version 3 -- Bien qu'il soit nommé "Compose", c'est l'endroit qui fait autorité pour savoir quelles fonctionnalités fonctionnent à la fois avec compose et swarm/stack, et comment.

Vous pouvez spécifier un groupe de conteneurs Docker à configurer et à déployer de deux manières :

1. Docker compose ( docker-compose up )
2. Essaim de Docker ( docker swarm init; docker stack deploy --compose-file docker-stack.yml mystack )

Les deux prennent un fichier YAML écrit dans le fichier Docker Format du fichier de composition version 3 . Cette référence est la principale source documentant la configuration de docker-compose et de docker swarm/stack.

Cependant, il existe des différences spécifiques entre ce que vous pouvez faire dans les deux fichiers yml -- des options spécifiques, et des conventions de nommage spécifiques :

Options

Les options de configuration de service disponibles sont documentées sur le site Web de la Commission européenne. Composer la référence du fichier généralement avec une note au bas de l'entrée d'une option décrivant celle-ci comme ignorée soit par docker stack deploy ou par docker-compose up .

Par exemple, les options suivantes sont ignorée lors du déploiement d'une pile en mode essaimage avec un fichier Compose (version 3) :

build, cap_add, cap_drop, cgroup_parent, container_name, depends_on, devices, external_links, links, network_mode, restart, security_opt, stop_signal, sysctls, tmpfs (version 3-3.5), userns_mode

...alors que certaines options sont ignorées par docker-compose tout en travaillant avec docker stack deploy comme :

déployer, politique de redémarrage

Lorsqu'il est exécuté à partir de la ligne de commande, docker stack deploy affichera des avertissements sur les options qu'il ignore :

Ignorer les options non prises en charge : liens

Nommage des fichiers

• Pour docker-compose up le nom de fichier par défaut est docker-compose.yml si aucun nom de fichier alternatif n'est spécifié en utilisant -f (voir le composer la référence ). Il est courant d'utiliser ce nom par défaut et d'exécuter la commande sans argument.

• Pour docker stack deploy il n'y a pas de fichier par défaut donné dans le référence de déploiement de la pile docker . Vous pouvez utiliser le nom que vous voulez, mais voici trois conventions :

  1. utiliser docker-stack.yml tel qu'il est utilisé dans le manuel officiel Docker for Beginners Ch.3 : Déploiement d'une application dans un essaim .
  2. utiliser docker-cloud.yml tel qu'utilisé dans le Référence YML pour Docker Cloud Stack pour le service Docker Cloud.
  3. utiliser docker-compose.yml -- l'ancien nom par défaut du format de fichier Compose.