docs: Add Linux install instructions

Signed-off-by: Christopher Crone <christopher.crone@docker.com>
Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
This commit is contained in:
Christopher Crone 2020-06-09 13:51:46 +02:00 committed by Nicolas De Loof
parent f192904d42
commit 2ab64ea10e
No known key found for this signature in database
GPG Key ID: 9858809D6F8F6E7E
1 changed files with 84 additions and 0 deletions

View File

@ -0,0 +1,84 @@
Getting Started with Docker AWS ECS Plugin Beta on Linux
--------------------------------------------------------
The beta release of [AWS ECS](https://aws.amazon.com/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](https://docs.docker.com/get-docker/)
## Step by step install
### Download
You can download the Docker ECS plugin from this repository using the following
command:
<!-- FIXME(chris-crone): get real download link -->
```console
$ curl -L http://xxx | tar xzf -
```
You will then need to make it executable:
```console
$ 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:
```console
$ 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`:
```console
$ 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:
```console
$ docker help | grep ecs
ecs* Docker ECS (Docker Inc., 0.0.1)
$ docker ecs version
Docker ECS plugin 0.0.1
```
<!-- FIXME(chris-crone): Link to ECS docs -->
You are now ready to [start deploying to ECS](http://xxx)