Docker.github.io: ECS & ACI Documentation lacks instructions to enable Experimental features

[mjpowersjr]

Problem description

Documentation for both Amazon ECS & Azure ACI integration is missing step to properly setup for a Linux environment. I suspect this only impacts Linux, not Docker Desktop for Mac / Windows - but that is just an assumption.

The ECS documentation states you need the following requirements (emphasis mine):

---

Install the Docker Compose CLI on Linux

The Docker Compose CLI adds support for running and managing containers on ECS.

Install Prerequisites

Docker 19.03 or later

---

I did verify I had the latest release of both Docker & Docker Compose installed (see version information below).

If you follow the instructions for Linux, and you attempt to create a new context - the following error occurs:

mike@XPS-13-9360:~/projects/otel-collector$ docker context create ecs staging
"docker context create" requires exactly 1 argument.
See 'docker context create --help'.

Usage:  docker context create [OPTIONS] CONTEXT

Create a context

In troubleshooting the problem, I found someone else who put in a ticket regarding this. I don't think the user's problem was well understood, as the ticket seems to have been closed without actually solving the underling problem.

https://github.com/docker/compose-cli/issues/847

It turns out, with the latest released version of the Docker CLI for Linux, you must enable experimental feature support in order to successfully create a ECS context.

To resolve the problem, I did the following:

1. Configured experimental support

https://github.com/docker/cli/blob/master/experimental/README.md

1. Restarted Docker Daemon

sudo systemctl restart docker

After this change, I was able to successfully create a ECS context:

mike@XPS-13-9360:~/projects/otel-collector$ docker context create ecs staging
? Create a Docker context using:  [Use arrows to move, type to filter]
> An existing AWS profile
  AWS secret and token credentials
  AWS environment variables

Problem location

I couldn't find the information I wanted. I expected to find it near the following URL:

• https://docs.docker.com/engine/context/ecs-integration
• https://docs.docker.com/engine/context/aci-integration/

Project version(s) affected

mike@XPS-13-9360:~$ docker --version
Docker version 19.03.14, build 5eb3275d40

mike@XPS-13-9360:~$ docker-compose --version
docker-compose version 1.23.2, build 1110ad01

Suggestions for a fix

Please consider adding information about enabling experimental features within the documentation.

[jleclanche]

Is there anything else than enabling experimental mode in both the server and client required for docker context create ecs … to work?
I am going crazy. I got it to work locally but now I'm trying to make it work on Gitlab CI, and, well:

Experimental: true on both client and server…

[dumar]

Same problem here with Azure, experimental features enabled. Version: 20.10.1 on Linux

docker context create aci azureaci
"docker context create" requires exactly 1 argument.
See 'docker context create --help'.

Usage:  docker context create [OPTIONS] CONTEXT

Create a context

[bmilesp]

Same error for me on Ubuntu 20.04, with {"experimental": true} set:

[belvederef]

The issue is still here on Linux with Docker version 20.10.5, regardless of the experimental flag

[shoeb-a-sabur]

Anyone still having this issue, the solution here worked: https://github.com/docker/docker.github.io/issues/11949#issuecomment-778178431

Please make sure to reload your current shell session by closing/restarting all shell windows.