查看文档 试用 Kubernetes

入门指南

如何开始使用 Kubernetes，并创建任务

编辑这个页面

通过`kubeconfig`接入群集

可以复制kubectl客户端配置文件(kubeconfig)可以访问正在运行的 Kubernetes 群集。 通过 cluster/kube-up.sh 产生的，配置文件在 $HOME/.kube/config 中，生成并使用kubeconfig的详细步骤如下：

1. 创建一个群集

$ cluster/kube-up.sh

2. 复制 kubeconfig 到新主机

$ scp $HOME/.kube/config user@remotehost:/path/to/.kube/config

3. 在新主机中，让kubectl可以使用config副本

$ mv /path/to/.kube/config $HOME/.kube/config

$ mv /path/to/.kube/config $PWD

# 通过环境变量
$ export KUBECONFIG=/path/to/.kube/config

# 通过命令行参数
$ kubectl ... --kubeconfig=/path/to/.kube/config

手动生成 kubeconfig

kubeconfig 是由 kube-up 生成的，你也可以用下面的命令自己生成它（任何指令集）：

# 创建 kubeconfig 入口
$ kubectl config set-cluster $CLUSTER_NICK \
    --server=https://1.1.1.1 \
    --certificate-authority=/path/to/apiserver/ca_file \
    --embed-certs=true \
    # 如果不需要 TLS ，则用下面两行替换 --certificate-authority 和 --embed-certs
    --insecure-skip-tls-verify=true \
    --kubeconfig=/path/to/standalone/.kube/config

# 创建用户入口
$ kubectl config set-credentials $USER_NICK \
    # 加载在主机生成的 token。
    --token=$token \
    # 使用 username|password 或者 token，任意一种方式
    --username=$username \
    --password=$password \
    --client-certificate=/path/to/crt_file \
    --client-key=/path/to/key_file \
    --embed-certs=true \
    --kubeconfig=/path/to/standalone/.kube/config

# 创建 context 入口
$ kubectl config set-context $CONTEXT_NAME \
    --cluster=$CLUSTER_NICK \
    --user=$USER_NICK \
    --kubeconfig=/path/to/standalone/.kube/config

笔记：

$ export KUBECONFIG=/path/to/standalone/.kube/config

查看kubeconfig-file.md 来了解更多 kubeconfig 细节 , 或者运行 kubectl config -h.

合并 kubeconfig 的例子

kubectl 加载并合并配置文件（按顺序）

  1. --kubeconfig=/path/to/.kube/config 命令行标识
  2. KUBECONFIG=/path/to/.kube/config 环境变量
  3. $PWD/.kube/config
  4. $HOME/.kube/config

如果在 host1创建群集 A，B， 在 host2上创建群集 C，D，你可以在两台主机上运行所有四组群集。

# 在 host2，复制 host1 的默认 kubeconfig，并且配置到环境变量
$ scp host1:/path/to/home1/.kube/config /path/to/other/.kube/config

$ export $KUBECONFIG=/path/to/other/.kube/config

# 在 host1，复制 host2 的默认 kubeconfig，并且配置到环境变量
$ scp host2:/path/to/home2/.kube/config /path/to/other/.kube/config

$ export $KUBECONFIG=/path/to/other/.kube/config

加载/合并 kubeconfig的详细的例子和说明在kubeconfig-file。

Analytics