|  | @@ -1,97 +0,0 @@
 | 
	
		
			
				|  |  | -# Installing the Docker ACI Integration CLI on Linux (Beta)
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -This CLI adds support for running and managing containers on Azure Container
 | 
	
		
			
				|  |  | -Instances (ACI).
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -> :warning: **This CLI is in beta**: The installation process, commands, and
 | 
	
		
			
				|  |  | -> flags will change in future releases.
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -## Prerequisites
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -* [Docker 19.03 or later](https://docs.docker.com/get-docker/)
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -## Install script
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -You can install the new CLI using the install script:
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -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:
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -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:
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -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.
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -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](https://docs.docker.com/engine/install/ubuntu/):
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -$ 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:
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -$ ./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:
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -$ 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:
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -```console
 | 
	
		
			
				|  |  | -sudo rm /usr/local/bin/docker /usr/local/bin/com.docker.cli
 | 
	
		
			
				|  |  | -```
 |