Add a bare metal host using CLI¶

After you create a managed cluster as described in Create a managed cluster, proceed with adding bare metal hosts using the Mirantis Container Cloud CLI using the instruction below.

To add a bare metal host using API:

1. Log in to the host where your management cluster kubeconfig is located and where kubectl is installed.

2. Create a secret YAML file that describes the credentials of the new bare metal host.

   Example of the bare metal host secret:

   apiVersion: v1
   data:
     password: <credentials-password>
     username: <credentials-user-name>
   kind: Secret
   metadata:
     labels:
       kaas.mirantis.com/credentials: "true"
       kaas.mirantis.com/provider: baremetal
       kaas.mirantis.com/region: region-one
     name: <credentials-name>
     namespace: <managed-cluster-project-name>
   type: Opaque
   

   In the data section, add the IPMI user name and password in the base64 encoding to access the BMC. To obtain the base64-encoded credentials, you can use the following command in your Linux console:

   echo -n <username|password> | base64
   

3. Apply this secret YAML file to your deployment:

   kubectl apply -f ${<bmh-cred-file-name>}.yaml
   

4. Create a YAML file that contains a description of the new bare metal host.

   Example of the bare metal host configuration file with the worker role:

   apiVersion: metal3.io/v1alpha1
   kind: BareMetalHost
   metadata:
     labels:
       kaas.mirantis.com/baremetalhost-id: <unique-bare-metal-host-hardware-node-id>
       hostlabel.bm.kaas.mirantis.com/worker: "true"
       kaas.mirantis.com/provider: baremetal
       kaas.mirantis.com/region: region-one
     name: <bare-metal-host-unique-name>
     namespace: <managed-cluster-project-name>
   spec:
     bmc:
       address: <ip_address_for-bmc-access>
       credentialsName: <credentials-name>
     bootMACAddress: <bare-metal-host-boot-mac-address>
     online: true
   

   For a detailed fields description, see BareMetalHost.

5. Apply this configuration YAML file to your deployment:

   kubectl apply -f ${<bare-metal-host-config-file-name>}.yaml
   

Now, proceed with Deploy a machine to a specific bare metal host.