The Equinix Metal cloud bare-metal machine driver for Docker.

This repository is Maintained meaning that this software is supported by Equinix Metal and its community - available to use in production environments.

Provision bare-metal hosts by either building and installing this docker-machine driver or downloading the latest prebuilt release asset for your platform. The binaries must be placed in your $PATH.

Test that the installation worked by typing in:

docker-machine create --driver metal

You can find the supported arguments by running docker-machine create -d metal --help (Equinix Metal specific arguments are shown below):

Where denoted, values may be loaded from the environment or from the ~/.config/equinix/metal.yaml file which can be created with the Equinix Metal CLI.

In order to support existing installations, a Packet branded binary is also available with each release (after v0.5.0). When the packet binary is used, all METAL environment variables and metal arguments should be substituted for PACKET and packet, respectively.

This creates the following:

• c3.small.x86 machine
• in the NY metro
• with Ubuntu 20.04
• in project $PROJECT
• Using $API_KEY - get yours from the Portal

$ docker-machine create sloth \
  --driver metal --metal-api-key=$API_KEY --metal-os=ubuntu_20_04 --metal-project-id=$PROJECT --metal-metro-code "ny" --metal-plan "c3.small.x86"

Creating CA: /home/alex/.docker/machine/certs/ca.pem
Creating client certificate: /home/alex/.docker/machine/certs/cert.pem
Running pre-create checks...
Creating machine...
(sloth) Creating SSH key...
(sloth) Provisioning Equinix Metal server...
(sloth) Created device ID $DEVICE, IP address 147.x.x.x
(sloth) Waiting for Provisioning...
Waiting for machine to be running, this may take a few minutes...
Detecting operating system of created instance...
Waiting for SSH to be available...
Detecting the provisioner...
Provisioning with ubuntu(systemd)...
Installing Docker...
Copying certs to the local machine directory...
Copying certs to the remote machine...
Setting Docker configuration on the remote daemon...
Checking connection to Docker...
Docker is up and running!
To see how to connect your Docker Client to the Docker Engine running on this virtual machine, run: docker-machine env sloth

Provision time can take several minutes

At this point you can now docker-machine env sloth and then start using your Docker bare-metal host!

Pre-reqs: docker-machine and make

• Install the Golang SDK https://golang.org/dl/ (at least 1.11 required for modules support

• Download the source-code with git clone http://github.com/equinix/docker-machine-driver-metal.git

• Build and install the driver:

cd docker-machine-driver-metal
make
sudo make install

Now you will now be able to specify a -driver of metal to docker-machine commands.

To monitor the Docker debugging details and the Equinix Metal API calls:

go build
PACKNGO_DEBUG=1 PATH=`pwd`:$PATH docker-machine \
  --debug create -d metal \
  --metal-auth-token=$METAL_AUTH_TOKEN \
  --metal-project-id=$METAL_PROJECT \
  foo

This project adheres to Semantic Versioning.

Releases are handled by GitHub Workflows and goreleaser.

To push a new release, checkout the commit that you want released and: make tag version=v0.2.3. Robots handle the rest.

Maintainers should verify that the release notes convey to users all of the notable changes between releases, in a human readable way. The format for each release should be based on Keep a Changelog.

See https://github.com/equinix/docker-machine-driver-metal/releases for the latest releases, install archives, and the project changelog.