Skip to content

Provision Machines on Equinix Metal

Equinix Metal is a bare metal cloud service offering a variety machines in different regions in combination with advanced connectivity and storage configurations.

Prerequisites

  1. Create an Equinix Metal account
  2. Make sure the machine's outbound network connectivity towards *.meltcloud.io is allowed. By default, allInternet egress is possible, so nothing to do.
  3. If required, you can customize networking and other Equinix Metal features according to the docs
  4. Create an Enrollment Image using the disk path /dev/sda (that's what equinix metal uses)
  5. Note down the contents of the displayed iPXE Script.

Deploy a Bare Metal Server

First, make sure Metal CLI is installed.

Create an API Token for Equinix Metal and initialize the CLI environment:

shell
# initialize metal CLI
metal init

Save the contents of the iPXE script from the console to a file:

shell
vi script.ipxe # enter the script from the console, for example:

#!ipxe
sanboot https://app.meltcloud.io/enroll/8/.../amd64.iso

Create a new machine:

shell
metal device create \
  --project-id <project-uuid> \ 
  --plan c3.small.x86 \
  --metro fr \
  --hostname melt-equinix \
  --operating-system custom_ipxe \
  --always-pxe \
  --billing-cycle hourly \
  --userdata-file script.ipxe

After some minutes, your Equinix Metal machine will be registered under Machines in the meltcloud console.

To check the state of your Equinix Metal deployment, simply type:

shell
metal device get

Assign the machine to the designed machine pool as described here to turn it into a worker node.