用户指南

连接集群

最近更新时间:2020-01-15 14:08:31

操作场景

您可以通过 Kubernetes 命令行工具 Kubectl 从本地客户端机器连接到 TKE 集群。本文档指导您如何连接集群。

前提条件

请安装 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"}

配置 Kubeconfig

  1. 登录容器服务控制台 ,选择左侧导航栏中的【集群】,进入集群管理界面。
  2. 单击需要连接的集群 ID/名称,进入集群详情页。
  3. 选择左侧导航栏中的【基本信息】,即可在“基本信息”页面中查看“集群APIServer信息”模块中该集群的访问地址、外网/内网访问状态、Kubeconfig 访问凭证内容等信息。如下图所示:
    • 访问地址:集群 APIServer 地址。请注意该地址不支持复制粘贴至浏览器进行访问。
    • 获取访问入口:请根据实际需求进行设置。
      • 外网访问:默认不开启。开启外网访问会将集群 apiserver 暴露到公网,请谨慎操作。且需配置来源授权,默认全拒绝,您可配置放通单个 IP 或 CIDR ,强烈不建议配置 0.0.0.0/0 放通全部来源。
      • 内网访问:默认不开启。开启内网访问时,需配置一个子网,开启成功后将在已配置的子网中分配 IP 地址。
    • Kubeconfig:该集群的访问凭证,可复制、下载。
  4. 根据实际情况进行集群凭据配置。
    配置前,请判断当前访问客户端是否已经配置过任何集群的访问凭证:
    • ,即 ~/.kube/config 文件内容为空,可直接复制已获取的 Kubeconfig 访问凭证内容并粘贴入 ~/.kube/config 中。若客户端无 ~/.kube/config 文件,您可直接创建。
    • ,您可下载已获取的 Kubeconfig 至指定位置,并依次执行以下命令以合并多个集群的 config。
      KUBECONFIG=~/.kube/config:~/Downloads/cls-3jju4zdc-config kubectl config view --merge --flatten > ~/.kube/config
      export KUBECONFIG=~/.kube/config
      其中,~/Downloads/cls-3jju4zdc-config 为本集群的 Kubeconfig 的文件路径,请替换为下载至本地后的实际路径。

访问 Kubernetes 集群

  1. 完成 Kubeconfig 配置后,依次执行以下命令查看并切换 context 以访问本集群。
    kubectl config get-contexts
    kubectl config use-context cls-3jju4zdc-context-default
  2. 执行以下命令, 测试是否可正常访问集群。
    kubectl get node
    如果无法连接请查看是否已经开启公网访问或内网访问入口,并确保访问客户端在指定的网络环境内。

相关说明

Kubectl 命令行介绍

Kubectl 是一个用于 Kubernetes 集群操作的命令行工具。本文涵盖 kubectl 语法、常见命令操作并提供常见示例。有关每个命令(包括所有主命令和子命令)的详细信息,请参阅 kubectl 参考文档 或使用 kubectl help 命令查看详细帮助,kubectl 安装说明请参见 安装 Kubectl 工具

目录