Docker Compose Modularity with `include`

Announcements
1

With include support in the latest Compose 2.20 version, Docker Compose makes it easier to modularize complex applications into sub-compose files. This capability allows application configuration to be simpler and more explicit. It also helps to reflect the engineering team responsible for the code in the config file organization. With each team able to reflect in configuration the way it depends on other’s work, there’s a natural approach to compose.yaml files organization.

include:

../database/compose.yaml

services:

webapp:

depends_on:

- database

Learn More: Docker Compose Modularity with `include` | Docker

2

Here’s a simple example:

Demonstrating the power of Compose Include

Pre-requisite

  • Install Docker Compose v2.20.x
  wget https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-linux-x86_64
  mv docker-compose-linux-x86_64 docker-compose
  chmod +x docker-compose

  docker-compose version
  Docker Compose version v2.20.2

Getting Started

Clone the repository

 git clone https://github.com/ajeetraina/compose-include/
 cd compose-include

Run the Services

 docker-compose -f web.yaml up

docker-compose -f web.yaml ps 
NAME                IMAGE               COMMAND                  SERVICE             CREATED             STATUS              PORTS
root-database-1     postgres:12         "docker-entrypoint.s…"   database            10 minutes ago      Up 2 minutes        5432/tcp
root-web-1          nginx:latest        "/docker-entrypoint.…"   web                 10 minutes ago