Update container runtime guidance

This commit is contained in:
yeasy
2026-03-16 20:49:00 -07:00
committed by Baohua Yang
parent b5830eb690
commit 2b82e16bcb
22 changed files with 115 additions and 49 deletions

View File

@@ -2,7 +2,7 @@
Ubuntu Docker 最常用的运行环境之一本节将介绍如何在 Ubuntu 系统上安装 Docker并配置国内镜像加速
>警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
> 警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
### 3.1.1 准备工作
@@ -76,7 +76,7 @@ $ echo \
# $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
>以上命令会添加稳定版本的 Docker APT 镜像源如果需要测试版本的 Docker 请将 stable 改为 test
> 以上命令会添加稳定版本的 Docker APT 镜像源如果需要测试版本的 Docker 请将 stable 改为 test
#### 安装 Docker

View File

@@ -2,7 +2,7 @@
Debian 以其稳定性著称 Docker 的理想宿主系统本节将指导你在 Debian 上完成 Docker 的安装
>警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
> 警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
### 3.2.1 准备工作
@@ -67,7 +67,7 @@ $ echo \
# $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
>以上命令会添加稳定版本的 Docker APT 如果需要测试版本的 Docker 请将 stable 改为 testDebian11 可能不使用 `/etc/apt/keyrings/` gpg 错误可以考虑更换为 `/etc/apt/trusted.gpg.d` [issue 15727](https://github.com/docker/docs/issues/15727)。
> 以上命令会添加稳定版本的 Docker APT 如果需要测试版本的 Docker 请将 stable 改为 testDebian11 可能不使用 `/etc/apt/keyrings/` gpg 错误可以考虑更换为 `/etc/apt/trusted.gpg.d` [issue 15727](https://github.com/docker/docs/issues/15727)。
#### 安装 Docker

View File

@@ -2,7 +2,7 @@
Fedora 作为技术前沿的 Linux 发行版 Docker 有着良好的支持本节介绍在 Fedora 上的安装步骤
>警告切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker
> 警告切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker
### 3.3.1 准备工作

View File

@@ -2,7 +2,7 @@
CentOS (及其替代品 Rocky LinuxAlmaLinux) 是企业级服务器常用的操作系统本节介绍在这些系统上安装 Docker 的步骤
>警告切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker
> 警告切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker
### 3.4.1 准备工作

View File

@@ -2,7 +2,7 @@
树莓派等 ARM 架构设备在物联网和边缘计算领域应用广泛本节介绍如何在树莓派上安装 Docker
>警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
> 警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
### 3.5.1 系统要求
@@ -63,7 +63,7 @@ $ echo \
# $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
>以上命令会添加稳定版本的 Docker APT 如果需要测试版本的 Docker 请将 stable 改为 test
> 以上命令会添加稳定版本的 Docker APT 如果需要测试版本的 Docker 请将 stable 改为 test
#### 报错解决办法

View File

@@ -118,7 +118,7 @@ REPOSITORY TAG IMAGE ID CREAT
}
```
>注意该文件必须符合 `json` 规范否则 Docker 将不能启动
> 注意该文件必须符合 `json` 规范否则 Docker 将不能启动
### 6.2.4 其他

View File

@@ -25,7 +25,7 @@ $ openssl req \
-subj '/C=CN/ST=Shanxi/L=Datong/O=Your Company Name/CN=Your Company Name Docker Registry CA'
```
>以上命令中 `-subj` 参数里的 `/C` 表示国家 `CN``/ST` 表示省`/L` 表示城市或者地区`/O` 表示组织名`/CN` 通用名称
> 以上命令中 `-subj` 参数里的 `/C` 表示国家 `CN``/ST` 表示省`/L` 表示城市或者地区`/O` 表示组织名`/CN` 通用名称
第三步配置 `CA` 根证书新建 `root-ca.cnf`

View File

@@ -207,7 +207,7 @@ COPY --link --from=builder /app/dist /usr/share/nginx/html
使用 `.dockerignore` 排除不需要复制的文件
```gitignore
```text
## .dockerignore
node_modules

View File

@@ -40,12 +40,12 @@ $ docker buildx build --sbom=true -t myimage .
> ** 注意与失败模式**
> 要使 SBOM (或其它 attestation 元数据) 成功附着并可见对底层的存储格式有前置要求默认的 classic image store 不支持 manifest list/index 这种存放 attestation 的结构
>
> 如果只简单运行上述命令你可能会面临 **命令成功执行但本地镜像中看不到 SBOM** 的体会落差
>
>
> 如果只简单运行上述命令你可能会面临 **命令成功执行但本地镜像中看不到 SBOM** 的体会落差
>
> **正确的解决路径有两条**
> 1. Docker 守护进程中启用 `containerd image store` 特性现代 Docker Desktop 默认推荐
> 2. 或者使用 `docker-container` driver 的构建器并直接 **加上 `--push` 参数** 将产物推送到远端支持 OCI 的镜像仓库仓库会正确保存这些元数据
> 1. **推送到远端仓库**使用 `docker buildx build --sbom=true --push -t myimage:tag` SBOM 会正确保存到远端仓库远端 OCI 兼容的镜像仓库能够完整存储这些元数据
> 2. **启用 containerd image store** Docker 守护进程中启用 `containerd image store` 特性Docker v29+现代 Docker Desktop 默认推荐可以在本地查看和管理 SBOM attestation 元数据
### 10.2.2 官方文档

View File

@@ -104,7 +104,7 @@ cgroup_parent: cgroups_1
container_name: docker-web-container
```
>注意指定容器名称后该服务将无法进行扩展 (scale)因为 Docker 不允许多个容器具有相同的名称
> 注意指定容器名称后该服务将无法进行扩展 (scale)因为 Docker 不允许多个容器具有相同的名称
### 11.5.7 `deploy`
@@ -138,7 +138,7 @@ services:
image: postgres
```
>注意`web` 服务不会等待 `redis` `db` 完全启动 之后才启动
> 注意`web` 服务不会等待 `redis` `db` 完全启动 之后才启动
### 11.5.10 `dns`
@@ -236,7 +236,7 @@ expose:
### 11.5.16 `external_links`
>注意不建议使用该指令
> 注意不建议使用该指令
链接到 Compose 文件外部的容器甚至并非 `Compose` 管理的外部容器
@@ -299,7 +299,7 @@ labels:
### 11.5.21 `links`
>注意不推荐使用该指令容器之间应通过 Docker 网络 (networks) 进行互联
> 注意不推荐使用该指令容器之间应通过 Docker 网络 (networks) 进行互联
### 11.5.22 `logging`

View File

@@ -267,7 +267,7 @@ web-1 | Watching for file changes with StatReloader
web-1 | Starting development server at http://0.0.0.0:8000/
```
打开浏览器访问 http://localhost:8000,可以看到 Django 欢迎页面!
打开浏览器访问 `http://localhost:8000`可以看到 Django 欢迎页面
### 11.6.9 常用开发命令

View File

@@ -200,6 +200,18 @@ $ docker run --rm --cpus=1 stress --cpu 4
| PSI (压力监控)| | |
| rootless 容器 | 部分支持 | 完整支持 |
#### Docker cgroups v2 的支持
Docker 19.03+ 默认优先使用 cgroups v2如果系统支持提供更好的性能和资源隔离如果需要明确控制或回退到 v1可以通过 Docker 守护进程配置文件 `/etc/docker/daemon.json` 修改 `cgroup-driver` 参数
```json
{
"cgroup-driver": "systemd"
}
```
常见的 `cgroup-driver` 值包括 `systemd` (推荐) `cgroupfs`重启 Docker 守护进程后生效
#### 检查系统使用的版本
```bash

View File

@@ -44,9 +44,9 @@
```bash
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
control-plane Ready control-plane 10d v1.30.2
worker-1 Ready <none> 10d v1.30.2
worker-2 Ready <none> 10d v1.30.2
control-plane Ready control-plane 10d v1.35.1
worker-1 Ready <none> 10d v1.35.1
worker-2 Ready <none> 10d v1.35.1
```
每个节点的详细信息以如下结构保存

View File

@@ -14,7 +14,61 @@
参考[安装 Docker](../03_install/README.md) 一节安装 Docker
### 14.2.2 安装 **kubelet****kubeadm****kubectl**
### 14.2.2 安装并配置 cri-dockerd
由于 Kubernetes v1.24 移除了内置的 dockershim需要额外安装 **cri-dockerd** 作为 Docker kubelet 之间的 CRIContainer Runtime Interface适配层
#### Ubuntu/Debian
```bash
## 安装 cri-dockerd
$ cd /tmp
$ wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.14/cri-dockerd-0.3.14.amd64.tgz
$ tar xzvf cri-dockerd-0.3.14.amd64.tgz
$ sudo mv cri-dockerd/cri-dockerd /usr/local/bin/
## 下载并安装 systemd service 文件
$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.service
$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.socket
$ sudo mv cri-docker.service cri-docker.socket /etc/systemd/system/
## 启动 cri-dockerd
$ sudo systemctl daemon-reload
$ sudo systemctl enable cri-docker
$ sudo systemctl start cri-docker
## 验证安装
$ sudo /usr/local/bin/cri-dockerd --version
```
#### CentOS/Fedora
```bash
## 安装 cri-dockerd
$ cd /tmp
$ wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.14/cri-dockerd-0.3.14.amd64.tgz
$ tar xzvf cri-dockerd-0.3.14.amd64.tgz
$ sudo mv cri-dockerd/cri-dockerd /usr/local/bin/
## 下载并安装 systemd service 文件
$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.service
$ wget https://raw.githubusercontent.com/Mirantis/cri-dockerd/master/packaging/systemd/cri-docker.socket
$ sudo mv cri-docker.service cri-docker.socket /etc/systemd/system/
## 启动 cri-dockerd
$ sudo systemctl daemon-reload
$ sudo systemctl enable cri-docker
$ sudo systemctl start cri-docker
```
### 14.2.3 安装 **kubelet****kubeadm****kubectl**
需要在每台机器上安装以下的软件包
@@ -56,7 +110,7 @@ EOF
$ sudo yum install -y kubelet kubeadm kubectl
```
### 14.2.3 修改内核的运行参数
### 14.2.4 修改内核的运行参数
#### 加载内核模块
@@ -92,7 +146,7 @@ EOF
$ sysctl --system
```
### 14.2.4 配置 kubelet
### 14.2.5 配置 kubelet
为了让 kubelet 正确运行我们需要对其进行一些必要的配置
@@ -116,7 +170,7 @@ ExecStartPre=-/sbin/modprobe ip_vs_sh
$ sudo systemctl daemon-reload
```
### 14.2.5 部署
### 14.2.6 部署
安装配置完成后我们将分别在 Master 节点和 Worker 节点上进行部署操作
@@ -125,10 +179,12 @@ $ sudo systemctl daemon-reload
```bash
$ sudo kubeadm init --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
--pod-network-cidr 10.244.0.0/16 \
--cri-socket unix:///var/run/cri-dockerd.sock \
--v 5 \
--ignore-preflight-errors=all
```
* `--cri-socket unix:///var/run/cri-dockerd.sock` 参数指定使用 cri-dockerd 作为容器运行时接口
* `--pod-network-cidr 10.244.0.0/16` 参数与后续 CNI 插件有关这里以 `flannel` 为例若后续部署其他类型的网络插件请更改此参数
> 执行可能出现错误例如缺少依赖包根据提示安装即可
@@ -169,7 +225,7 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
--discovery-token-ca-cert-hash sha256:5edb316fd0d8ea2792cba15cdf1c899a366f147aa03cba52d4e5c5884ad836fe
```
### 14.2.6 查看服务
### 14.2.7 查看服务
所有服务启动后查看本地实际运行的 Docker 容器这些服务大概分为三类主节点服务工作节点服务和其它服务
@@ -189,7 +245,7 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
* Etcd 是所有状态的存储数据库
### 14.2.7 使用
### 14.2.8 使用
`/etc/kubernetes/admin.conf` 复制到 `~/.kube/config`
@@ -197,7 +253,7 @@ $ kubeadm join 192.168.199.100:6443 --token cz81zt.orsy9gm9v649e5lf \
由于未部署 CNI 插件CoreDNS 未正常启动如何使用 Kubernetes请参考后续章节
### 14.2.8 部署 CNI
### 14.2.9 部署 CNI
这里以 `flannel` 为例进行介绍
@@ -218,7 +274,7 @@ $ kubectl get node -o yaml | grep CIDR
$ kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/v0.28.1/Documentation/kube-flannel.yml
```
### 14.2.9 master 节点默认不能运行 pod
### 14.2.10 master 节点默认不能运行 pod
如果用 `kubeadm` 部署一个单节点集群默认情况下无法使用请执行以下命令解除限制
@@ -236,6 +292,6 @@ $ kubectl taint nodes --all node-role.kubernetes.io/master-
...
```
### 14.2.10 参考文档
### 14.2.11 参考文档
* [官方文档](https://kubernetes.io/zh/docs/setup/production-environment/tools/kubeadm/install-kubeadm/)

View File

@@ -4,7 +4,7 @@
`etcd` 基于 `Go` 语言实现因此用户可以从[项目主页](https://github.com/etcd-io/etcd)下载源代码自行编译,也可以下载编译好的二进制文件,甚至直接使用制作好的 `Docker` 镜像文件来体验。
>注意本章节内容基于 etcd `3.4.x` 版本编写etcd 3.4 的官方支持将于 **2026 5 15 日结束**新部署建议使用 etcd `3.5` `3.6` 版本请访问 [etcd 官方发布页](https://github.com/etcd-io/etcd/releases) 获取最新版本。
> 注意本章节内容基于 etcd `3.4.x` 版本编写etcd 3.4 的官方支持将于 **2026 5 15 日结束**新部署建议使用 etcd `3.5` `3.6` 版本请访问 [etcd 官方发布页](https://github.com/etcd-io/etcd/releases) 获取最新版本。
### 15.2.1 二进制文件方式下载

View File

@@ -87,7 +87,7 @@ OPTIONS:
etcd 在键的组织上采用了层次化的空间结构 (类似于文件系统中目录的概念)用户指定的键可以为单独的名字 `testkey`此时实际上放在根目录 `/` 下面也可以为指定目录结构 `cluster1/node2/testkey`则将创建相应的目录结构
>CRUD CreateReadUpdateDelete是符合 REST 风格的一套 API 操作
> CRUD CreateReadUpdateDelete是符合 REST 风格的一套 API 操作
#### put

View File

@@ -1,4 +1,4 @@
## 17.3 podman - 下一代 Linux 容器工具
## 17.3 Podman - 下一代 Linux 容器工具
[Podman](https://github.com/containers/podman) 是一个无守护进程、与 Docker 命令高度兼容的下一代 Linux 容器工具。它由 Red Hat 开发,旨在提供一个更安全的容器运行环境。

View File

@@ -258,7 +258,7 @@ scrape_configs:
**常用的 Prometheus 查询PromQL**
```promql
```text
# 容器 CPU 使用百分比
rate(container_cpu_usage_seconds_total[5m]) * 100

View File

@@ -529,7 +529,7 @@ HEALTHCHECK --interval=5s --timeout=3s --retries=5 \
**redis.conf 配置**
```conf
```text
# 绑定地址
bind 0.0.0.0

View File

@@ -70,7 +70,7 @@ RUN apt-get update && apt-get install -y \
你可以给镜像添加标签来帮助组织镜像记录许可信息辅助自动化构建等每个标签一行 `LABEL` 开头加上一个或多个标签对下面的示例展示了各种不同的可能格式`#` 开头的行是注释内容
>注意如果你的字符串中包含空格必须将字符串放入引号中或者对空格使用转义如果字符串内容本身就包含引号必须对引号使用转义
> 注意如果你的字符串中包含空格必须将字符串放入引号中或者对空格使用转义如果字符串内容本身就包含引号必须对引号使用转义
```docker
## Set one or more individual labels
@@ -290,7 +290,7 @@ fi
exec "$@"
```
>注意该脚本使用了 Bash 的内置命令 exec所以最后运行的进程就是容器的 PID 1 的进程这样进程就可以接收到任何发送给容器的 Unix 信号了
> 注意该脚本使用了 Bash 的内置命令 exec所以最后运行的进程就是容器的 PID 1 的进程这样进程就可以接收到任何发送给容器的 Unix 信号了
该辅助脚本被拷贝到容器并在容器启动时通过 `ENTRYPOINT` 执行
@@ -328,7 +328,7 @@ $ docker run --rm -it postgres bash
如果某个服务不需要特权执行建议使用 `USER` 指令切换到非 root 用户先在 `Dockerfile` 中使用类似 `RUN groupadd -r postgres && useradd -r -g postgres postgres` 的指令创建用户和用户组
>注意在镜像中用户和用户组每次被分配的 UID/GID 都是不确定的下次重新构建镜像时被分配到的 UID/GID 可能会不一样如果要依赖确定的 UID/GID你应该显式的指定一个 UID/GID
> 注意在镜像中用户和用户组每次被分配的 UID/GID 都是不确定的下次重新构建镜像时被分配到的 UID/GID 可能会不一样如果要依赖确定的 UID/GID你应该显式的指定一个 UID/GID
你应该避免使用 `sudo`因为它不可预期的 TTY 和信号转发行为可能造成的问题比它能解决的问题还多如果你真的需要和 `sudo` 类似的功能 (例如 root 权限初始化某个守护进程以非 root 权限执行它)你可以使用 [gosu](https://github.com/tianon/gosu)。

View File

@@ -9,17 +9,14 @@
},
"plugins": [
"-livereload",
"image-captions",
"mermaid-gb3",
"github",
"page-treeview",
"editlink"
],
"pluginsConfig": {
"image-captions": {
"attributes": {
"width": "600"
},
"caption": "图 _PAGE_LEVEL_._PAGE_IMAGE_NUMBER_ - _CAPTION_"
"mermaid-gb3": {
"theme": "default"
},
"github": {
"url": "https://github.com/yeasy/docker_practice"
@@ -48,4 +45,4 @@
"bottom": 56
}
}
}
}

View File

@@ -7,6 +7,7 @@
"chalk": "^5.6.2",
"commander": "^14.0.3",
"esm": "^3.0.0",
"gitbook-plugin-mermaid-gb3": "^2.1.0",
"honkit": "^6.1.6",
"vuepress": "1.9.10",
"vuepress-plugin-container": "^2.1.5",
@@ -30,4 +31,4 @@
"url": "https://github.com/yeasy/docker_practice/issues"
},
"homepage": "https://github.com/yeasy/docker_practice#readme"
}
}