Install Multi-Cluster Shared Network Contrail
SUMMARY See examples on how to install multi-cluster Contrail in a deployment where Kubernetes traffic and Contrail traffic share the same network within each cluster.
In a multi-cluster shared network deployment:
-
Contrail is the central networking platform and CNI plug-in for multiple distributed workload clusters. The Contrail controller runs in the Kubernetes control plane in the central cluster, and the Contrail data plane components run on the worker nodes in the distributed workload clusters.
-
Kubernetes and Contrail traffic within each cluster share a single network.
Figure 1 shows the cluster you'll create if you follow the multi-cluster setup. The central cluster consists of 3 Kubernetes control plane nodes that run the Contrail controller. This centralized Contrail controller provides the networking for distributed workload clusters. In this example, there is one distributed cluster that consists of a single control plane node and two worker nodes. The worker nodes on the distributed workload cluster contain the Contrail data plane components.
The central cluster attaches to the 172.16.0.0/24 network while the distributed workload cluster attaches to the 10.16.0.0/24 network. A gateway sitting between the networks provides access to each other and external access for downloading images from Juniper Networks repositories.
The local administrator is shown attached to a separate network reachable through a gateway. This is typical of many installations where the local administrator manages the fabric and cluster from the corporate LAN. In the procedures that follow, we refer to the local administrator station as your local computer.
Connecting all cluster nodes together is the data center fabric, which is simplified in the example into a single subnet per cluster. In real installations, the data center fabric is a network of spine and leaf switches that provide the physical connectivity for the cluster.
In an Apstra-managed data center, this connectivity would be specified through the overlay virtual networks that you create across the underlying fabric switches.
To install Contrail in a multi-cluster deployment, you first create the central cluster and then you attach the distributed workload clusters to the central cluster one by one. As with the single-cluster deployment, you'll start with a fresh cluster with no CNI plug-in installed and then you'll install Contrail on it.
The procedures in this section show basic examples of how you can use the provided manifests to create the specified Contrail deployment. You're not limited to the deployment described in this section nor are you limited to using the provided manifests. Contrail supports a wide range of deployments that are too numerous to cover in detail. Use the provided examples as a starting point to roll your own manifest for your specific situation.
Release | Example |
---|---|
22.1 | Install Multi-Cluster Shared Network Contrail in Release 22.1 |
Note:
The provided manifests may not be compatible between releases. Make sure you use the manifests for the release that you're running. |
Install Multi-Cluster Shared Network Contrail in Release 22.1
Use this procedure to install Contrail in a multi-cluster shared network deployment running a kernel mode data plane in release 22.1.
The manifest that you will use in this example procedure is multi-cluster/central/deployer_ha_central.yaml. The procedure assumes that you've placed this manifest into a manifests directory.