From 0dcc67da1c53aad3b8effacfb4f27d7ddc677196 Mon Sep 17 00:00:00 2001 From: Kang HuaiShuai Date: Tue, 31 Dec 2019 20:26:22 +0800 Subject: [PATCH] Add kubeadm, close #438 Signed-off-by: Kang HuaiShuai --- .github/workflows/ci.yaml | 4 +- .vuepress/config.js | 3 +- CHANGELOG.md | 2 + SUMMARY.md | 3 +- kubernetes/setup/README.md | 4 +- kubernetes/setup/docker.md | 91 ------------------ kubernetes/setup/kubeadm.md | 183 ++++++++++++++++++++++++++++++++++++ kubernetes/setup/systemd.md | 3 + 8 files changed, 197 insertions(+), 96 deletions(-) delete mode 100644 kubernetes/setup/docker.md create mode 100644 kubernetes/setup/kubeadm.md create mode 100644 kubernetes/setup/systemd.md diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index dab00ad..9c2d25d 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -30,7 +30,7 @@ jobs: PCIT_EMAIL: khs1994@khs1994.com PCIT_GIT_TOKEN: ${{ secrets.PCIT_GIT_TOKEN }} PCIT_GIT_URL: github.com/docker-practice/vuepress - PCIT_KEEP_HISTORY: "1" + PCIT_KEEP_HISTORY: "true" PCIT_LOCAL_DIR: .vuepress/dist PCIT_MESSAGE: Sync from yeasy/docker_practice@${{github.sha}} by PCIT PCIT_TARGET_BRANCH: master @@ -45,7 +45,7 @@ jobs: PCIT_EMAIL: khs1994@khs1994.com PCIT_GIT_TOKEN: ${{ secrets.CODING_GIT_TOKEN }} PCIT_GIT_URL: git.dev.tencent.com/khs1994/docker_practice - PCIT_KEEP_HISTORY: "1" + PCIT_KEEP_HISTORY: "true" PCIT_LOCAL_DIR: .vuepress/dist PCIT_MESSAGE: Sync from yeasy/docker_practice@${{github.sha}} by PCIT PCIT_TARGET_BRANCH: master diff --git a/.vuepress/config.js b/.vuepress/config.js index d6c2bd8..625705b 100644 --- a/.vuepress/config.js +++ b/.vuepress/config.js @@ -109,8 +109,9 @@ module.exports = { collapsable: false, children: [ "setup/", - "setup/docker", + "setup/kubeadm", "setup/docker-desktop", + "setup/systemd", ] }, { diff --git a/CHANGELOG.md b/CHANGELOG.md index dd7d2e5..2e04a3d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,7 @@ # 修订记录 +* 1.2.0 2020-12-31 + * 1.1.0 2019-12-31 * 全面支持 v19.x 新版本 * 增加 `BuildKit` diff --git a/SUMMARY.md b/SUMMARY.md index 54fb472..07697d1 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -121,8 +121,9 @@ * [基本概念](kubernetes/concepts.md) * [架构设计](kubernetes/design.md) * [部署 Kubernetes](kubernetes/setup/README.md) - * [使用 Docker 容器部署](kubernetes/setup/docker.md) + * [使用 kubeadm 部署 kubernetes](kubernetes/setup/kubeadm.md) * [在 Docker Desktop 使用](kubernetes/setup/docker-desktop.md) + * [一步步部署 kubernetes 集群](kubernetes/setup/systemd.md) * [Kubernetes 命令行 kubectl](kubernetes/kubectl/README.md) * [容器与云计算](cloud/README.md) * [简介](cloud/intro.md) diff --git a/kubernetes/setup/README.md b/kubernetes/setup/README.md index 1cb311e..f6bc2ff 100644 --- a/kubernetes/setup/README.md +++ b/kubernetes/setup/README.md @@ -4,6 +4,8 @@ 你可以使用以下几种方式部署 Kubernetes： -* Docker 容器 +* kubeadm +* docker-desktop +* k3s 接下来的小节会对以上几种方式进行详细介绍。 diff --git a/kubernetes/setup/docker.md b/kubernetes/setup/docker.md deleted file mode 100644 index fede455..0000000 --- a/kubernetes/setup/docker.md +++ /dev/null @@ -1,91 +0,0 @@ -# 使用 Docker 容器部署 Kubernetes - -最快速体验 Kubernetes 的方式就是在本地通过 Docker 的方式来启动相关进程。 - -下图展示了在单节点使用 Docker 快速部署一套 Kubernetes 的拓扑。 - -![在 Docker 中启动 Kubernetes](_images/k8s-singlenode-docker.png) - -Kubernetes 依赖 Etcd 服务来维护所有主节点的状态。 - -## 启动 Etcd 服务 - -```bash -docker run --net=host -d gcr.io/google_containers/etcd:2.0.9 /usr/local/bin/etcd --addr=127.0.0.1:4001 --bind-addr=0.0.0.0:4001 --data-dir=/var/etcd/data -``` - -## 启动主节点 - -启动 kubelet。 - -```bash -docker run --net=host -d -v /var/run/docker.sock:/var/run/docker.sock gcr.io/google_containers/hyperkube:v0.17.0 /hyperkube kubelet --api_servers=http://localhost:8080 --v=2 --address=0.0.0.0 --enable_server --hostname_override=127.0.0.1 --config=/etc/kubernetes/manifests -``` - -## 启动服务代理 - -```bash -docker run -d --net=host --privileged gcr.io/google_containers/hyperkube:v0.17.0 /hyperkube proxy --master=http://127.0.0.1:8080 --v=2 -``` - -## 测试状态 - -在本地访问 `8080` 端口，可以获取到如下的结果： - -```bash -$ curl 127.0.0.1:8080 -{ - "paths": [ - "/api", - "/api/v1beta1", - "/api/v1beta2", - "/api/v1beta3", - "/healthz", - "/healthz/ping", - "/logs/", - "/metrics", - "/static/", - "/swagger-ui/", - "/swaggerapi/", - "/validate", - "/version" - ] -} -``` - -## 查看服务 - -所有服务启动后，查看本地实际运行的 Docker 容器，有如下几个。 - -```bash -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -ee054db2516c gcr.io/google_containers/hyperkube:v0.17.0 "/hyperkube schedule 2 days ago Up 1 days k8s_scheduler.509f29c9_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_e97037f5 -3b0f28de07a2 gcr.io/google_containers/hyperkube:v0.17.0 "/hyperkube apiserve 2 days ago Up 1 days k8s_apiserver.245e44fa_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_6ab5c23d -2eaa44ecdd8e gcr.io/google_containers/hyperkube:v0.17.0 "/hyperkube controll 2 days ago Up 1 days k8s_controller-manager.33f83d43_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_1a60106f -30aa7163cbef gcr.io/google_containers/hyperkube:v0.17.0 "/hyperkube proxy -- 2 days ago Up 1 days jolly_davinci -a2f282976d91 gcr.io/google_containers/pause:0.8.0 "/pause" 2 days ago Up 2 days k8s_POD.e4cc795_k8s-master-127.0.0.1_default_9941e5170b4365bd4aa91f122ba0c061_e8085b1f -c060c52acc36 gcr.io/google_containers/hyperkube:v0.17.0 "/hyperkube kubelet 2 days ago Up 1 days serene_nobel -cc3cd263c581 gcr.io/google_containers/etcd:2.0.9 "/usr/local/bin/etcd 2 days ago Up 1 days happy_turing -``` - -这些服务大概分为三类：主节点服务、工作节点服务和其它服务。 - -### 主节点服务 - -* `apiserver` 是整个系统的对外接口，提供 RESTful 方式供客户端和其它组件调用； - -* `scheduler` 负责对资源进行调度，分配某个 pod 到某个节点上； - -* `controller-manager` 负责管理控制器，包括 endpoint-controller（刷新服务和 pod 的关联信息）和 replication-controller（维护某个 pod 的复制为配置的数值）。 - -### 工作节点服务 - -* `kubelet` 是工作节点执行操作的 agent，负责具体的容器生命周期管理，根据从数据库中获取的信息来管理容器，并上报 pod 运行状态等； - -* `proxy` 为 pod 上的服务提供访问的代理。 - -### 其它服务 - -* Etcd 是所有状态的存储数据库； - -* `gcr.io/google_containers/pause:0.8.0` 是 Kubernetes 启动后自动 pull 下来的测试镜像。 diff --git a/kubernetes/setup/kubeadm.md b/kubernetes/setup/kubeadm.md new file mode 100644 index 0000000..f999b0d --- /dev/null +++ b/kubernetes/setup/kubeadm.md @@ -0,0 +1,183 @@ +# 使用 kubeadm 部署 kubernetes + +`kubeadm` 提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建 `kubernetes` 集群的最佳实践。 + +## 安装 Docker + +参考 [安装 Docker](../../install) 一节安装 Docker。 + +## 安装 **kubelet** **kubeadm** **kubectl** + +### Ubuntu/Debian + +```bash +$ apt-get update && apt-get install -y apt-transport-https +$ curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | apt-key add - + +$ cat < 执行可能出现错误，例如缺少依赖包，根据提示安装即可。 + +执行成功会输出 + +```bash +... +[addons] Applied essential addon: CoreDNS +I1116 12:35:13.270407 86677 request.go:538] Throttling request took 181.409184ms, request: POST:https://192.168.199.100:6443/api/v1/namespaces/kube-system/serviceaccounts +I1116 12:35:13.470292 86677 request.go:538] Throttling request took 186.088112ms, request: POST:https://192.168.199.100:6443/api/v1/namespaces/kube-system/configmaps +[addons] Applied essential addon: kube-proxy + +Your Kubernetes control-plane has initialized successfully! + +To start using your cluster, you need to run the following as a regular user: + + mkdir -p $HOME/.kube + sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config + sudo chown $(id -u):$(id -g) $HOME/.kube/config + +You should now deploy a pod network to the cluster. +Run "kubectl apply -f [podnetwork].yaml" with one of the options listed at: + https://kubernetes.io/docs/concepts/cluster-administration/addons/ + +Then you can join any number of worker nodes by running the following on each as root: + +kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \ + --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe +``` + +### node 工作节点 + +在 **另一主机** 重复 **部署** 小节以前的步骤，安装配置好 kubelet。根据提示，加入到集群。 + +```bash +$ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \ + --discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe +``` + +## 查看服务 + +所有服务启动后，查看本地实际运行的 Docker 容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。 + +### 主节点服务 + +* `apiserver` 是整个系统的对外接口，提供 RESTful 方式供客户端和其它组件调用； + +* `scheduler` 负责对资源进行调度，分配某个 pod 到某个节点上； + +* `controller-manager` 负责管理控制器，包括 endpoint-controller（刷新服务和 pod 的关联信息）和 replication-controller（维护某个 pod 的复制为配置的数值）。 + +### 工作节点服务 + +* `proxy` 为 pod 上的服务提供访问的代理。 + +### 其它服务 + +* Etcd 是所有状态的存储数据库； + +## 使用 + +将 `/etc/kubernetes/admin.conf` 复制到 `~/.kube/config` + +执行 `$ kubectl get all -A` 查看启动的服务。 + +由于未部署 CNI 插件，CoreDNS 未正常启动。如何使用 Kubernetes，请参考后续章节。 + +## 部署 CNI + +这里以 `flannel` 为例进行介绍。 + +### flannel + +检查 podCIDR 设置 + +```bash +$ kubectl get node -o yaml | grep CIDR + +# 输出 + podCIDR: 10.244.0.0/24 + podCIDRs: +``` + +```bash +$ kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.11.0/Documentation/kube-flannel.yml +``` + +## master 节点默认不能运行 pod + +如果用 `kubeadm` 部署一个单节点集群，默认情况下无法使用，请执行以下命令解除限制 + +```bash +$ kubectl taint nodes --all node-role.kubernetes.io/master- + +# 恢复默认值 +# $ kubectl taint nodes NODE_NAME node-role.kubernetes.io/master=true:NoSchedule +``` diff --git a/kubernetes/setup/systemd.md b/kubernetes/setup/systemd.md new file mode 100644 index 0000000..a3ae99f --- /dev/null +++ b/kubernetes/setup/systemd.md @@ -0,0 +1,3 @@ +# 一步步部署 kubernetes 集群 + +可以参考 [opsnull/follow-me-install-kubernetes-cluster](https://github.com/opsnull/follow-me-install-kubernetes-cluster) 项目一步步部署 kubernetes 集群。