Devtron K8s Dashboard
  • Getting Started
    • Overview of Dashboard
    • Prerequisites
    • Install Modern Kubernetes Dashboard
  • User Guide
    • Explore Kubernetes Resources
      • Overview Page
      • Discover and Manage Resources
      • Nodes and Operations
      • Pod Management and Debugging
      • Cluster Terminal
      • Add Monitoring Dashboards/Graphs
      • Run Kubectl Commands Locally
    • Use Resource Watcher
    • Manage Helm Apps
    • Manage Argo CD Apps
    • Manage Flux CD Apps
    • Chart Store
      • Examples
        • Deploying MySQL Helm Chart
        • Deploying MongoDB Helm Chart
  • Operator Guide
    • Projects
    • Clusters
    • OCI Registry
    • Chart Repositories
    • Manage Authorization (RBAC)
      • SSO Login Services
        • Google
        • GitHub
        • GitLab
        • Microsoft
        • LDAP
        • OIDC
          • Keycloak
          • Okta
        • OpenShift
      • User Permissions
      • Permission Groups
      • API Tokens
    • External Links
    • Catalog Framework
    • Charts and Chart Store
    • Show/Hide Argo CD App Listing
    • Show/Hide Flux CD App Listing
    • Configure GUI Schema for Manifests
    • Configure Lock Schema for Manifests
  • Resources
    • Glossary
    • FAQ
Powered by GitBook
On this page
  • Introduction
  • Add Kubernetes Cluster
  • Add Clusters Using Server URL & Bearer Token
  • Add Clusters Using Kubeconfig
  • Add Environment
  • Update Environment
  • Extras
  • Get Cluster Credentials
  • Benefits of Self-hosted URL
Export as PDF
  1. Operator Guide

Clusters

PreviousProjectsNextOCI Registry

Last updated 6 months ago

Introduction

You can add your existing Kubernetes clusters and environments on the Clusters and Environments section. You must have a access to add a cluster.

Figure 1: Clusters and Environments in Devtron

Add Kubernetes Cluster

Use this option to add a managed or on-premise Kubernetes cluster.

  1. Go to Global Configurations → Clusters & Environments.

  2. Click the Add Cluster button on the top-right corner.

  1. You can choose to add your Kubernetes cluster using either of the following methods:

Add Clusters Using Server URL & Bearer Token

Note

To add a Kubernetes cluster on Devtron using a Server URL and bearer token, provide the information in the following fields:

Field
Description

Name

Enter a name of your cluster

Server URL

Bearer Token

Bearer token of a cluster

Add Clusters Using Kubeconfig

To add clusters using kubeconfig, follow these steps:

  1. First, navigate to the global configurations menu, and then go to "clusters and environment" section.

  2. Click on the Add cluster button. In the options provided, choose the From kubeconfig option.

  3. Next, either paste the kubeconfig file or browse for it and select the appropriate file.

  4. Afterward, click on the Get cluster button. This action will display the cluster details alongside the kubeconfig.

  1. Select the desired cluster and click on Save to successfully add the cluster to Devtron.

Note

Please ensure that the kubeconfig file you use has admin permissions. It is crucial for Devtron to have the necessary administrative privileges; otherwise, it may encounter failures or disruptions during deployments and other operations. Admin permission is essential to ensure the smooth functioning of Devtron and to prevent any potential issues that may arise due to insufficient privileges.



Add Environment

Once you have added your cluster in the Clusters & Environments, you can add the environment by clicking Add environment.

A new environment window pops up.

Field
Description

Environment Name

Enter a name of your environment.

Enter Namespace

Enter a namespace corresponding to your environment. Note: If this namespace does not already exist in your cluster, Devtron will create it. If it exists already, Devtron will map the environment to the existing namespace.

Environment Type

Select your environment type:

  • Production

  • Non-production

Note: Devtron shows deployment metrics (DORA metrics) for environments tagged as Production only.

Click Save and your environment will be created.


Update Environment

  • You can also update an environment by clicking the environment.

  • You can change Production and Non-Production options only.

  • You cannot change the Environment Name and Namespace Name.

  • Make sure to click Update to update your environment.


Extras

Get Cluster Credentials

Prerequisites

kubectl must be installed on the bastion.

Note

You can get the Server URL and Bearer Token by running the following command depending on the cluster provider:

If you are using EKS, AKS, GKE, Kops, Digital Ocean managed Kubernetes, run the following command to generate the server URL and bearer token:

curl -O https://raw.githubusercontent.com/devtron-labs/utilities/main/kubeconfig-exporter/kubernetes_export_sa.sh && bash kubernetes_export_sa.sh cd-user  devtroncd

If you are using a microk8s cluster, run the following command to generate the server URL and bearer token:

curl -O https://raw.githubusercontent.com/devtron-labs/utilities/main/kubeconfig-exporter/kubernetes_export_sa.sh && sed -i 's/kubectl/microk8s kubectl/g' \
kubernetes_export_sa.sh && bash kubernetes_export_sa.sh cd-user \
devtroncd

Benefits of Self-hosted URL

  • Disaster Recovery:

    • It is not possible to edit the server URL of a cloud specific provider. If you're using an EKS URL (e.g. *****.eu-west-1.elb.amazonaws.com), it will be a tedious task to add a new cluster and migrate all the services one by one.

    • But in case of using a self-hosted URL (e.g. clear.example.com), you can just point to the new cluster's server URL in DNS manager and update the new cluster token and sync all the deployments.

  • Easy Cluster Migrations:

    • In case of managed Kubernetes clusters (like EKS, AKS, GKE etc) which is a cloud provider specific, migrating your cluster from one provider to another will result in waste of time and effort.

    • On the other hand, migration for a self-hosted URL is easy as the URL is of single hosted domain independent of the cloud provider.

Figure 2: Adding a Cluster

Figure 3: Adding a Kubernetes Cluster

Refer to know the process of getting Server URL and bearer token.

Server URL of a cluster. Note: We recommended to use a instead of cloud hosted URL.

Figure 4: Entering Cluster Credentials
Figure 5: Using Kubeconfig
Figure 6: Saving Cluster
Figure 11: Adding an Environment in Cluster

We recommend to use a self-hosted URL instead of cloud hosted URL. Refer the benefits of .

Figure 12: Generating Cluster Credentials
Server URL & Bearer Token
Kubeconfig
Get Cluster Credentials
self-hosted URL
self-hosted URL
super admin