Skip to content

opentelekomcloud/docker-machine-opentelekomcloud

Repository files navigation

OpenTelekomCloud Docker Machine driver

Zuul Gate Go Report Card GitHub

OpenTelekomCloud driver for docker-machine

Comparing with other drivers

There are two more options of docker-machine driver suitable for usage with OpenTelekomCloud:

Feature OTC (new) OTC (old) Openstack
Automated creation of required infrastructure Yes No No
Support of clouds.yaml and OS_CLOUD Yes No No
Support using of resource names instead of IDs Yes No Yes
User data injection Yes No Yes
Elastic (floating) IP pool selection No No Yes
Custom CA usage Yes No Yes
Insecure mode (without TLS certificate check) No No Yes
Bandwidth configuration Yes Yes No
Root volume configuration Yes Yes No
Optional usage of elastic IP Yes Yes No
AK/SK auth Yes Yes No
Server group Yes No No
Security group(s) Multiple Single Multiple
Instance Tags Multiple No No
Rancher integration Needs setup Built-in Built-in

Installation

Driver can be installed several ways

From source code

(Requires Go 1.13+, gcc and make installed)

  1. Clone this git repository to any location
  2. Run make build && sudo make install, driver for linux will be built and copied to /usr/local/bin

Using built binary

An already built driver for both Linux and Windows distributions can be found in releases section.

You will have to copy driver to directory in $PATH so docker-machine would be able to find it.

Usage

docker-machine-opentelekomcloud can be used either as Rancher node driver or as stand-alone Docker Machine driver.

Stand-alone

OpenTelekomCloud driver processes existing clouds.yaml files to authenticate in OTC.

Having otc cloud in your clouds.yaml, creating of docker-machine is as easy as running.

$ docker-machine create -d otc --otc-cloud otc default

Following will be created if not provided:

  • Security Group: docker-machine-grp
  • VPC: vpc-docker-machine
  • Subnet: subnet-docker-machine
  • Elastic IP: with bandwidth limited to 100 MBit/s

Machine with following setup will be started:

  • Flavor: s3.xlarge.2
  • Image: Standard_Ubuntu_20.04_latest
  • Volume Size: 40 GB
  • Volume Type: SSD

Removing machine will remove all resources created on machine creation.

Supported options

For versions v0.3.x see supported-options.

For versions v0.2.x see supported-options.

Please note that only v0.2.x support old flags and targets to provide full backward compatibility with DockerMachineDriver4OTC. In versions v0.3.+ duplicating options were removed and all environment variables are prefixed with OS_.

With Rancher

See Rancher integration.