Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Announcement: Try the Ask AI chatbot for answers to your technical questions about Juniper products and solutions.

close
header-navigation
keyboard_arrow_up
Expand All close
Expand All close
list Table of Contents
file_download PDF
{ "lCode": "en_US", "lName": "English", "folder": "en_US" }
English

Installing Standalone Kubernetes Contrail Cluster using the Contrail Command UI

Release: Contrail Networking 5.1
{}
Change Release
date_range 19-Jun-19

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 Server
    Create Server

    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 for Contrail .

    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.

    content_copy zoom_out_map
    VXLAN, MPLSoUDP, MPLSoGRE
    Figure 2: Contrail Cluster
    Contrail Cluster

    Click Next. The Control Nodes page appears.

  3. Select the Contrail control nodes.
    Figure 3: Control Nodes
    Control Nodes

    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 Nodes
    Orchestrator Nodes
    Orchestrator Nodes

    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 Nodes
    Compute Nodes

    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 Nodes
    Contrail Service Nodes

    Click Next. The Appformix Nodes page appears.

  7. (Optional) Select the AppFormix nodes from the list of available nodes.
    Figure 7: Appformix Nodes
    Appformix Nodes

    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 Overview
    Summary - Cluster Overview
    Figure 9: Summary - Nodes Overview
    Summary - Nodes Overview

Sample command_servers.yml File

You can use the following sample command_servers.yml file to install Contrail Command.

content_copy zoom_out_map
command_servers:
    server1:
        ip:  10.204.216.31
        connection: ssh
        ssh_user: root
        ssh_pass: c0ntrail123
        sudo_pass: c0ntrail123
        ntpserver: 10.204.217.158
        registry_insecure: true
        container_registry: 10.204.217.152:5000
        container_name: contrail-command
        container_tag: master-659
        #container_registry_username: <Registry_Username>
        #container_registry_password: <Registry_Password>
        config_dir: /etc/contrail
        contrail_config:
            database:
                type: postgres
                dialect: postgres
                password: contrail123
                user: root
            keystone:
                assignment:
                    data:
                      users:
                        admin:
                          password: contrail123
            insecure: true
            no_auth: true
            auth_type: basic-auth
            client:
              password: contrail123
Note

You must set the auth_type to basic-auth for Kubernetes and vCenter deployment before importing or provisioning the cluster.

footer-navigation