docker-machine-driver-cloudscale

cloudscale.ch Docker machine driver

This library adds the support for creating Docker machines hosted on the the cloudscale.ch IaaS platform.

You need to create a read/write API token under My Account > API Tokens in the cloudscale.ch Control Panel and pass it to docker-machine create as the --cloudscale-token option.

Installation

You can find sources and pre-compiled binaries here.

# Download the binary (this example downloads the binary for linux amd64)
$ wget https://github.com/cloudscale-ch/docker-machine-driver-cloudscale/releases/download/v1.0.0-rc2/docker-machine-driver-cloudscale_v1.0.0-rc2_linux_amd64.tar.gz
$ tar xzvf docker-machine-driver-cloudscale_v1.0.0-rc2_linux_amd64.tar.gz

# Make it executable and copy the binary in a directory accessible with your $PATH
$ chmod +x docker-machine-driver-cloudscale
$ cp docker-machine-driver-cloudscale /usr/local/bin/

Usage

$ docker-machine create \
  --driver cloudscale \
  --cloudscale-token=... \
  --cloudscale-image=ubuntu-18.04 \
  --cloudscale-flavor=flex-4
  some-machine

See docker-machine create --driver cloudscale --help for a complete list of all supported options.

Using environment variables

$ CLOUDSCALE_TOKEN=... \
  && CLOUDSCALE_IMAGE=ubuntu-18.04 \
  && CLOUDSCALE_FLAVOR=flex-4
  && docker-machine create \
     --driver cloudscale \
     some-machine

See docker-machine create --driver cloudscale --help for a complete list of all supported environment variables.

Using Cloud-init

$ cat <<EOF > /tmp/my-user-data.yaml
#cloud-config
write_files:
  - path: /test.txt
    content: |
      Here is a line.
      Another line is here.
EOF

$ docker-machine create \
  --driver cloudscale \
  --cloudscale-token=... \
  --cloudscale-userdata=/tmp/my-user-data.yaml \
  some-machine

Options

• --cloudscale-token: required. Your project-specific access token for the cloudscale.ch API.
• --cloudscale-image: The slug of the cloudscale.ch image to use, see Images API for how to get a list (defaults to ubuntu-18.04).
• --cloudscale-flavor: The flavor of the cloudscale.ch server, see Flavor API for how to get a list (defaults to flex-4).
• --cloudscale-volume-size-gb: The size of the root volume in GB (defaults to 10 10).
• --cloudscale-ssh-user: The SSH User (defaults to root).
• --cloudscale-ssh-port: The SSH Port (defaults to 22).
• --cloudscale-use-private-network: Enables the Private network Interface (defaults to false).
• --cloudscale-use-ipv6: Enables IPv6 on Public Network Interface (defaults to false).
• --cloudscale-server-groups: the UUIDs of server groups identifying the server groups to which the new server will be added.
• --cloudscale-anti-affinity-with: the UUID of another server to create an anti-affinity group with that server or add it to the same group as that server.
• --cloudscale-userdata: path to file with cloud-init user-data

Building from source

Use an up-to-date version of Go.

To use the driver, you can download the sources and build it locally:

# Enable Go Modules if you are not outside of your $GOPATH
$ export GO111MODULE=on
 
# Get sources and build the binary at ~/go/bin/docker-machine-driver-cloudscale
$ go get github.com/cloudscale-ch/docker-machine-driver-cloudscale

# Make the binary accessible to docker-machine
$ export GOPATH=$(go env GOPATH)
$ export GOBIN=$GOPATH/bin
$ export PATH="$PATH:$GOBIN"
$ cd $GOPATH/src/github.com/cloudscale-ch/docker-machine-driver-cloudscale
$ go build -o docker-machine-driver-cloudscale
$ cp docker-machine-driver-cloudscale $GOBIN

Development

Fork this repository, yielding github.com/<yourAccount>/docker-machine-driver-cloudscale.

# Get the sources of your fork and build it locally
$ go get github.com/<yourAccount>/docker-machine-driver-cloudscale

# * This integrates your fork into the $GOPATH (typically pointing at ~/go)
# * Your sources are at $GOPATH/src/github.com/<yourAccount>/docker-machine-driver-cloudscale
# * That folder is a local Git repository. You can pull, commit and push from there.
# * The binary will typically be at $GOPATH/bin/docker-machine-driver-cloudscale
# * In the source directory $GOPATH/src/github.com/<yourAccount>/docker-machine-driver-cloudscale
#   you may use go get to re-build the binary.
# * Note: when you build the driver from different repositories, e.g. from your fork
#   as well as github.com/cloudscale-ch/docker-machine-driver-cloudscale,
#   the binary files generated by these builds are all called the same
#   and will hence override each other.

# Make the binary accessible to docker-machine
$ export GOPATH=$(go env GOPATH)
$ export GOBIN=$GOPATH/bin
$ export PATH="$PATH:$GOBIN"

# Make docker-machine output help including cloudscale-specific options
$ docker-machine create --driver cloudscale --help

Credits

This driver is based on the great work of:

• JonasProgrammer for docker-machine-driver-hetzner
• splattner from Puzzle ITC