优化install-k8s,增加安装kubectl

2019-07-27 00:01:26 +08:00
parent 0294986e92
commit 05359c6e49
88 changed files with 393 additions and 215 deletions
--- a/install/README.md
+++ b/install/README.md
@ -5,8 +5,8 @@ Kuboard 作为一个 Deployment 运行在 Kubernetes 集群中，通过 apiserve
 如果您已经有一个 Kubernetes 集群，请直接 [安装 Kuboard](install-dashboard)。

 如果您当下没有 Kubernetes 集群：
-  * 想要安装一个简单的集群，用于学习 Kubernetes， 请 [安装 Kubernetes 单Master节点](install-k8s)
-  * 想要安装一个高可用的集群，请 [安装 Kubernetes 高可用](install-kubernetes)
+  * Kubernetes初学者，请 [安装 Kubernetes 单Master节点](install-k8s)
+  * 打算用于生产环境？请 [安装 Kubernetes 高可用](install-kubernetes)

 <br>

--- a/install/install-common-vm.assets/image-20190715085036593.png
+++ b/install/install-common-vm.assets/image-20190715085036593.png
--- a/install/install-common-vm.assets/image2019-07-15_09.01.21.png
+++ b/install/install-common-vm.assets/image2019-07-15_09.01.21.png
--- a/install/install-dashboard.md
+++ b/install/install-dashboard.md
@ -135,7 +135,7 @@ token: eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2Nv

 ## 访问 Kuboard

-您可以通过NodePort、Port-forward、域名三种方式访问 Kuboard
+您可以通过NodePort、Port-forward、域名三种方式当中的任意一种访问 Kuboard

 :::: tabs type:border-card

--- a/install/install-k8s.assets/image-20190726214032585.png
+++ b/install/install-k8s.assets/image-20190726214032585.png
--- a/install/install-k8s.md
+++ b/install/install-k8s.md
@ -1,20 +1,21 @@
 # 安装 Kubernetes 单Master节点

-如果您想拥有一个供个人学习测试使用的 kubernetes 集群，推荐的做法是在阿里云采购如下配置：
+对于 Kubernetes 初学者，推荐的在阿里云采购如下配置：

-* 3台 2核4G 的ECS（突发性能实例 t5 ecs.t5-c1m2.large，或同等配置）
+* 3台 2核4G 的ECS（突发性能实例 t5 ecs.t5-c1m2.large或同等配置，单台约 0.4元/小时，停机时不收费）
 * Cent OS 7.6
