docs: adding clusters on devtron using kubeconfig (#3494)

* documentation for adding clusters on devtron using kubeconfig

* added a minor correction

---------

Co-authored-by: Shubham9t9 <[email protected]>

Author: Shubham9t9

docs/user-guide/global-configurations/cluster-and-environments.md

@@ -10,14 +10,19 @@ To add cluster, go to the `Clusters & Environments` section of `Global Configura
 
 ![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/cluster-and-environments/add-clusters.png)
 
-Provide the information in the following fields to add your kubernetes cluster:
+### Add Clusters Using Server URL & Bearer Token
+
+
+To add a Kubernetes cluster on Devtron using `server url` and the `bearer token`, provide the information in the following fields:
 
 | Field | Description |
 | :--- | :--- |
 | `Name` | Enter a name of your cluster. |
 | `Server URL` |  Server URL of a cluster.<br>Note: We recommended to use a [self-hosted URL](#benefits-of-self-hosted-url) instead of cloud hosted URL.</br>  |
 | `Bearer Token` | Bearer token of a cluster. |
 
+![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/cluster-and-environments/add-cluster-cred.jpg)
+
 ### Get Cluster Credentials
 
 >**Prerequisites:** `kubectl` must be installed on the bastion.
@@ -30,15 +35,15 @@ You can get the **`Server URL`** & **`Bearer Token`** by running the following c
 {% tab title="k8s Cluster Providers" %}
 If you are using EKS, AKS, GKE, Kops, Digital Ocean managed Kubernetes, run the following command to generate the server URL and bearer token:
 ```bash
-curl -o https://raw.githubusercontent.com/devtron-labs/utilities/main/kubeconfig-exporter/kubernetes_export_sa.sh \ 
+curl -O https://raw.githubusercontent.com/devtron-labs/utilities/main/kubeconfig-exporter/kubernetes_export_sa.sh \ 
 && bash kubernetes_export_sa.sh cd-user  devtroncd
 ```
 {% endtab %}
 {% tab title="Microk8s Cluster" %}
 If you are using a **`microk8s cluster`**, run the following command to generate the server URL and bearer token:
 
 ```bash
-curl -o https://raw.githubusercontent.com/devtron-labs/utilities/main/kubeconfig-exporter/kubernetes_export_sa.sh && sed -i 's/kubectl/microk8s kubectl/g' \
+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
 ```
@@ -47,6 +52,8 @@ devtroncd
 
 ![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/cluster-and-environments/generate-cluster-credentials.png)
 
+
+
 ### Benefits of Self-hosted URL
 
 * Disaster Recovery: 
@@ -58,6 +65,27 @@ devtroncd
   * 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.
 
 
+### 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. 
+
+![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/cluster-and-environments/add-cluster-kubeconfig.jpg)
+
+5. Select the desired cluster and click on `Save` to successfully add the cluster to Devtron.
+
+![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/cluster-and-environments/kubeconfig-save-cluster.jpg)
+
+
+**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.
+
 ### Configure Prometheus (Enable Applications Metrics)
 
 If you want to see application metrics against the applications deployed in the  cluster, Prometheus must be deployed in the cluster. Prometheus is a powerful tool to provide graphical insight into your application behavior.