操作场景
本文介绍如何通过 Kubernetes 命令行工具 Kubectl 从本地客户端机器连接到边缘集群。
前提条件
- 请安装 curl 软件。
- 请根据操作系统的类型,选择获取 Kubectl 工具的方式:
说明:
请根据实际需求,将命令行中的 “v1.18.2” 替换成业务所需的 Kubectl 版本。一般来说,客户端的 Kubctl 与服务端的 Kubernetes 的最高版本保持一致即可。您可以在基本信息里查看 k8s 版本。
- Mac OS X 系统
执行以下命令,获取 Kubectl 工具:curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.2/bin/darwin/amd64/kubectl
- Linux 系统
执行以下命令,获取 Kubectl 工具:curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.2/bin/linux/amd64/kubectl
- Windows 系统
执行以下命令,获取 Kubectl 工具:curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.2/bin/windows/amd64/kubectl.exe
- Mac OS X 系统
操作步骤
安装 Kubectl 工具
- 参考 Installing and Setting up kubectl,安装 Kubectl 工具。
说明:
- 如果您已经安装 Kubectl 工具,请忽略本步骤。
- 此步骤以 Linux 系统为例。
- 依次执行以下命令,添加执行权限。
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl
- 执行以下命令,测试安装结果。
如若输出类似以下版本信息,即表示安装成功。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"}
获取集群证书信息
- 登录 腾讯云容器服务控制台 ,选择左侧导航栏中的边缘集群。
- 在“边缘集群”页面,单击需连接集群所在行右侧的查看集群凭证。如下图所示:
- 在弹出的“集群凭证”窗口中,可以查看、复制及下载凭证内容。
说明:
您可以根据实际需求,单击复制或下载将集群访问凭证保存到本地。
- 在“外网访问”中,单击
将集群外网访问状态设置为开启,并可参考 设置 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)