Editing Docker compose

[[wikipedia:Docker_(software)#Tools|Docker Compose]]<ref>https://docs.docker.com/compose/</ref> is a tool available since 2014 for defining and running multi-container Docker applications.

Rules are defined in <code>[[DevOps/Docker/docker compose/Docker compose file: docker-compose.yml|docker-compose.yml]]</code> and executed by running <code>docker-compose up</code>.

<code>docker-compose</code> allows to define start order dependencies between containers.

For reference of valid options for docker compose check: https://docs.docker.com/compose/compose-file/

== Installation ==
* <code>[[macOS/Homebrew|brew]] install docker-compose</code>

== Basic commands ==
* <code>docker-compose -h</code> (for list of commands and options)
* <code>docker-compose up</code>
* <code>docker-compose up -d</code>
:-d daemon
* Start your containers with a command line variable: <code>YOUR_VARIABLE=YOUR_VALUE docker-compose up</code><ref>https://www.oreilly.com/ideas/3-docker-compose-features-for-improving-team-development-workflow</ref>


* <code>docker-compose -p NAME  --project-name</code>

Logs:
* <code>docker-compose logs</code> View output from containers
* <code>docker-compose logs -f</code> View output from containers
* <code>docker-compose pull SERVICE_NAME</code> or <code>docker-compose pull</code>

<code>docker-compose</code><ref>https://docs.docker.com/compose/reference/</ref>
*<code>docker-compose build</code>
*<code>docker-compose bundle</code>
*<code>docker-compose config</code>
*<code>docker-compose create</code>
*<code>docker-compose down</code>
:<code>docker-compose down --remove-orphans</code>
*<code>docker-compose events</code>
*<code>docker-compose exec</code>
*<code>docker-compose help</code>
*<code>docker-compose images</code>
*<code>docker-compose kill</code>
*<code>docker-compose logs</code><ref>https://docs.docker.com/compose/reference/logs/</ref>: <code>docker-compose logs SERVICE_NAME</code> (You will find your SERVICE_NAME looking into your docker-compose.yml file)
*<code>docker-compose pause</code>
*<code>docker-compose port</code>
*<code>docker-compose ps</code>
*<code>docker-compose pull</code><ref>https://docs.docker.com/compose/reference/pull/</ref>.<code>docker-compose pull SERVICE_NAME</code>. Just pull container images but do not start them. To update your image and start your services: <code>docker-compose pull && docker-compose up -d</code>
*<code>docker-compose push</code>
*<code>docker-compose restart</code>
*<code>docker-compose rm</code>
*<code>docker-compose run</code>
*<code>docker-compose scale</code>
*<code>[[/docker-compose start/]]</code>
*<code>docker-compose stop</code>
*<code>[[/docker-compose top/]]</code>
*<code>docker-compose unpause</code>
*<code>docker-compose up</code>

== [[/Docker compose file: docker-compose.yml/]] ==

== Activities ==
=== Basic ===
# Read <code>docker-compose</code> StackOverflow questions: https://stackoverflow.com/questions/tagged/docker-compose?tab=Votes
# Read  <code>docker-compose</code> changelog: https://github.com/docker/compose/blob/master/CHANGELOG.md
# [[/Review docker compose file format evolution/]]

=== Advanced ===
# Read <code>docker-compose</code> source code: https://github.com/docker/compose
# Read [[DevOps/Ansible/Modules|Ansible module]] documentation about <code>docker_compose</code>: https://docs.ansible.com/ansible/latest/modules/docker_compose_module.html
# Learn to use extension-fields<ref>https://docs.docker.com/compose/compose-file/#extension-fields </ref> or templating added in 3.4 version. <ref>https://www.oreilly.com/ideas/3-docker-compose-features-for-improving-team-development-workflow</ref>

== See also ==
* <code>[[docker stack]]</code> and <code>[[docker swarm]]</code> commands
* <code>[[docker start]]</code>
* [[Kubernetes]] [[Pods]]


[[Category:Cloud computing]]
[[Category:Software development]]
[[Category:Server administration]]