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.

Expand IP addresses capacity in an existing cluster¶

If the subnet capacity on your existing cluster is not enough to add new machines, use the l2TemplateSelector feature to expand the IP addresses capacity:

Create new Subnet object(s) to define additional address ranges for new machines.
Set up routing between the existing and new subnets.
Create new L2 template(s) with the new subnet(s) being used in l3Layout.
Set up l2TemplateSelector in the Machine objects for new machines.

To expand IP addresses capacity for an existing cluster:

Verify the capacity of the subnet(s) currently associated with the L2 template(s) used for cluster deployment:

If labelSelector is not used for the given subnet, use the namespace value of the L2 template and the subnetName value from the l3Layout section:
```
kubectl get subnet -n <namespace> <subnetName>
```

If labelSelector is used for the given subnet, use the namespace value of the L2 template and comma-separated key-value pairs from the labelSelector section for the given subnet in the l3Layout section:

kubectl get subnet -n <namespace> -l <key1=value1>[<,key2=value2>...]

Example command:

kubectl get subnet -n test-ns -l cluster.sigs.k8s.io/cluster-name=mosk123,user-defined/purpose=lcm-base

Example of system response:

NAME             AGE  CIDR            GATEWAY      CAPACITY  ALLOCATABLE  STATUS
old-lcm-network  8d   192.168.1.0/24  192.168.1.1  253       0            OK

Create new objects:

Subnet with the user-defined/purpose: lcm-additional label.
L2Template with the alternative-template: “1” label. The L2 template should reference the new Subnet object using the user-defined/purpose: lcm-additional label in the labelSelector field.

Note

The label name user-defined/purpose is used for illustration purposes. Use any custom label name that differs from system names. Use of a unique prefix such as user-defined/ is recommended.

You can also reference the new Subnet object by using its name in the l3Layout section of the alternative-template L2 template.

Set up IP routing between the existing and new subnets using the tools of your cloud network infrastructure.

In the providerSpec section of the new Machine object, define the alternative-template label for l2TemplateSelector:

After creation, the new machine will use the alternative L2 template that uses the new-lcm-network subnet linked by L3Layout.

Optional. Configure the additional extension IP address pool for the metallb load balancer service.
1. Open the MetalLBConfig object of the management cluster for editing:
```
kubectl edit metallbconfig <MetalLBConfigName>
```
2. In the ipAddressPools section, add:
```
...
spec:
  ipAddressPools:
  - name: extension
    spec:
      addresses:
      - <pool_start_ip>-<pool_end_ip>
      autoAssign: false
      avoidBuggyIPs: false
...
```
  In the snippet above, replace the following parameters:
  - <pool_start_ip> - first IP address in the required range
  - <pool_end_ip> - last IP address in the range
3. Add the extension IP address pool name to the L2Advertisements definition. You can add it to the same L2 advertisement as the default IP address pool, or create a new L2 advertisement if required.
```
...
spec:
  l2Advertisements:
  - name: default
    spec:
      interfaces:
      - k8s-lcm
      ipAddressPools:
      - default
      - extension
...
```
4. Save and exit the object to apply changes.
Verify the created objects for MetalLB. For reference, use the mosk-ns_MetalLBConfig-lb-mosk.yaml file in Example of a complete template configuration for cluster creation.