ehlxr/docker_practice
1
0
Fork 0
mirror of https://github.com/yeasy/docker_practice.git synced 2026-03-12 04:41:17 +00:00
Code Issues Projects Releases Wiki Activity

Use a better structure

Browse Source
This commit is contained in:
Baohua Yang
2026-02-09 09:32:05 -08:00
parent fdb879dcf2
commit e669ee0fe8
167 changed files with 2462 additions and 2462 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
11_orchestration/setup/README.md
View File

@@ -1,4 +1,4 @@
# 部署 Kubernetes
## 部署 Kubernetes
目前，Kubernetes 支持在多种环境下使用，包括本地主机（Ubuntu、Debian、CentOS、Fedora 等）、云服务（[腾讯云](https://cloud.tencent.com/act/cps/redirect?redirect=10058&cps_key=3a5255852d5db99dcd5da4c72f05df61)、[阿里云](https://www.aliyun.com/product/kubernetes?source=5176.11533457&userCode=8lx5zmtu&type=copy)、[百度云](https://cloud.baidu.com/product/cce.html) 等）。

10
11_orchestration/setup/dashboard.md
View File

@@ -1,10 +1,10 @@
# Kubernetes Dashboard
## Kubernetes Dashboard
[Kubernetes Dashboard](https://github.com/kubernetes/dashboard) 是基于网页的 Kubernetes 用户界面。
![](https://d33wubrfki0l68.cloudfront.net/349824f68836152722dab89465835e604719caea/6e0b7/images/docs/ui-dashboard.png)
## 部署
### 部署
执行以下命令即可部署 Dashboard：
@@ -12,7 +12,7 @@
kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.0.0/aio/deploy/recommended.yaml
```
## 访问
### 访问
通过命令行代理访问，执行以下命令：
@@ -22,7 +22,7 @@ $ kubectl proxy
到 http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/ 即可访问。
## 登录
### 登录
目前，Dashboard 仅支持使用 Bearer 令牌登录。下面教大家如何创建该令牌：
@@ -40,6 +40,6 @@ echo ${DASHBOARD_LOGIN_TOKEN}
将结果粘贴到登录页面，即可登录。
## 参考文档
### 参考文档
* [官方文档](https://kubernetes.io/zh/docs/tasks/access-application-cluster/web-ui-dashboard/)

6
11_orchestration/setup/docker-desktop.md
View File

@@ -1,8 +1,8 @@
# Docker Desktop 启用 Kubernetes
## Docker Desktop 启用 Kubernetes
使用 Docker Desktop 可以很方便的启用 Kubernetes。
## 启用 Kubernetes
### 启用 Kubernetes
在 Docker Desktop 设置页面，点击 `Kubernetes`，选择 `Enable Kubernetes`，稍等片刻，看到左下方 `Kubernetes` 变为 `running`，Kubernetes 启动成功。
@@ -10,7 +10,7 @@
> 注意：Kubernetes 的镜像存储在 `registry.k8s.io`，如果国内网络无法直接访问，可以在 Docker Desktop 配置中的 `Docker Engine` 处配置镜像加速器，或者利用国内云服务商的镜像仓库手动拉取镜像并 retag。
## 测试
### 测试
```bash
$ kubectl version

18
11_orchestration/setup/k3s.md
View File

@@ -1,17 +1,17 @@
# K3s - 轻量级 Kubernetes
## K3s - 轻量级 Kubernetes
[K3s](https://k3s.io/) 是一个轻量级的 Kubernetes 发行版，由 Rancher Labs 开发。它专为边缘计算、物联网、CI、ARM 等资源受限的环境设计。K3s 被打包为单个二进制文件，只有不到 100MB，但通过了 CNCF 的一致性测试。
## 核心特性
### 核心特性
* **轻量级**：移除过时的、非必须的 Kubernetes 功能（如传统的云提供商插件），使用 SQLite 作为默认数据存储（也支持 Etcd/MySQL/Postgres）。
* **单一二进制**：所有组件（API Server, Controller Manager, Scheduler, Kubelet, Kube-proxy）打包在一个进程中运行。
* **开箱即用**：内置 Helm Controller、Traefik Ingress controller、ServiceLB、Local-Path-Provisioner。
* **安全**：默认启用安全配置，基于 TLS 通信。
## 安装
### 安装
### 脚本安装（Linux）
#### 脚本安装（Linux）
K3s 提供了极为便捷的安装脚本：
@@ -21,7 +21,7 @@ curl -sfL https://get.k3s.io | sh -
安装完成后，K3s 会自动启动并配置好 `systemd` 服务。
### 查看状态
#### 查看状态
```bash
sudo k3s kubectl get nodes
@@ -33,19 +33,19 @@ NAME STATUS ROLES AGE VERSION
k3s-master Ready control-plane,master 1m v1.28.2+k3s1
```
## 快速使用
### 快速使用
K3s 内置了 `kubectl` 命令（通过 `k3s kubectl` 调用），为了方便，通常会建立别名或配置 `KUBECONFIG`。
```bash
# 读取 K3s 的配置文件
## 读取 K3s 的配置文件
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
# 现在可以直接使用 kubectl
## 现在可以直接使用 kubectl
kubectl get pods -A
```
## 清理卸载
### 清理卸载
```bash
/usr/local/bin/k3s-uninstall.sh

20
11_orchestration/setup/kind.md
View File

@@ -1,34 +1,34 @@
# Kind - Kubernetes IN Docker
## Kind - Kubernetes IN Docker
[Kind](https://kind.sigs.k8s.io/) (Kubernetes in Docker) 是一个使用 Docker 容器作为节点运行本地 Kubernetes 集群的工具。主要用于测试 Kubernetes 本身，也非常适合本地开发和 CI 环境。
## 为什么选择 Kind
### 为什么选择 Kind
* **轻量便捷**：只要有 Docker 环境即可，无需额外虚拟机。
* **多集群支持**：可以轻松在本地启动多个集群。
* **多版本支持**：支持指定 Kubernetes 版本进行测试。
* **HA 支持**：支持模拟高可用集群（多 Control Plane）。
## 安装 Kind
### 安装 Kind
### macOS
#### macOS
```bash
brew install kind
```
### Linux / Windows (WSL2)
#### Linux / Windows (WSL2)
可以下载二进制文件：
```bash
# Linux AMD64
## Linux AMD64
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.20.0/kind-linux-amd64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind
```
## 创建集群
### 创建集群
最简单的创建方式：
@@ -42,7 +42,7 @@ kind create cluster
kind create cluster --name my-cluster
```
## 与集群交互
### 与集群交互
Kind 会自动将 kubeconfig 合并到 `~/.kube/config`。
@@ -51,7 +51,7 @@ kubectl cluster-info --context kind-kind
kubectl get nodes
```
## 高级用法：配置集群
### 高级用法：配置集群
创建一个 `kind-config.yaml` 来定制集群，例如映射端口到宿主机：
@@ -74,7 +74,7 @@ nodes:
kind create cluster --config kind-config.yaml
```
## 删除集群
### 删除集群
```bash
kind delete cluster

50
11_orchestration/setup/kubeadm-docker.md
View File

@@ -1,14 +1,14 @@
# 使用 kubeadm 部署 kubernetes(使用 Docker)
## 使用 kubeadm 部署 kubernetes(使用 Docker)
`kubeadm` 提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建 `kubernetes` 集群的最佳实践。
## 安装 Docker
### 安装 Docker
参考 [安装 Docker](../../install) 一节安装 Docker。
## 安装 **kubelet** **kubeadm** **kubectl**
### 安装 **kubelet** **kubeadm** **kubectl**
### Ubuntu/Debian
#### Ubuntu/Debian
```bash
$ apt-get update && apt-get install -y apt-transport-https
@@ -22,7 +22,7 @@ $ apt-get update
$ apt-get install -y kubelet kubeadm kubectl
```
### CentOS/Fedora
#### CentOS/Fedora
```bash
$ cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
@@ -38,7 +38,7 @@ EOF
$ sudo yum install -y kubelet kubeadm kubectl
```
## 修改内核的运行参数
### 修改内核的运行参数
```bash
$ cat <<EOF | sudo tee /etc/sysctl.d/99-kubernetes-cri.conf
@@ -47,18 +47,18 @@ net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
EOF
# 应用配置
## 应用配置
$ sysctl --system
```
## 配置 kubelet
### 配置 kubelet
### 修改 `kubelet.service`
#### 修改 `kubelet.service`
`/etc/systemd/system/kubelet.service.d/10-proxy-ipvs.conf` 写入以下内容
```bash
# 启用 ipvs 相关内核模块
## 启用 ipvs 相关内核模块
[Service]
ExecStartPre=-/sbin/modprobe ip_vs
ExecStartPre=-/sbin/modprobe ip_vs_rr
@@ -72,9 +72,9 @@ ExecStartPre=-/sbin/modprobe ip_vs_sh
$ sudo systemctl daemon-reload
```
## 部署
### 部署
### master
#### master
```bash
$ sudo kubeadm init --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
@@ -114,7 +114,7 @@ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
--discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
```
### node 工作节点
#### node 工作节点
在 **另一主机** 重复 **部署** 小节以前的步骤，安装配置好 kubelet。根据提示，加入到集群。
@@ -123,11 +123,11 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
--discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
```
## 查看服务
### 查看服务
所有服务启动后，查看本地实际运行的 Docker 容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
### 主节点服务
#### 主节点服务
* `apiserver` 是整个系统的对外接口，提供 RESTful 方式供客户端和其它组件调用；
@@ -135,15 +135,15 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
* `controller-manager` 负责管理控制器，包括 endpoint-controller（刷新服务和 pod 的关联信息）和 replication-controller（维护某个 pod 的复制为配置的数值）。
### 工作节点服务
#### 工作节点服务
* `proxy` 为 pod 上的服务提供访问的代理。
### 其它服务
#### 其它服务
* Etcd 是所有状态的存储数据库；
## 使用
### 使用
将 `/etc/kubernetes/admin.conf` 复制到 `~/.kube/config`
@@ -151,18 +151,18 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
由于未部署 CNI 插件，CoreDNS 未正常启动。如何使用 Kubernetes，请参考后续章节。
## 部署 CNI
### 部署 CNI
这里以 `flannel` 为例进行介绍。
### flannel
#### flannel
检查 podCIDR 设置
```bash
$ kubectl get node -o yaml | grep CIDR
# 输出
## 输出
podCIDR: 10.244.0.0/16
podCIDRs:
```
@@ -171,17 +171,17 @@ $ kubectl get node -o yaml | grep CIDR
$ kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.11.0/Documentation/kube-flannel.yml
```
## master 节点默认不能运行 pod
### 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
## 恢复默认值
## $ kubectl taint nodes NODE_NAME node-role.kubernetes.io/master=true:NoSchedule
```
## 参考文档
### 参考文档
* [官方文档](https://kubernetes.io/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)

70
11_orchestration/setup/kubeadm.md
View File

@@ -1,22 +1,22 @@
# 使用 kubeadm 部署 kubernetes(CRI 使用 containerd)
## 使用 kubeadm 部署 kubernetes(CRI 使用 containerd)
`kubeadm` 提供了 `kubeadm init` 以及 `kubeadm join` 这两个命令作为快速创建 `kubernetes` 集群的最佳实践。
> **版本说明**：Kubernetes 版本更新较快（约每 4 个月一个新版本），本文档基于 Kubernetes 1.35 编写。请访问 [Kubernetes 官方发布页](https://kubernetes.io/releases/) 获取最新版本信息。
## 安装 containerd
### 安装 containerd
参考 [安装 Docker](../../install) 一节添加 apt/yum 源，之后执行如下命令。
```bash
# debian 系
## debian 系
$ sudo apt install containerd.io
# rhel 系
## rhel 系
$ sudo yum install containerd.io
```
## 配置 containerd
### 配置 containerd
新建 `/etc/systemd/system/cri-containerd.service` 文件
@@ -35,13 +35,13 @@ Delegate=yes
KillMode=process
Restart=always
RestartSec=5
# Having non-zero Limit*s causes performance problems due to accounting overhead
# in the kernel. We recommend using cgroups to do container-local accounting.
## Having non-zero Limit*s causes performance problems due to accounting overhead
## in the kernel. We recommend using cgroups to do container-local accounting.
LimitNPROC=infinity
LimitCORE=infinity
LimitNOFILE=infinity
# Comment TasksMax if your systemd version does not supports it.
# Only systemd 226 and above support this version.
## Comment TasksMax if your systemd version does not supports it.
## Only systemd 226 and above support this version.
TasksMax=infinity
OOMScoreAdjust=-999
@@ -53,14 +53,14 @@ WantedBy=multi-user.target
```toml
version = 2
# persistent data location
## persistent data location
root = "/var/lib/cri-containerd"
# runtime state information
## runtime state information
state = "/run/cri-containerd"
plugin_dir = ""
disabled_plugins = []
required_plugins = []
# set containerd's OOM score
## set containerd's OOM score
oom_score = 0
[grpc]
@@ -201,9 +201,9 @@ oom_score = 0
async_remove = false
```
## 安装 **kubelet** **kubeadm** **kubectl** **cri-tools** **kubernetes-cni**
### 安装 **kubelet** **kubeadm** **kubectl** **cri-tools** **kubernetes-cni**
### Ubuntu/Debian
#### Ubuntu/Debian
```bash
$ apt-get update && apt-get install -y apt-transport-https
@@ -217,7 +217,7 @@ $ apt-get update
$ apt-get install -y kubelet kubeadm kubectl
```
### CentOS/Fedora
#### CentOS/Fedora
```bash
$ cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
@@ -233,7 +233,7 @@ EOF
$ sudo yum install -y kubelet kubeadm kubectl
```
## 修改内核的运行参数
### 修改内核的运行参数
```bash
$ cat <<EOF | sudo tee /etc/sysctl.d/99-kubernetes-cri.conf
@@ -242,18 +242,18 @@ net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
EOF
# 应用配置
## 应用配置
$ sysctl --system
```
## 配置 kubelet
### 配置 kubelet
### 修改 `kubelet.service`
#### 修改 `kubelet.service`
`/etc/systemd/system/kubelet.service.d/10-proxy-ipvs.conf` 写入以下内容
```bash
# 启用 ipvs 相关内核模块
## 启用 ipvs 相关内核模块
[Service]
ExecStartPre=-/sbin/modprobe ip_vs
ExecStartPre=-/sbin/modprobe ip_vs_rr
@@ -267,9 +267,9 @@ ExecStartPre=-/sbin/modprobe ip_vs_sh
$ sudo systemctl daemon-reload
```
## 部署
### 部署
### master
#### master
```bash
$ systemctl enable cri-containerd
@@ -315,7 +315,7 @@ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
--discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
```
### node 工作节点
#### node 工作节点
在 **另一主机** 重复 **部署** 小节以前的步骤，安装配置好 kubelet。根据提示，加入到集群。
@@ -330,7 +330,7 @@ $ kubeadm join 192.168.199.100:6443 \
--cri-socket /run/cri-containerd/cri-containerd.sock
```
## 查看服务
### 查看服务
所有服务启动后，通过 `crictl` 查看本地实际运行的容器。这些服务大概分为三类：主节点服务、工作节点服务和其它服务。
@@ -338,7 +338,7 @@ $ kubeadm join 192.168.199.100:6443 \
CONTAINER_RUNTIME_ENDPOINT=/run/cri-containerd/cri-containerd.sock crictl ps -a
```
### 主节点服务
#### 主节点服务
* `apiserver` 是整个系统的对外接口，提供 RESTful 方式供客户端和其它组件调用；
@@ -346,15 +346,15 @@ CONTAINER_RUNTIME_ENDPOINT=/run/cri-containerd/cri-containerd.sock crictl ps -a
* `controller-manager` 负责管理控制器，包括 endpoint-controller（刷新服务和 pod 的关联信息）和 replication-controller（维护某个 pod 的复制为配置的数值）。
### 工作节点服务
#### 工作节点服务
* `proxy` 为 pod 上的服务提供访问的代理。
### 其它服务
#### 其它服务
* Etcd 是所有状态的存储数据库；
## 使用
### 使用
将 `/etc/kubernetes/admin.conf` 复制到 `~/.kube/config`
@@ -362,18 +362,18 @@ CONTAINER_RUNTIME_ENDPOINT=/run/cri-containerd/cri-containerd.sock crictl ps -a
由于未部署 CNI 插件，CoreDNS 未正常启动。如何使用 Kubernetes，请参考后续章节。
## 部署 CNI
### 部署 CNI
这里以 `flannel` 为例进行介绍。
### flannel
#### flannel
检查 podCIDR 设置
```bash
$ kubectl get node -o yaml | grep CIDR
# 输出
## 输出
podCIDR: 10.244.0.0/16
podCIDRs:
```
@@ -382,18 +382,18 @@ $ kubectl get node -o yaml | grep CIDR
$ kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/v0.26.1/Documentation/kube-flannel.yml
```
## master 节点默认不能运行 pod
### 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
## 恢复默认值
## $ kubectl taint nodes NODE_NAME node-role.kubernetes.io/master=true:NoSchedule
```
## 参考文档
### 参考文档
* [官方文档](https://kubernetes.io/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)
* [Container runtimes](https://kubernetes.io/docs/setup/production-environment/container-runtimes/#containerd)

2
11_orchestration/setup/systemd.md
View File

@@ -1,3 +1,3 @@
# 一步步部署 kubernetes 集群
## 一步步部署 kubernetes 集群
可以参考 [opsnull/follow-me-install-kubernetes-cluster](https://github.com/opsnull/follow-me-install-kubernetes-cluster) 项目一步步部署 kubernetes 集群。