容器与云原生 / 系统课时

安装 containerd

安装 containerd

本课在一台使用 systemd 的 Linux 节点上完成 containerd 安装与 Kubernetes 运行时配置,并用 crictl 验证 CRI 连通和镜像拉取。完成后,这台节点即可作为 kubeadm 控制平面或工作节点的容器运行时基础。

学习目标

  • 安装并启动 containerd,确认 CRI Socket 可用
  • 将 runc 的 cgroup 驱动切换为 systemd,并配置镜像仓库入口
  • 配置 crictl,验证运行时信息和镜像拉取链路

安装并生成基础配置

以下命令以 Ubuntu/Debian 与 systemd 为例。若使用其他发行版,只替换软件包安装命令;配置文件 /etc/containerd/config.toml、服务名和 CRI Socket 的检查方法保持一致。

bash
sudo apt-get update
sudo apt-get install -y containerd
sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml >/dev/null
sudo systemctl enable --now containerd
sudo systemctl is-active containerd
containerd --version

预期输出

text
active
containerd github.com/containerd/containerd <VERSION> <REVISION>

<VERSION> 和 <REVISION> 取决于安装的软件包。这里重新生成默认配置,是为了避免某些发行版预置配置禁用 CRI 或带入不兼容参数;后续修改都基于这份可追踪的默认配置。

对齐 systemd cgroup

kubelet 与 containerd 应使用一致的 cgroup 驱动。在 systemd 主机上,把 runc 选项中的 SystemdCgroup 设置为 true,可以避免同一节点同时由 systemd 和 cgroupfs 管理控制组。

下面的命令直接修改由 containerd config default 生成的配置;containerd 1.x 与 2.x 的插件层级不同,但默认配置中都包含 SystemdCgroup 这一 runc 选项。

bash
sudo sed -ri 's/^([[:space:]]*)SystemdCgroup = false/\1SystemdCgroup = true/' /etc/containerd/config.toml
sudo systemctl restart containerd
sudo systemctl is-active containerd
grep -n 'SystemdCgroup = true' /etc/containerd/config.toml

预期输出

text
active
<LINE>:            SystemdCgroup = true

<LINE> 是配置文件中的实际行号。若 grep 没有结果,不要继续执行 kubeadm;先用 containerd --version 确认版本,再检查配置中的 runc runtime 段是否确实启用了 systemd cgroup。

配置镜像仓库入口

containerd 推荐通过 /etc/containerd/certs.d 管理各镜像仓库的主机、镜像加速和证书配置,而不是继续使用旧的 registry.mirrors 写法。需要先让 CRI 镜像插件读取这个目录;下面两个片段按 containerd 主版本二选一。

containerd 1.x 片段示例:

toml
[plugins."io.containerd.grpc.v1.cri".registry]
  config_path = "/etc/containerd/certs.d"

containerd 2.x 片段示例:

toml
[plugins."io.containerd.cri.v1.images".registry]
  config_path = "/etc/containerd/certs.d"

如果需要为 registry.k8s.io 接入企业镜像代理,可创建对应的 hosts.toml。这是片段示例,必须把 <REGISTRY_MIRROR> 替换为真实、可信且支持该仓库路径的 HTTPS 地址。

toml
server = "https://registry.k8s.io"

[host."https://<REGISTRY_MIRROR>"]
  capabilities = ["pull", "resolve"]

保存配置后重启 containerd。若没有镜像代理需求,可以不创建该 hosts.toml,直接从官方仓库拉取。

配置 crictl 并验证 CRI

crictl 应显式指向 containerd 的 CRI Socket,避免它轮询其他运行时端点。若系统还没有 crictl,先安装与 Kubernetes 主版本匹配的 cri-tools,再写入配置。

bash
sudo tee /etc/crictl.yaml >/dev/null <<'EOF'
runtime-endpoint: unix:///run/containerd/containerd.sock
image-endpoint: unix:///run/containerd/containerd.sock
timeout: 10
debug: false
EOF
sudo crictl info >/dev/null && echo "CRI OK"

预期输出

text
CRI OK

再验证镜像服务。若配置了镜像代理,这一步同时验证 hosts.toml 是否能正确解析并拉取 Kubernetes 镜像。

bash
sudo crictl pull registry.k8s.io/pause:3.10 >/dev/null && echo "IMAGE PULL OK"

预期输出

text
IMAGE PULL OK

处理典型失败

如果 crictl info 报 CRI API 不可用,先检查 /etc/containerd/config.toml 中是否把 cri 放进 disabled_plugins,再确认 containerd 已重启。若服务启动失败,应优先查看 systemd 日志并回查刚修改的 TOML 语法。

如果镜像拉取超时或返回证书错误,问题通常在 DNS、代理地址、企业 CA 或仓库访问控制,不要通过关闭 TLS 校验绕过。最终验收标准很简单:containerd 为 active、SystemdCgroup = true、crictl info 成功,并且目标仓库镜像可以通过 CRI 拉取。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 containerd

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通