Mirantis Container Cloud (MCC) becomes part of Mirantis OpenStack for Kubernetes (MOSK)!

Now, the MOSK documentation set covers all product layers, including MOSK management (formerly Container Cloud). This means everything you need is in one place. Some legacy names may remain in the code and documentation and will be updated in future releases. The separate Container Cloud documentation site will be retired, so please update your bookmarks for continued easy access to the latest content.

Deploy a machine to a specific bare metal host

A machine in a MOSK cluster requires dedicated bare metal host for deployment. In the MOSK management API, bare metal hosts are represented by the BareMetalHost objects that are automatically generated by the related BareMetalHostInventory objects.

Note

BareMetalHost is only used for internal purposes of the MOSK management private API. All configuration changes must be applied using the BareMetalHostInventory objects.

All BareMetalHostInventory objects must be labeled upon creation with a label that allows identifying the host and assigning it to a machine.

The labels may be unique, or applied to a group of hosts, based on similarities in their capacity, capabilities and hardware configuration, on their location, suitable role, or a combination of thereof.

In some cases, you may need to deploy a machine to a specific bare metal host. This is especially useful when some of your bare metal hosts have different hardware configuration than the rest.

To deploy a machine to a specific bare metal host:

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

2. Identify the bare metal host that you want to associate with the specific machine. For example, host host-1.

   kubectl get baremetalhostinventory host-1 -o yaml
   

3. Add a label that will uniquely identify this host, for example, by the name of the host and machine that you want to deploy on it.

   kubectl edit baremetalhostinventory host-1
   
      .. note:: For details about labels, see :ref:`bmhi`.
   

   Configuration example:

   kind: BareMetalHostInventory
   metadata:
     name: host-1
     namespace: myProjectName
     labels:
       kaas.mirantis.com/baremetalhost-id: host-1-worker-HW11-cad5
       ...
   

4. Open the text file with the YAML definition of the Machine object, created in Create a machine using CLI.

5. Add a host selector that matches the label you have added to the BareMetalHost object in the previous step. For example:

   kind: Machine
   metadata:
     name: worker-HW11-cad5
     namespace: myProjectName
   spec:
     ...
     providerSpec:
       value:
         apiVersion: baremetal.k8s.io/v1alpha1
         kind: BareMetalMachineProviderSpec
         ...
         hostSelector:
           matchLabels:
             kaas.mirantis.com/baremetalhost-id: host-1-worker-HW11-cad5
     ...
   

Once created, this machine will be associated with the specified bare metal host, and you can return to Create a machine using CLI.

Caution

The required minimum number of machines:

• 3 manager nodes for HA

• 3 worker storage nodes for a minimal Ceph cluster