compose/get-started-linux.md at c0c31de0c8fd72b6b7bd69cbcbb9d3051d4ce2d7

2.1 KiB

Raw Blame History

Getting Started with Docker AWS ECS Plugin Beta on Linux

The beta release of AWS ECS support for the Docker CLI is shipped as a CLI plugin. Later releases will be included as part of the Docker CLI.

This plugin is included as part of Docker Desktop on Windows and macOS but on Linux it needs to be installed manually.

Prerequisites

Docker 19.03 or later

Step by step install

Download

You can download the Docker ECS plugin from this repository using the following command:

$ curl -L http://xxx | tar xzf -

You will then need to make it executable:

$ chmod +x docker-ecs

Plugin install

In order for the Docker CLI to use the downloaded plugin, you will need to move it to the right place:

$ mkdir -p /usr/local/lib/docker/cli-plugins

$ mv docker-ecs /usr/local/lib/docker/cli-plugins/

You can put the CLI plugin into any of the following directories:

/usr/local/lib/docker/cli-plugins
/usr/local/libexec/docker/cli-plugins
/usr/lib/docker/cli-plugins
/usr/libexec/docker/cli-plugins

Finally you need to enable the experimental features on the CLI. This can be done by setting the environment variable DOCKER_CLI_EXPERIMENTAL=enabled or by setting experimental to "enabled" in your Docker config found at ~/.docker/config.json:

$ export DOCKER_CLI_EXPERIMENTAL=enabled

$ DOCKER_CLI_EXPERIMENTAL=enabled docker help

$ cat ~/.docker/config.json
{
  "experimental" : "enabled",
  "auths" : {
    "https://index.docker.io/v1/" : {

    }
  }
}

To verify the CLI plugin installation, you can check that it appears in the CLI help output or by outputting the plugin version:

$ docker help | grep ecs
  ecs*        Docker ECS (Docker Inc., 0.0.1)

$ docker ecs version
Docker ECS plugin 0.0.1

You are now ready to start deploying to ECS

2.1 KiB Raw Blame History