用户指南

最佳实践

API 文档

连接集群

最近更新时间:2020-03-25 17:49:59

操作场景

本文介绍如何通过 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)
目录