-
-Kuboard 的 Live Demo 环境使用的是如下拓扑结构，本文档描述了如何在完成该 demo 环境的搭建。（在阿里云上，拥有一个3节点 Kubernetes 集群，每天的成本不超过12元，且，停机状态下不收费，非常适合于技术爱好者学习时使用。）
+  

 [领取阿里云最高2000元红包](https://promotion.aliyun.com/ntms/yunparter/invite.html?userCode=obezo3pg)

-[Kuboard Live Demo](http://demo.eip.work/#/login?isReadOnly=true&token=eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJrdWJvYXJkLXZpZXdlci10b2tlbi02djZiZiIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50Lm5hbWUiOiJrdWJvYXJkLXZpZXdlciIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50LnVpZCI6IjhiYTU3YmI1LWFiMTctNDM1NS1hNTM0LTQ0Njk4NGY0NzFlZiIsInN1YiI6InN5c3RlbTpzZXJ2aWNlYWNjb3VudDprdWJlLXN5c3RlbTprdWJvYXJkLXZpZXdlciJ9.DcXNIp0RKha1zkV4ga_QlGfcvMLGx2LOyzX-0VeboC3FojKFhxnfBeoda-zTeh6ugJlSM4kQYrRcof1Kx8Mg3-UgofNmgRySbDEVKtJZyMUoHqLmySKUIn8sbX8q83RNcqwcvY-fM8-w8HSuzU7Td7WWNuZrlCL4q_LQDYIBet1nlQ83YsENKNE8rsZQFDw8YM0MH6BEZLdwyhaboy_jjYbsU7kv8gks3aIX4lh1Fs9ZFQpC_6B0_MZvb7rEeG2M8QWXoUkDoL5JCKu6Wot5GlWf0kDMxIsViggP0NmSDTKh6kIvCkT2FZ2I4guEcjE_EjBpdOS6Abta22tzLlPKhg)
-为保证环境的稳定性，Live Demo 中只提供只读权限。<span style="color: #F56C6C; font-weight: 500;">（请在PC浏览器中打开）</span>
+Kuboard 的 Live Demo 环境使用的是如下拓扑结构，本文档描述了如何在完成该 demo 环境的搭建。

+完成安装后，对应的软件版本为：

+* Kubernetes v1.15.0
+* Docker 18.09.7

-![image-20190726144001775](./install-k8s.assets/image-20190726144001775.png)
+![image-20190726214032585](./install-k8s.assets/image-20190726214032585.png)


 ## 制作标准机镜像
@ -27,7 +28,7 @@ Kuboard 的 Live Demo 环境使用的是如下拓扑结构，本文档描述了
 标准机镜像中预装了如下内容：

  - docker
-  - gitlab-runner
+  - nfs-utils
  - kubernetes images

 ::: tip
@ -57,9 +58,7 @@ sudo yum remove docker \

 ```bash
 wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/containerd.io-1.2.6-3.3.el7.x86_64.rpm
-
 wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/docker-ce-cli-18.09.7-3.el7.x86_64.rpm
-
 wget https://download.docker.com/linux/centos/7/x86_64/stable/Packages/docker-ce-18.09.7-3.el7.x86_64.rpm
 ```

@ -99,7 +98,7 @@ docker version
 **执行安装命令**

 ```bash
-sudo yum install nfs-utils
+sudo yum install -y nfs-utils
 ```

 必须先安装 nfs-utils 才能挂载 nfs 网络存储
@ -119,19 +118,14 @@ enabled=1
 gpgcheck=0
 repo_gpgcheck=0
 gpgkey=http://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg
-        http://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
+       http://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
 EOF
 ```

-**关闭swap、防火墙**
+**关闭swap/SeLinux**

 ```bash
 swapoff -a
-```
-
-**关闭SeLinux**
-
-```bash
 setenforce 0
 ```

@ -246,9 +240,9 @@ docker tag 2c4adeb21b4f k8s.gcr.io/etcd:3.3.10

 ## 初始化 master 节点

-### 在 demo-master-a-1 机器上执行
-
-以下命令以 root 身份执行
+::: tip
+以 root 身份在 demo-master-a-1 机器上执行
+:::

 **配置 apiserver.demo 的域名**

@ -297,8 +291,6 @@ cp -i /etc/kubernetes/admin.conf /root/.kube/config

 **安装 calico**

-（需要在安全组–ServerFarm需要为集群服务器器端口6443建立安全组规则）
-
 ```bash
 kubectl apply -f \
 https://docs.projectcalico.org/v3.6/getting-started/kubernetes/installation/hosted/kubernetes-datastore/calico-networking/1.7/calico.yaml
@ -310,16 +302,16 @@ https://docs.projectcalico.org/v3.6/getting-started/kubernetes/installation/host

 **等待calico安装就绪：**

-执行如下命令，等待3-10分钟，直到所有的容器组处于 Running 状态
+执行如下命令，等待 3-10 分钟，直到所有的容器组处于 Running 状态

 ```bash
 watch kubectl get pod -n kube-system
 ```


-### 检查 apiserver初始化结果
+**检查 master 初始化结果**

-在第一个master节点 demo-master-a-1 上执行
+在 master 节点 demo-master-a-1 上执行

 ```bash
 kubectl get nodes
@ -360,9 +352,9 @@ kubeadm join apiserver.demo:6443 --token mpfjma.4vjjg8flqihor4vt     --discovery
 :::


-### 检查 apiserver初始化结果
+### 检查初始化结果

-在第一个master节点 demo-master-a-1 上执行
+在 master 节点 demo-master-a-1 上执行

 ```bash
 kubectl get nodes
@ -375,7 +367,7 @@ kubectl get nodes
 ## 移除 worker 节点

 ::: warning
-正常情况下，您无需移除 worker 节点
+正常情况下，您无需移除 worker 节点，如果添加到集群出错，您可以移除 worker 节点，再重新尝试添加
 :::

 在准备移除的 worker 节点上执行
@ -384,7 +376,7 @@ kubectl get nodes
 kubeadm reset
 ```

-在第一个 master 节点 demo-master-a-1 上执行
+在 master 节点 demo-master-a-1 上执行

 ```bash
 kubectl delete node demo-worker-x-x
@ -406,24 +398,32 @@ kubectl delete node demo-worker-x-x
 >
 > kubernetes支持多种Ingress Controllers，本文推荐使用 https://github.com/nginxinc/kubernetes-ingress

-
-### 在 demo-master-a-1 上执行
+**在 demo-master-a-1 上执行**

 ```bash
 kubectl apply -f https://raw.githubusercontent.com/eip-work/eip-monitor-repository/master/dashboard/nginx-ingress.yaml
 ```

-### 配置域名解析
+**配置域名解析**

-将域名 *.demo.yourdomain.com 解析到地址负载均衡服务器 的 IP 地址 z.z.z.z
+将域名 *.demo.yourdomain.com 解析到 demo-worker-a-2 的 IP 地址 z.z.z.z （也可以是 demo-worker-a-1 的地址 y.y.y.y）

-### 验证配置
+::: tip
+由于需要申请域名，过程会比较繁琐，有如下两种替代方案：
+
+* 在您的客户端机器（访问部署在K8S上的 web 应用的浏览器所在的机器）设置 hosts 配置；
+* 暂时放弃域名的配置，临时使用 NodePort 或者 `kubectl port-forward` 的方式访问部署在 K8S 上的 web 应用
+:::
+
+**验证配置**

 在浏览器访问 a.demo.yourdomain.com，将得到 404 NotFound 错误页面

+
 ## 下一步
 :tada: :tada: 

 您已经完成了 Kubernetes 集群的安装，下一步请：

+[从客户端电脑远程管理 Kubernetes](/install/install-kubectl)
 [安装 Kuboard](/install/install-dashboard)
--- a/install/install-kubectl.md
+++ b/install/install-kubectl.md
@ -0,0 +1,132 @@
+# 从客户端电脑远程管理 Kubernetes
+
+日常工作中，您可能需要在自己的笔记本电脑上执行 kubectl 命令管理远程 Linux 服务器上的 Kubernetes 集群。
+
+::: tip
+从客户端电脑使用 kubectl 远程管理 Kubernetes，这个步骤并不是使用 Kuboard 的必要步骤。<span style="color: red; font-weight: 500;">可以忽略</span>
+:::
+
+## 在客户端电脑安装 kubectl
+
+Kubernetes 官网文档参照 [安装 kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) 安装时，经常会失败，因为国内访问 google 的镜像仓库存在问题。
+
+请参考下述内容，完成 kubectl 的安装
+
+:::: tabs type:border-card
+
+::: tab Linux lazy
+
+**配置K8S的yum源**
+
+```bash
+cat <<EOF > /etc/yum.repos.d/kubernetes.repo
+[kubernetes]
+name=Kubernetes
+baseurl=http://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64
+enabled=1
+gpgcheck=0
+repo_gpgcheck=0
+gpgkey=http://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg
+       http://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
+EOF
+```
+
+**安装kubectl**
+
+```bash
+yum install -y kubectl-1.15.0
+```
+
+**验证安装**
+
+```bash
+kubectl version
+```
+
+:::
+
+::: tab Windows lazy
+待完善
+:::
+
+::: tab Mac lazy
+待完善
+:::
+
+::::
+
+## 获取 kubectl config 文件
+
+如果您参考 [安装 Kubernetes 单Master节点](install-k8s) 或 [安装 Kubernetes 高可用](install-kubernetes) 完成了 Kubernetes 安装，**请在 demo-master-a-1 节点上执行如下命令**
+
+```sh
+cat /etc/kubernetes/admin.conf
+```
+
+输出内容如下所示：
+
+```yaml {5}
+apiVersion: v1
+clusters:
+- cluster:
+    certificate-authority-data: LS0tLS1CRxpJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUN5RENDQWJDZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQjRYRFRFNU1EY3hPREEzTURFMU1Gb1hEVEk1TURjeE5UQTNNREUxTUZvd0ZURVRNQkVHQTFVRQpBeE1LYTNWaVpYSnVaWFJsY3pDQ0FTSXdEUVlKS29aSWxfY05BUUVCQlFBRGdnRVBBRENDQVFvQ2dnRUJBTUlvCit1TDVvWWFaMUc5UVR2SS9Cd0RNWWNNOTVqVkdNN2E1eWZIQWtBTVptOThWNGdDamNTd0NhOWFEbHJOKzliSUkKK054OXc3L0phdG1mb1ZwYlNoZ3dqc0lBT3QrTXlxQTh1WFVvMXlwSGFBd2NkaXhYbk81ZlVRRTlKN2xDbm9NZApKM0RYNmhNWnVmNmxwRVVBK2JkaVVTYzdkOEFKVDRpSm41bDAyL21pd3hRZUJweWwzQXFGVUZUQTQxUlNLbnBECjBuTzdoaEk3cE02aUVUTVBSa29lZkZrcHFtSEhqd0g5MGZQVzhETGgwdG5ENUlTM0VUUlVjMDdHbms0ZWh1OWMKamNhRXoxK1Roe3JhcWFTRmpTdUVSMGxhU3BYOXQyd3k1S3NxZFVBRkQySGNDK0Y1eUsvTXppL2krS01FdTM0SQpiTHJNUy90L3lta1V5RTQ3T3FrQ0F3RUFBYU1qTUNFd0RnWURWUjBQQVFIL0JBUURBZ0trTUE4R0ExVWRFd0VCCi93UUZ0QU1CQWY4d0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dFQkFFbXRORFVVZ2FhRWs3Z0lSMnE1MkRxZ21FRkMKZW1xR21rT3U5UERvVmZ0Z0Nva3VBUXEzZzBVdzA3cTJTQnhSZzJDNzQ2Y08wbkdURFZlL2ecXNmeVBFK2RFbApPQWJmQ3R1QUlKTHVQWDB6OVBUdDBKekhobnk1ODk5RE81ODdLMm5VdXd3S01xeEYvdWRHMUNtWUkza2g2cS9RCmN0WDI5RjlhTWhDRXluWU1lVU5EUVQ4cGN0TkOpNm4rYjg0NDlmMU5RWG9kVzM0TVRrL25pd3JuQ3pDUUE5M0wKR3YxelhRL2pwTTZVeVo5dU9ZNWEzK096UjJCTzRtZ2RiL0xoam5rL0hxTGs5RUszZmhJak5Tc2h0RWsrf9NpVApPQ3JTQkRHVk5ueHIzeGRwYzltRWNCeDlQdVBqVE1ER1ZkYlowUlZHbGVVODN3dVpUaTdJdUZaR2Jicz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
+    server: https://apiserver.demo:6443
+  name: kubernetes
+contexts:
+- context:
+    cluster: kubernetes
+    user: kubernetes-admin
+  name: kubernetes-admin@kubernetes
+current-context: kubernetes-admin@kubernetes
+kind: Config
+preferences: {}
+users:
+- name: kubernetes-admin
+  user:
+    client-certificate-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUM4akNDQxxRxZ0F3SUJBZ0lJY0JpMFhjUWJNWm93RFFZSktvWklodmNOQVFFTEJRQXdGVEVUTUJFR0ExVUUKQXhNS2EzVmlaWEp1WlhSbGN6QWVGdzB4T1RBM01UZ3dOekF4TlRCYUZ3MHlNREEzTVRjd056QXhOVEZhTURReApGekFWQmdOVkJBb1REbk41YzNSbGJUcHRZWE4wWlhKek1Sa3dGd1lEVlFRREV4QnJkV0psY201bGRHVnpMV0ZrCmJXbHVNSUlCSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQW9CYzZvMHRCekIyRUlldW4KcmhONTVoaU1EaEplcUpxMWxlT3VUSjRic0dqVnlrQVJQVCtGZDlTR3llRjNFZS9NS1ZBcUQ4ZzRXeHNoTTRrdAp1dnVNalNTeit3bnMySnR2TWtJWStLT2FhZFBFSUx6U3dyamxucGRQbjMvQmtTbjc1SnVzRWFLR0NCN0c5Skk3CnJOK3lkc2ZLT29KQTE1ak8vR2VvdC90UGpWNGQ4MldCbVltWitSa1labW43STFPOHh4aFpjVDNDT0QxeVp3OS8KTjBYVnZQYkFzY1QweU91ZG5JMWpFQ3p1cHdKWnZRTENiMEJHb1MxSGxpVDFnL1o0WjBuYW5LdythYkdXamptNQpGbmZTZ2JQblNzOTI5NWNzQW5KQy9MRXZFTE90NEUxQkVHa2JkZTBuNXJnKzhKVjhDOWFPWkFOxhP2aU5iMExuCkdpQ2p6UUlEQVFBQm95Y3dKVEFPQmdOVkhROEJBZjhFQkFNQ0JhQXdFd1lEVlIwbEJBd3dDZ1lJS3dZQkJRVUgKQXdJd0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dFQkFJYnd3RFJ6VExUbXNrV3R0NEZLbG1xK0NNYTRWZUFqL2x4bQpuaEdITTlTaXpFR1VDRDJ5UjEyQUV0YUdka0R5KzNuT3Q3aS9Db3Jwcm5ocnkwZHMzck81Q3BvMXAwdHNyQnZ5CkRiM1dDTDRkN2x0alplNklZQ0xGNmJCVkJmejJjY0FpZEdieW1UaVhwQU5pK25hOE8wZ3NBTmNUS1JaNG1nNDgKUXpWQktlUnZZWnhwcEV5T2JoelI2NTVoRE1aR3AzdG5pQW9NL3Z6QjA3R2dybzAxVTAvaUVOQnZaeG10S2RxRApFY0JVTzJRTHh3QlZaMFlMb0p2MmJWSTVMYWdmRDNwVFVDQ3A5MURGcDAwbmVHRUM0cDZmQXJwSG9YWU8yYVIyCjZtbEREdVhGNmg2Um53frkxU3N6MWZtSXVzZ2FXaHZUaGgrVGxQVVVTclFkZnQ2S0d4bz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
+    client-key-data: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFb2dJQkFBS0NBUUVBb0JjNm8wdEJ6QjJFSWV1bnJoTjU1aGlNRGhKZXFKcTFsZU91VEo0YnNHalZ5a0FSClBUK0ZkOVNHeWVGM0VlL01LVkFxRDhnNFd4c2hNNGt0dXZ1TWpTU3ord25zMkp0dk1rSVkrS09hYWRQRUlMelMKd3JqbG5wZFBuMy9Ca1NuNzVKdXNFYUtHQ0I3RzlKSTdyTit5ZHNmS09vSkExNWpPL0dlb3QvdFBqVjRkODJXQgptWW1aK1JrWVptbjdJMU84eHhoWmNUM0NPRDF5Wnc5L04wWFZ2UGJBc2NUMHlPdWRuSTFqRUN6dXB3Slp2UUxDCmIwQkdvUzFIbGlUMWcvWjRaMG5hbkt3K2FiR1dqam01Rm5mU2diUG5TczkyOTVjc0FuSkMvTEV2RUxPdDRFMUIKRUdrYmRlMG41cmcrOEpWOEM5YU9aQU5NRHZpTmIwTG5HaUNqelFJREFRQUJBb0lCQUFPOHh4ZXMyQnBsemdIawp1SU50M1Bpc05naldFUE9xdVBhSTNEYlpzaGZLT3NOLy8yY0lwcHNIa1NZQlo0QTVzdkI3K0o5cHN6Y2RTUWNrCityWlV6UkUyZkNVdU5DTlNiYVXsdXVTREhVVy9OZUwxeFkzYU56SWVvak05RGszUFJ4d3RMalV6TUNIY1poU3IKblUwSjQrYTEvMWlpVmRVeXNoSmVjU2ZxYkE4R3pBUlpLUjlYdDZlU01qQXZqdlp4QUtVMVFYWDlHL3JPNnRqUwpXNjJ5aTlkaG5vYjRBR3ovTlhmN29JZld0dW9SUTcxOFdmxm5kZWZYeVp6MnNwc3V4ZGttRUtrQW9qZ2NqbjI3CnRCeFBlUFcveWRqQ3IzTTA3WGVWVDAyaG5UQXptVnFtcUFhbG5rYkpqT0Z5dkQxNE5Cck9Lc2FoK21CUkZLTUEKSjErdUlZRUNnWUVBeTNCZGMrNTJ0SkhGQm8vL1BjU0FMOHhRQVZXTjFoakZ1Nk1BY2Q5WVF6NkhWNWdDYU1oQwpUWFZrNmt5TC9qcEdYS1E1MmVpbTBrOFUvYWc2VXVlV0Uzek45ZDJ3ci9oeDljUjFLUUxmMlpJUmNrN3ZTRUhnEct0ejFWVlhMRDZBTHlKeThGRHhMbFV0ZGRJb3R6YUNOM1d2UXhybTRYV2pCYi82UnBDQTlWLzBDZ1lFQXlYUEcKaldxdXEvYnFCMlphMGNpVUh5NnJIbGQrRVBKNXg0cWlRc0JaUnpZK085TmxuajJnaU5lcU9mRHVjeU5yQ2JBRwo2RkRSTkMrdG9TVVVpWWhtNmgyeXpuc3JOS0pQbHdqN2VGQ1JadFFSb0ErSHpWajBaTnRuQjBNRnhzcUsyeTdSClGnVVlXWmRaTmJSSFVyeTJ0VFk3RHM5UHlITncyU2p5ZERJd3ZCRUNnWUFOczYyM3B6SDdpMjNYdVU4Vm0raCsKVDZaNzBJVlREQ3dWTFM5VWZCUjN3dmhlbi9CWm1sTk00RUZCdnBJWE4xbVIxOFhGdFhPMjZuaWhkUGtvcUV4bApWNXlQbUxUVHhVbjNvWm02ZjJVUVJGUkVmS2lGRjFyR3lYY0VubGlrM3NTc2FGSUtrdDBNV3gwYVFrdy9jemJhCjJPNGcxRlZraFMreUdWVTUxcW9MQ1FLQmdDOHdwN3BJMjFIOUxTVStuTmUzbkxzUk81U0gra2dPQk9qeFdNRTYKUGErb3pUdEdjZTkza0R0K0NhbzQvaUtLa1hCYmc4SzM2OG5Gd1c2V09SRmVtbjBOSisybWZLQi94UlVrVFlRSgptNFh5OTQzL0ZWak5GYkxxa2wvcEcxbE42T2tmTm5rRCtBaEVvK2tvcWc4cTljSE5TbGhWeCtLMDZDSjJyUlQ3CkROK0JBb0dB63h1R3g5OHc0MENESWlHWmhDWGY0ZTRxTllWdVhTcm9YTDVpeWFKTDZka3BLSE9UUk5VSlBmSVYKZ1FDMy9rN0xYZkFjbTNqTktSS1huQ2cveWxTd2N6RjFGYkZKb1hjNW9ackc5TE8yQXNSdGcxanByN1ZpRlZNYwo0LzB5cEFSTmJqRzA4Y0I5bzBrbVBjUVExUHd4Q05EeXVONVRQYzRKejN3OHR5SnhTN289Ci0tLS0tRU5EIFJTQSBQUklWQVRFIEtFWS0tLS0tCg==
+```
+
+## 配置 kubectl 客户端
+
+在客户端电脑完成如下配置，即可远程管理 Kubernetes 集群
+
+:::: tabs type:border-card
+
+::: tab Linux lazy
+
+**执行命令**
+
+```sh
+vi ~/.kube/config
+```
+
+将前面获得的 `/etc/kubernetes/admin.conf` 文件的内容粘贴进该文件并保存
+
+**配置 hosts**
+
+```sh
+echo "x.x.x.x    apiserver.demo" >> /etc/hosts
+```
+
+> * 将 x.x.x.x 替换成 demo-master-a-1 的实际 IP 地址
+> * 将 apiserver.demo 替换成前面获得 `/etc/kubernetes/admin.conf` 文件中 `clusters/cluster/server` 中 URL 里 host 对应的部分
+
+**验证安装结果**
+
+执行命令
+
+```sh
+kubectl get nodes
+kubectl get pods -n kube-system
+```
+
+::: tab Windows lazy
+待完善
+:::
+
+::: tab Mac lazy
+待完善
+:::
+
+::::
--- a/install/install-kubernetes.md
+++ b/install/install-kubernetes.md
@ -1,6 +1,6 @@
 # 安装 Kubernetes 高可用

-::: danger
+::: tip
 推荐初学者按照 [安装Kubernetes 单Master节点](install-k8s) 文档进行 Kubernetes 集群搭建
 :::