From 3df33772c4b8104bde582a4baea764c7e212e601 Mon Sep 17 00:00:00 2001 From: Guillaume Lours <705411+glours@users.noreply.github.com> Date: Mon, 30 Jun 2025 18:22:54 +0200 Subject: [PATCH 1/2] compose include - add an example using remote Compose file from an OCI artifact Signed-off-by: Guillaume Lours <705411+glours@users.noreply.github.com> --- .../how-tos/multiple-compose-files/include.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/manuals/compose/how-tos/multiple-compose-files/include.md b/content/manuals/compose/how-tos/multiple-compose-files/include.md index a07f0b989139..8b02dc4ea2e5 100644 --- a/content/manuals/compose/how-tos/multiple-compose-files/include.md +++ b/content/manuals/compose/how-tos/multiple-compose-files/include.md @@ -36,6 +36,18 @@ services: This means the team managing `serviceB` can refactor its own database component to introduce additional services without impacting any dependent teams. It also means that the dependent teams don't need to include additional flags on each Compose command they run. +```yaml +include: + - oci://docker.io/username/my-compose-app:latest # use a Compose file stored as an OCI artifact +services: + serviceA: + build: . + depends_on: + - serviceB +``` +`include` allows you to reference to Compose files from remote sources, such as OCI artifacts or Git repositories. +Here `serviceB` is defined in a Compose file stored on Docker Hub. + ## Include and overrides Compose reports an error if any resource from `include` conflicts with resources from the included Compose file. This rule prevents From 7f6058a17a2e594f4d8195e7ca045258aea0fe6f Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Tue, 1 Jul 2025 08:47:23 +0100 Subject: [PATCH 2/2] Update content/manuals/compose/how-tos/multiple-compose-files/include.md --- .../manuals/compose/how-tos/multiple-compose-files/include.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/compose/how-tos/multiple-compose-files/include.md b/content/manuals/compose/how-tos/multiple-compose-files/include.md index 8b02dc4ea2e5..2f0ebc22a6d0 100644 --- a/content/manuals/compose/how-tos/multiple-compose-files/include.md +++ b/content/manuals/compose/how-tos/multiple-compose-files/include.md @@ -45,7 +45,7 @@ services: depends_on: - serviceB ``` -`include` allows you to reference to Compose files from remote sources, such as OCI artifacts or Git repositories. +`include` allows you to reference Compose files from remote sources, such as OCI artifacts or Git repositories. Here `serviceB` is defined in a Compose file stored on Docker Hub. ## Include and overrides