tencent cloud

$0 14-Day TrialExperience EdgeOne for acceleration and security protection!

Feedback

Tencent Kubernetes Engine
DocumentationTencent Kubernetes EnginePractical TutorialOPSUsing kubecm to Manage Multiple Clusters kubeconfig
DocumentationTencent Kubernetes EnginePractical TutorialOPSUsing kubecm to Manage Multiple Clusters kubeconfig

Using kubecm to Manage Multiple Clusters kubeconfig

Last updated: 2024-12-13 21:12:47

Overview

Kubectl is a command line tool provided by Kubernetes for performing operations on clusters. It uses kubeconfig as a configuration file (the default path is ~/.kube/config) to configure the information of multiple clusters, and manage and operate multiple clusters.
To manage and operate the TKE or TKE Serverless cluster through Kubectl, you need to enable the APIServer's public or private network access on the cluster basic information page to obtain kubeconfig (cluster access credentials). If you need to use kubectl to manage multiple clusters, generally you need to extract the contents of each field in kubeconfig and merge them into the kubeconfig file of the device where kubectl locates. This method is complicated and may easily cause an error.
Through the kubecm tool, you can merge multiple cluster access credentials into kubeconfig more simply and efficiently. This document describes how to use kubecm to efficiently manage the kubeconfig of multiple clusters.

Prerequisites

You have installed the kubectl command line tool on the device used for managing multiple clusters.

Directions

Installing kubecm

Install kubecm on the device used for managing multiple clusters.

Obtaining cluster access credential

After creating a cluster, you need to follow the steps below to obtain access credential for the cluster:
1. Log in to the TKE console and click Cluster in the left sidebar.
2. Click the ID/name of the cluster for which the access credential needs to be obtained to go to the basic information page of the cluster.
3. On the Basic Information page, enable Internet access and Private network access in the Cluster APIServer Information section.
4. Click Download on the right of KubeConfig.


Using kubecm to add access credential to kubeconfig

This document takes the cluster access credential cls-l6whmzi3-config as an example. Run the following command to use kubecm to add the access credential to kubeconfig (-n means you can specify the context name):
kubecm add -f cls-l6whmzi3-config -n cd -c

Viewing the cluster list

Run the following kubecm ls command to view the cluster list in kubeconfig (the asterisk identifies the cluster under operation):
$ kubecm ls
+------------+------------+-----------------------+--------------------+-----------------------------------+-------------------+
| CURRENT | NAME | CLUSTER | USER | SERVER | Namespace |
+============+============+=======================+====================+===================================+===================+
| * | cd | cluster-chh6kgf9d9 | user-chh6kgf9d9 | https://cls-l6whmzi3.ccs.tence | default |
| | | | | nt-cloud.com | |
+------------+------------+-----------------------+--------------------+-----------------------------------+-------------------+
| | bj | cluster-6qaua96n | user-6qaua96n | https://cls-6qaua96n.ccs.tence | kube-system |
| | | | | nt-cloud.com | |
+------------+------------+-----------------------+--------------------+-----------------------------------+-------------------+

Switching the cluster

Run the following kubecm switch command to interactively switch to another cluster:


Removing the cluster

Run the following kubecm delete command to remove a cluster:
$ kubecm delete bj
Context Delete:「bj」
「/Users/roc/.kube/config」 write successful!
+------------+---------+-----------------------+--------------------+-----------------------------------+--------------+
| CURRENT | NAME | CLUSTER | USER | SERVER | Namespace |
+============+=========+=======================+====================+===================================+==============+
| | cd | cluster-chh6kgf9d9 | user-chh6kgf9d9 | https://cls-l6whmzi3.ccs.tence | default |
| | | | | nt-cloud.com | |
+------------+---------+-----------------------+--------------------+-----------------------------------+--------------+

Learn More

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon