Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Lens Install with CN2 Extension

SUMMARY This document describes the install procedure for both Lens and the CN2 extension for Lens, as well as how to connect a Juniper Cloud-Native Contrail® Networking™ (CN2) cluster to Lens.

Benefits

Lens is an integrated development environment (IDE) for Kubernetes. The Lens open source tool is implemented as an interface to manage, monitor, and troubleshoot Contrail Networking clusters. Benefits include:​

  • Ease of usability and rich end-user experience​.
  • Unified, secure, multi-cluster management on any platform: support for hundreds of clusters​.
  • Standalone application: no need to install anything in-cluster​.
  • Real-time cluster state visualization.
  • Resource utilization charts and trends with history powered by built-in Prometheus​.
  • Smart terminal access to nodes and containers​.
  • Clusters can be local (for example, minikube) or external (for example, EKS, GKE, AKS).

Install Lens

Use the following steps to download and install Lens.

  1. Navigate to Lens and select your OS from the drop-down list to download Lens.
    Note:

    Lens v5.4.4 is the supported and tested version with CN2 extension.

    The file looks similar to Lens Setup 5.4.4-latest.20220602.2.

  2. Double-click the file you just downloaded from the Lens website and follow the setup wizard onscreen prompts. Click Finish to complete the install.

    Lens is now installed and is listed as Lens on your machine.

Download and Install CN2 Extension for Lens

The CN2 extension is a Lens Custom Extension.

  • Lens extensions are used to add custom visualizations and functionality to accelerate development workflows for all the technologies and services that integrate with Kubernetes​.
  • Extensions are a plug-in uploaded directly to the Lens UI.​
  • Extensions are developed using the Lens Extensions API.

Use the following steps to install the CN2 extension for Lens:

  1. Download the CN2 extension for Lens from Juniper Networks Software Downloads.

    The file name is similar to cn2_lens_extension-VERSION_TAG.tar.

  2. Click Launch Lens to start Lens. You are in the Lens application for the remainder of this section.
  3. Sign in with your Lens ID user name and password. Follow the prompts to create a Lens ID if you do not have one.
  4. From the top menu bar, select File > Extensions.
  5. In the Extensions window, click the folder icon to select the CN2 extension tar file you downloaded in Step 1 and click Install.
    Lens begins installing the CN2 extension. This process takes approximately 10 minutes. You are notified with a successful installation message and the installed extension showing status Enabled is displayed on your screen. If Status is Disabled, right click the ":" symbol and select Enable to enable the extension.

Connect Your Cloud-Native Contrail Networking Cluster to Lens

Use the following steps to connect your Contrail Networking cluster to Lens.

  1. Click Launch Lens to start Lens. You are in the Lens application for the remainder of this section.
  2. Select File > Add Cluster.

    The Add Clusters from Kubeconfig window displays.

  3. In the Add Clusters from Kubeconfig window, copy and paste the contents of your kubeconfig file or your YAML file(s) for the clusters you want to manage. Click Add clusters.
    You are now in the Clusters window. Lens automatically populates the Clusters window with all of the valid clusters Lens finds in your folder. You can have multiple Contrail Networking cluster configurations in your folder (multiple clusters).
  4. Click the cluster you want to connect to and Lens automatically connects to that cluster.
    You are now connected to the Contrail Networking cluster.
  5. In the left pane, where the Lens options are listed, click CN2 to interact with your cluster.

    If you don't see the CN2 menu, select Lens > View > Reload.

    CN2 is your extension for Lens. You can select: CN2 > Infrastructure, Networking, Workloads, or Monitoring.

    Note:

    Known Limitation: Lens supports two theme modes, which are Dark and Light. CN2 extension supports Light mode only.

Uninstall the CN2 Extension

To uninstall the CN2 extension:

  1. Select Lens > Extensions.
  2. In Installed extensions, click the " : " and select Uninstall.
    Figure 1: Uninstall Lens Uninstall Lens