Verify the capacity of the Equinix Metal facility¶
Before deploying an Equinix Metal based Container Cloud cluster with private
networking, ensure that the Equinix Metal project has enough capacity to
deploy the required number of machines. Otherwise, the machines will be stuck
in the Provisioned
state with an error message about no available servers
of particular type in your facility.
To verify the capacity of the Equinix Metal facility:
Warning
Mirantis highly recommends using the c3.small.x86
machine
type for the control plane machines deployed with private network
to prevent hardware issues with incorrect BIOS boot order.
Install the Equinix Metal CLI.
Obtain
USER_API_TOKEN
for the Equinix Metal authentication:Log in to the Equinix Metal console.
Capture the existing API key with the
Read/Write
permissions or create a new one:In Personal Settings > Personal API Keys, click Add New Key.
Fill in the Description and select the Read/Write permissions.
Click Add Key.
Configure the Equinix Metal authentication by exporting the
METAL_AUTH_TOKEN
environment variable. ReplaceUSER_API_TOKEN
with yourUSER_API_TOKEN
:export METAL_AUTH_TOKEN=USER_API_TOKEN
For more details, see Equinix Metal authentication.
Verify the capacity of the Equinix Metal facility selected for the management cluster bootstrap:
metal capacity check --facility $EQUINIX_FACILITY --plan $EQUINIX_MACHINE_TYPE --quantity $MACHINES_AMOUNT
In the command above, replace
$EQUINIX_FACILITY
,$EQUINIX_MACHINE_TYPE
and$MACHINES_AMOUNT
with corresponding values of your cluster.For example, to verify that Equinix Metal can create 6 machines of the
c3.small.x86
type in theam6
facility, run:metal capacity check --facility am6 -P c3.small.x86 --quantity 6
In the system response, verify that the
AVAILABILITY
section has thetrue
value.Example of a positive system response:
+----------+--------------+----------+--------------+ | FACILITY | PLAN | QUANTITY | AVAILABILITY | +----------+--------------+----------+--------------+ | am6 | c3.small.x86 | 6 | true | +----------+--------------+----------+--------------+
Proceed to Bootstrap a management cluster.