Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Installing Standalone Kubernetes Contrail Cluster using the Contrail Command UI

Note:

This topic covers Contrail Networking in Kubernetes-orchestrated environments that are using Contrail Networking Release 21-based releases.

Starting in Release 22.1, Contrail Networking evolved into Cloud-Native Contrail Networking. Cloud-Native Contrail Networking offers significant enhancements to optimize networking performance in Kubernetes-orchestrated environments. We recommend using Cloud-Native Contrail for networking in most Kubernetes-orchestrated environments.

For general information about Cloud-Native Contrail, see the Cloud-Native Contrail Networking Techlibrary homepage.

Starting with Contrail Release 5.1, you can use Contrail Command to initiate Kubernetes Contrail cluster deployment. This example topic describes how to use the Contrail Command User interface (UI) to deploy a standalone Kubernetes Contrail cluster.

Requirements

  • Contrail Controller — 8 vCPU, 64G memory, 300G storage.

  • Contrail Server Node (CSN) — 4 vCPU, 16G memory, 100G storage.

  • Compute nodes— Dependent on the workloads.

Overview

You can use Contrail Command to initiate a standalone Kubernetes Contrail cluster deployment. You must install the controller and compute nodes first. When the host nodes are operational, Contrail Command uses the underlying Ansible deployer to install a standalone Kubernetes Contrail cluster. Contrail Command supports the management and provisioning of Contrail components. To provision Kubernetes resources, such as pods, services, and so on, use the Kubernetes API server or the kubectl CLI on the Kubernetes master node.

Configuration

Deploying a Kubernetes Contrail Cluster

Step-by-Step Procedure

To deploy a Kubernetes Contrail cluster using Contrail Command, perform the following steps.

  1. Click the Create button on the Setup > Servers tab to add physical servers. The Create Server page is displayed. You can add a server in the following ways:

    • Express

    • Detailed

    • Bulk Import (csv)

    Note:

    Create server login credentials before adding the servers.

    Figure 1: Create ServerCreate Server dialog in Contrail Command app with options for Express, Detailed, or Bulk Import CSV mode. Hostname set to test_host. Management IP is 10.87.84.65. Management Interface is eth0. Credentials selected as contrail_creds. Options to cancel or create server. Setup process on left with steps like Inventory and Control Nodes.

    Click Create to create the server. The list of servers is displayed in the Inventory page. Click Next to continue creating a cluster. The Contrail Cluster page appears.

  2. Create a Contrail cluster.

    If Container registry = hub.juniper.net/contrail . This registry is secure. Unselect the Insecure box. Also, Contrail version = contrail_container_tag for your release of Contrail as listed in README Access to Contrail Registry 20XX.

    Default vRouter Gateway = Default gateway for the compute nodes. If any one of the compute nodes has a different default gateway than the one provided here, enter that gateway in 5 and 6 for service nodes.

    Set the order of Encapsulation Priority for the EVPN supported methods - MPLS over UDP, MPLS over GRE And VxLAN.

    Figure 2: Contrail ClusterSetup interface for Contrail Command showing Step 2: Contrail Cluster with fields for Cluster Name, Container Registry, Contrail Version, and Provisioner Type. Navigation buttons for Previous and Next.

    Click Next. The Control Nodes page appears.

  3. Select the Contrail control nodes.

    Figure 3: Control NodesScreenshot of Contrail Command Setup interface at Control Nodes step 3. Left sidebar shows setup steps, current step highlighted. Main area lists available and assigned control nodes. High availability mode checkbox is unchecked. Navigation buttons for setup steps at the bottom.

    Click Next. The Orchestrator Nodes page appears.

  4. Select the Kubernetes orchestration type.

    Select the Kubernetes nodes from the list of available servers.

    Select the Kubernetes nodes from the list of available servers and assign corresponding roles to the servers. By default , the Kubernetes nodes are assigned the kubernetes_master_node, kubernetes_kubemanager_node, and kubernetes_node roles.

    Figure 4: Orchestrator NodesScreenshot of Contrail Command UI for Kubernetes setup; Step 8 Orchestrator Nodes selected; servers listed for orchestration.Setup interface for Contrail Command Step 8: Orchestrator Nodes with Kubernetes selected. Server testbed-1-vm1 is assigned as a Kubernetes node with roles kubernetes_node, kubernetes_master_node, and kubernetes_kubemanager_node.

    Click Next. The Compute Nodes page appears.

  5. Select the compute node associated with the kunernetes_node role from the list of available servers, .

    Figure 5: Compute NodesContrail Command interface showing network setup step 9: Compute Nodes. Lists available and assigned servers with hostnames and IP addresses.

    Click Next. The Contrail Service Nodes page appears.

  6. (Optional) Select the Contrail service nodes from the list of available servers.

    Figure 6: Contrail Service NodesContrail Command Setup interface showing Step 6: Contrail Service Nodes. Available Servers list with hostnames and IPs; Assigned Service Nodes empty. Navigation buttons.

    Click Next. The Appformix Nodes page appears.

  7. (Optional) Select the Contrail Insights nodes from the list of available nodes.

    Figure 7: Contrail Insights NodesSetup interface of Contrail Command showing step 7: Appformix Nodes. Available servers with hostnames and IPs can be assigned as Appformix Nodes. Navigation buttons present.

    Click Next. The Summary page appears.

  8. The summary page displays the cluster details as well as the node details. Verify the summary of your cluster configuration and click Provision.

    Figure 8: Summary - Cluster OverviewContrail Command Setup interface for configuring a Contrail cluster with steps like Inventory, Control Nodes, and a cluster summary including display name Test and orchestrator Kubernetes.
    Figure 9: Summary - Nodes OverviewContrail Command Setup interface showing node deployment steps, configuration summary, and node list for cloud management.

Sample command_servers.yml File

Related Documentation