操作场景

本文介绍如何通过 Kubernetes 命令行工具 Kubectl 从本地客户端机器连接到边缘集群。

前提条件

• 请安装 curl 软件。
• 请根据操作系统的类型，选择获取 Kubectl 工具的方式：

  说明：

  根据实际需求，将命令行中的 v1.8.13 替换成业务所需的 Kubectl 版本。

  • Mac OS X 系统
    执行以下命令，获取 Kubectl 工具：

    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.13/bin/darwin/amd64/kubectl

  • Linux 系统
    执行以下命令，获取 Kubectl 工具：

    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.13/bin/linux/amd64/kubectl

  • Windows 系统
    执行以下命令，获取 Kubectl 工具：

    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.13/bin/windows/amd64/kubectl.exe

操作步骤

安装 Kubectl 工具

1. 参考 Installing and Setting up kubectl，安装 Kubectl 工具。

   说明：

   • 如果您已经安装 Kubectl 工具，请忽略本步骤。
   • 此步骤以 Linux 系统为例。

2. 依次执行以下命令，添加执行权限。

   chmod +x ./kubectl

   sudo mv ./kubectl /usr/local/bin/kubectl

3. 执行以下命令，测试安装结果。

   kubectl version

   如若输出类似以下版本信息，即表示安装成功。

   Client Version: version.Info{Major:"1", Minor:"5", GitVersion:"v1.5.2", GitCommit:"08e099554f3c31f6e6f07b448ab3ed78d0520507", GitTreeState:"clean", BuildDate:"2017-01-12T04:57:25Z", GoVersion:"go1.7.4", Compiler:"gc", Platform:"linux/amd64"}

获取集群证书信息

1. 登录 腾讯云容器服务控制台，选择左侧导航栏中的【边缘集群】。
2. 在“边缘集群”页面，单击需连接集群所在行右侧的【查看集群凭证】。如下图所示：
   
3. 在弹出的“集群凭证”窗口中，可以查看、复制及下载凭证内容。

   说明：

   您可以根据实际需求，单击【复制】或【下载】将集群访问凭证保存到本地。

4. 在“外网访问”中，单击将集群外网访问状态设置为开启，并可参考 设置 Kubectl 命令自动补全 直接使用集群访问凭证进行访问。

通过证书信息使用 Kubectl 操作集群

请求方法

Kubectl 命令格式如下所示：

--kubeconfig=本地集群访问凭证

示例

执行以下命令，查看集群下现存命名空间。

kubectl get namespace --kubeconfig=cls-8ipgf8u4.kubeconfig

本文使用集群凭证以 cls-8ipgf8u4.kubeconfig 为例，请替换为实际使用凭证。
返回类似以下信息，则表示请求成功。

NAME         STATUS    AGE
default      Active    11d
kube-system  Active    11d

设置 Kubectl 命令自动补全

您可以通过执行以下命令，配置 Kubectl 自动补全，提高可使用性。

source <(kubectl completion bash)