'include' documentation should specify applicable version

Question

'include' documentation should specify applicable version

kchawla-pi opened this issue a year ago · comments

Documentation for 'include' in compose file should specify which version of compose file will support this. I wasted hours trying to get it to work with my file (v 3.8) & docker installation (Docker Desktop for Windows v4.20.1)

Guillaume Lours · Answer 1 · Tue Aug 01 2023 02:12:59 GMT+0800 (China Standard Time)

@kchawla-pi the version attribute has been deprecated with the introduction of the Compose specification. Include should support any compose files which respect the Compose specification

Kshitij Chawla · Answer 2 · Tue Aug 01 2023 02:15:04 GMT+0800 (China Standard Time)

Docker version then?

Because I get (root) Additional property include is not allowed.

Jacob Dreesen · Answer 3 · Tue Aug 01 2023 02:54:30 GMT+0800 (China Standard Time)

It's supported in Docker Compose v2.20. Docker Desktop is still on v2.19.

Kshitij Chawla · Answer 4 · Tue Aug 01 2023 03:01:24 GMT+0800 (China Standard Time)

Yes, that's what I am suggesting, that the fact that this is for Compose 2.20 be specified on the page documenting the feature.

…

On Mon, Jul 31, 2023, 14:54 Jacob Dreesen ***@***.***> wrote: It's supported in Docker Compose v2.20 <https://github.com/docker/compose/releases/tag/v2.20.0>. Docker Desktop is still on v2.19. — Reply to this email directly, view it on GitHub <#395 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AB6SXRDZBB42NR72LSRKCXLXS75PDANCNFSM6AAAAAA26TNEHY> . You are receiving this because you were mentioned.Message ID: ***@***.***>

Guillaume Lours · Answer 5 · Tue Aug 01 2023 15:45:27 GMT+0800 (China Standard Time)

@kchawla-pi ok I understand your trouble now.
So I checked the Docker Compose page about include and the version needed is the first thing mentioned.
This repository concerns the definition of the specification, so it should not be coupled to a specific implementation, that's why you won't see any reference to a particular version of product here.