Docker Machine Driver of Aliyun ECS

Create machines on Aliyun Elastic Compute Service (ECS). You will need an Access Key ID, Secret Access Key and a Region ID. If you want to setup instance on the VPC network, you will need the VPC ID and VSwitch ID; Please login to the Aliyun console -> Products and Services -> VPC and select the one where you would like to launch the instance.

creates docker instances on Aliyun ECS.

docker-machine create -d aliyunecs machine-aliyunecs

Installation

The easiest way to install the aliyun docker-machine driver is to:

go get github.com/AliyunContainerService/docker-machine-driver-aliyunecs

binaries also available,you can download from below links:

• Mac OSX 64 bit: docker-machine-driver-aliyunecs_darwin-amd64

• Linux 64 bit: docker-machine-driver-aliyunecs_linux-amd64

• Windows 64 bit: docker-machine-driver-aliyunecs_windows-amd64

How to install docker-machine-driver-aliyunecs binary packages on different platforms.

• Download the binary package for the corresponding platform. We currently support Windows, Linux, and MAC platforms

• Extract the donload package

  eg. Take the Mac platform for example

   	tar zxvf docker-machine-driver-aliyunecs_darwin-amd64.tgz
  

• Rename the executable

   #Windows
   docker-machine-driver-aliyunecs.windows-amd64 => docker-machine-driver-aliyunecs.exe
   
   #Linux
   docker-machine-driver-aliyunecs.linux-amd64 => docker-machine-driver-aliyunecs
   
   #Mac
   docker-machine-driver-aliyunecs.darwin-amd64 => docker-machine-driver-aliyunecs
  

• Add docker-machine driver to the environment variables.

   export PATH=<Your Local Path>/docker-machine-driver-aliyunecs[.exe]:$PATH
  
  

Example Usage

eg. Export your credentials into your shell environment

export ECS_ACCESS_KEY_ID='<Your access key ID>'
export ECS_ACCESS_KEY_SECRET='<Your secret access key>'
export ECS_REGION='<Your region>'

# Using mirrors from Aliyun
export MACHINE_DOCKER_INSTALL_URL=http://kubernetes.oss-cn-hangzhou.aliyuncs.com/docker_install.sh
export ENGINE_REGISTRY_MIRROR=https://registry.docker-cn.com

docker-machine create -d aliyunecs <machine-name>

or pass as cmdline flags

docker-machine create -d aliyunecs --aliyunecs-access-key-id=<Your access key ID for the Aliyun ECS API> --aliyunecs-access-key-secret=<Your secret access key for the Aliyun ECS API>  --aliyunecs-region=<Region> <machine-name>

Examples

using SSH key pair

docker-machine create -d aliyunecs --aliyunecs-ssh-keypair test_keypair --aliyunecs-ssh-keypath ~/.ssh/id_rsa test

custom docker engine config

docker-machine create -d aliyunecs --engine-storage-driver overlay2 test

custom OS config

docker-machine create -d aliyunecs --aliyunecs-image-id centos_7_04_64_20G_alibase_201701015.vhd test

attach data disk for Docker containers

docker-machine create -d aliyunecs --engine-storage-driver overlay2 --aliyunecs-disk-size 40 --aliyunecs-disk-fs xfs test

Options

docker-machine create -d aliyunecs --help

Environment variables and default values:

Each environment variable may be overloaded by its option equivalent at runtime.

OS

The default OS is Ubuntu 16.04, and you can select your preferred image-id

Hacking

Get the sources

go get github.com/AliyunContainerService/docker-machine-driver-aliyunecs
cd $GOPATH/src/github.com/AliyunContainerService/docker-machine-driver-aliyunecs

Test the driver

To test the driver make sure your current build directory has the highest priority in your $PATH so that docker-machine can find it.

export PATH=$GOPATH/src/github.com/AliyunContainerService/docker-machine-driver-aliyunecs:$PATH

Related links

• Docker Machine: https://docs.docker.com/machine/
• Contribute: https://github.com/AliyunContainerService/docker-machine-driver-aliyunecs
• Report bugs: https://github.com/AliyunContainerService/docker-machine-driver-aliyunecs/issues

License

Apache 2.0