Add a managed baremetal cluster

This section instructs you on how to configure and deploy a managed cluster that is based on the baremetal-based management cluster.

By default, Mirantis Container Cloud configures a single interface on the cluster nodes, leaving all other physical interfaces intact.

With L2 networking templates, you can create advanced host networking configurations for your clusters. For example, you can create bond interfaces on top of physical interfaces on the host or use multiple subnets to separate different types of network traffic.

You can use several host-specific L2 templates per one cluster to support different hardware configurations. For example, you can create L2 templates with different number and layout of NICs to be applied to the specific machines of one cluster.

When you create a baremetal-based project, the exemplary templates with the ipam/PreInstalledL2Template label are copied to this project. These templates are preinstalled during the management cluster bootstrap.

Using the L2 Templates section of the Clusters tab in the Container Cloud web UI, you can view a list of preinstalled templates and the ones that you manually create before a cluster deployment.

Follow the procedures described in the below subsections to configure initial settings and advanced network objects for your managed clusters.

Warning

Avoid modifying existing L2 templates and subnets that the deployed machines use. This prevents multiple clusters failures caused by unsafe changes. The list of risks posed by modifying L2 templates includes:

• Services running on hosts cannot reconfigure automatically to switch to the new IP addresses and/or interfaces.

• Connections between services are interrupted unexpectedly, which can cause data loss.

• Incorrect configurations on hosts can lead to irrevocable loss of connectivity between services and unexpected cluster partition or disassembly.

Note

Starting from Container Cloud 2.17.0, modification of L2 templates in use is prohibited in the API to prevent accidental cluster failures due to unsafe changes.

• Create a cluster using web UI
• Workflow of network interface naming
• Create subnets
  • Service labels and their life cycle
  • Create subnets for a managed cluster using web UI
  • Create subnets for a managed cluster using CLI
• Automate multiple subnet creation using SubnetPool
• Create L2 templates
  • L2 template example with bonds and bridges
    • Kubernetes LCM network
    • Dedicated network for the Kubernetes pods traffic
    • Dedicated network for the Kubernetes services traffic (MetalLB)
    • Dedicated network for the Ceph distributed storage traffic
    • Example of an L2 template with interfaces bonding
  • L2 template example for automatic multiple subnet creation
  • Create an L2 template for a new managed cluster
  • Workflow of the netplan configuration using an L2 template