From a161518000b5efedf806d575e0ed82d38dff69d7 Mon Sep 17 00:00:00 2001 From: Asger Gitz-Johansen Date: Mon, 30 Jun 2025 09:48:56 +0200 Subject: [PATCH 1/2] services: add notice of broken feature Waiting for healthy dependencies is not supported in version 3 of docker compose, as explained in: https://docs.docker.com/compose/releases/release-notes/#1100 The `version` key is also ignored now, so this whole feature is actually broken. I think at the very least, this should be mentioned in the documentation. This took me 2 days of debugging to figure out, and a notice here would've saved me a lot of time. --- content/reference/compose-file/services.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/reference/compose-file/services.md b/content/reference/compose-file/services.md index b0696c0eef7..b9a48110f16 100644 --- a/content/reference/compose-file/services.md +++ b/content/reference/compose-file/services.md @@ -451,7 +451,8 @@ expressed in the short form. - `service_started`: An equivalent of the short syntax described previously - `service_healthy`: Specifies that a dependency is expected to be "healthy" (as indicated by [`healthcheck`](#healthcheck)) before starting a dependent - service. + service. Note that since v3 dependent services will be started regardless of the + healthcheck status. - `service_completed_successfully`: Specifies that a dependency is expected to run to successful completion before starting a dependent service. - `required`: When set to `false` Compose only warns you when the dependency service isn't started or available. If it's not defined From 6d15cb8317e428eb041166ad5e75527e02ad6ff6 Mon Sep 17 00:00:00 2001 From: Asger Gitz-Johansen Date: Mon, 30 Jun 2025 10:52:36 +0200 Subject: [PATCH 2/2] fixup! --- content/reference/compose-file/services.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/reference/compose-file/services.md b/content/reference/compose-file/services.md index b9a48110f16..d2af196046f 100644 --- a/content/reference/compose-file/services.md +++ b/content/reference/compose-file/services.md @@ -451,8 +451,8 @@ expressed in the short form. - `service_started`: An equivalent of the short syntax described previously - `service_healthy`: Specifies that a dependency is expected to be "healthy" (as indicated by [`healthcheck`](#healthcheck)) before starting a dependent - service. Note that since v3 dependent services will be started regardless of the - healthcheck status. + service. Note that since v3 dependent services are started immediately + regardless of the healthcheck status. - `service_completed_successfully`: Specifies that a dependency is expected to run to successful completion before starting a dependent service. - `required`: When set to `false` Compose only warns you when the dependency service isn't started or available. If it's not defined