Add a machine

Add a machine

After you create a new OpenStack-based Mirantis Container Cloud managed cluster as described in Create a managed cluster, proceed with adding machines to this cluster using the Container Cloud web UI.

You can also use the instruction below to scale up an existing managed cluster.

To add a machine to an OpenStack-based managed cluster:

  1. Log in to the Container Cloud web UI with the writer permissions.

  2. Switch to the required project using the Switch Project action icon located on top of the main left-side navigation panel.

  3. In the Clusters tab, click the required cluster name. The cluster page with Machines list opens.

  4. On the cluster page, click Create Machine.

  5. Fill out the form with the following parameters as required:

    Container Cloud machine configuration




    Specify the number of machines to create.

    The required minimum number of machines is three for the manager nodes HA and two for the Container Cloud workloads.

    Select Manager or Worker to create a Kubernetes manager or worker node.


    From the drop-down list, select the required hardware configuration for the machine. The list of available flavors corresponds to the one in your OpenStack environment.

    For the hardware requirements, see: Reference Architecture: Requirements for an OpenStack-based cluster.


    From the drop-down list, select the cloud image with Ubuntu 18.04. If you do not have this image in the list, add it to your OpenStack environment using the Horizon web UI by downloading the image from the Ubuntu official website.

    Availability zone

    From the drop-down list, select the availability zone from which the new machine will be launched.

    Node Labels

    Select the required node labels for the machine to run certain components on a specific node. For example, for the StackLight nodes that run Elasticsearch and require more resources than a standard node, select the StackLight label. The list of available node labels is obtained from your current Cluster release.


    If you deploy StackLight in the HA mode (recommended), add the StackLight label to minimum three nodes.


    You can configure node labels after deploying a machine. On the Machines page, click the More action icon in the last column of the required machine field and select Configure machine.

  6. Click Create.

  7. Repeat the steps above for the remaining machines.

    You can monitor the machine status in the Managers or Workers columns on the Clusters page. Once the status changes to Ready, the deployment of the managed cluster components on this machine is complete.

    The machine creation starts with the Provision status. During provisioning, the machine is not expected to be accessible since its infrastructure (VM, network, and so on) is being created.

    Other machine statuses are the same as the LCMMachine object states described in Reference Architecture: LCM controller.

  8. Verify the status of the cluster nodes as described in Connect to a Mirantis Container Cloud cluster.


An operational managed cluster deployment must contain a minimum of 3 Kubernetes manager nodes and 2 Kubernetes worker nodes. The deployment of the cluster does not start until the minimum number of nodes is created.

To meet the etcd quorum and to prevent the deployment failure, deletion of the manager nodes is prohibited.

A machine with the manager node role is automatically deleted during the managed cluster deletion.

See also

Delete a machine