compose/docs/install/linux.md

Installing the Docker ACI Integration CLI on Linux (Beta)

This CLI adds support for running and managing containers on Azure Container Instances (ACI).

⚠️ This CLI is in beta: The installation process, commands, and flags will change in future releases.

Prerequisites

• Docker 19.03 or later

Install script

You can install the new CLI using the install script:

curl -L https://github.com/docker/aci-integration-beta/releases/download/v0.1.4/install.sh | sh

Manual install

You can download the Docker ACI Integration CLI using the following command:

curl -Lo docker-aci https://github.com/docker/aci-integration-beta/releases/download/v0.1.4/docker-linux-amd64

You will then need to make it executable:

chmod +x docker-aci

To enable using the local Docker Engine and to use existing Docker contexts, you will need to have the existing Docker CLI as com.docker.cli somewhere in your PATH. You can do this by creating a symbolic link from the existing Docker CLI.

ln -s /path/to/existing/docker /directory/in/PATH/com.docker.cli

Note

: The PATH environment variable is a colon separated list of directories with priority from left to right. You can view it using echo $PATH. You can find the path to the existing Docker CLI using which docker. You may need root permissions to make this link.

On a fresh install of Ubuntu 20.04 with Docker Engine already installed:

$ echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin
$ which docker
/usr/bin/docker
$ sudo ln -s /usr/bin/docker /usr/local/bin/com.docker.cli

You can verify that this is working by checking that the new CLI works with the default context:

$ ./docker-aci --context default ps
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
$ echo $?
0

To make this CLI with ACI integration your default Docker CLI, you must move it to a directory in your PATH with higher priority than the existing Docker CLI.

Again on a fresh Ubuntu 20.04:

$ which docker
/usr/bin/docker
$ echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin
$ sudo mv docker-aci /usr/local/bin/docker
$ which docker
/usr/local/bin/docker
$ docker version
...
 Cloud integration  0.1.6
...

Uninstall

To remove this CLI, you need to remove the binary you downloaded and com.docker.cli from your PATH. If you installed using the script, this can be done as follows:

sudo rm /usr/local/bin/docker /usr/local/bin/com.docker.cli