Stack deployment docker compose format

[hholst80]

Bug description

Stack deployment suggests only Docker Compose v2 format is supported. In fact, v1 is also supported.

Expected behavior

Describe that either v2.x and v1 format is supported for Docker Engine endpoints.

[hholst80]

Note that v2 is not backwards compatible with v1 in any meaningful way.

[hhromic]

When using Docker Swarm mode, I think Docker Compose v3 is also supported?

[hholst80]

When using Docker Swarm mode, I think Docker Compose v3 is also supported?

That is true. In fact I think it is the only supported version. But the message might be different there, this bug report is for the docker engine endpoint.

[hhromic]

@hholst80 you are right! the message doesn't appear in Docker Swarm mode:

Nothing to do there then! Thanks for pointing it out.

EDIT: perhaps an "only v3 supported" message should be added for the case of Docker Swarm mode, for consistency with standalone mode and clarity as you actually mention in this issue.

[hholst80]

perhaps an "only v3 supported" message should be added for the case of Docker Swarm mode, for consistency with standalone mode and clarity as you actually mention in this issue.

You could be right. It is fairly well-known that Docker Swarm only supports v3 compose files. However, it does also support something called "bundle files". Are they supported? It is not clear.

[rancher@rancheros ~]$ docker stack deploy hello
Please specify either a bundle file (with --bundle-file) or a Compose file (with --compose-file).
rancher@rancheros ~]$ docker stack deploy hello --compose-file docker-compose.yml
unsupported Compose file version: 1.0
[rancher@rancheros ~]$ vi docker-compose.yml
[rancher@rancheros ~]$ docker stack deploy hello --compose-file docker-compose.yml
unsupported Compose file version: 2