3. containerd 安装与部署：二进制安装、apt/yum 安装、systemd 服务配置、验证安装状态

本章聚焦 containerd 在生产环境中的三种主流部署方式：二进制手动安装、apt/yum 包管理器安装，以及systemd 服务托管配置。每种方式对应不同的运维场景，安装后的状态验证是确保控制面正常启动的关键步骤。

3.1 安装方式对比与选择

3.2 二进制安装（推荐生产使用）

二进制安装不依赖系统包管理器，适合对 containerd 版本有严格要求的场景。以下步骤以 Linux amd64 架构为例。

3.2.1 下载与解压

# 下载 containerd 二进制包（以 v1.7.20 为例）
wget https://github.com/containerd/containerd/releases/download/v1.7.20/containerd-1.7.20-linux-amd64.tar.gz

# 解压到系统目录
sudo tar Cxzvf /usr/local containerd-1.7.20-linux-amd64.tar.gz

# 验证二进制文件
ls -la /usr/local/bin/ | grep containerd
# 输出应包含：containerd、containerd-shim、containerd-shim-runc-v2、ctr

3.2.2 安装 runc 与 CNI 插件

containerd 依赖 runc 作为默认运行时，同时需要 CNI 插件实现容器网络。

# 安装 runc
wget https://github.com/opencontainers/runc/releases/download/v1.1.12/runc.amd64
sudo install -m 755 runc.amd64 /usr/local/sbin/runc

# 安装 CNI 插件
wget https://github.com/containernetworking/plugins/releases/download/v1.4.0/cni-plugins-linux-amd64-v1.4.0.tgz
sudo mkdir -p /opt/cni/bin
sudo tar Cxzvf /opt/cni/bin cni-plugins-linux-amd64-v1.4.0.tgz

3.2.3 生成默认配置文件

# 创建配置目录
sudo mkdir -p /etc/containerd

# 生成默认配置
containerd config default | sudo tee /etc/containerd/config.toml

# 关键参数预览（后续章节详解）
grep -E "^(version|root|state|grpc|debug)" /etc/containerd/config.toml

3.3 apt/yum 包管理器安装

包管理器安装适合快速部署，系统会自动处理依赖关系。注意需要先添加官方仓库。

3.3.1 Ubuntu/Debian（apt）

# 安装依赖
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

# 添加 Docker 官方 GPG 密钥（containerd 仓库同源）
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 添加仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 containerd
sudo apt-get update
sudo apt-get install -y containerd.io

3.3.2 CentOS/RHEL（yum）

# 安装 yum-utils
sudo yum install -y yum-utils

# 添加 Docker 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# 安装 containerd
sudo yum install -y containerd.io

3.4 systemd 服务配置

无论使用哪种安装方式，最终都需要通过 systemd 将 containerd 注册为系统服务，实现开机自启与进程守护。

3.4.1 创建 systemd unit 文件

二进制安装默认不包含 systemd 配置，需手动创建；包管理器安装通常已自动生成。

# 创建 containerd.service 文件
sudo tee /etc/systemd/system/containerd.service <

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 启用开机自启
sudo systemctl enable containerd

# 启动服务
sudo systemctl start containerd

# 查看服务状态
sudo systemctl status containerd

# 检查进程是否存在
ps aux | grep containerd | grep -v grep

# 检查 systemd 服务状态（推荐）
sudo systemctl is-active containerd
# 输出应为：active

# 检查监听端口（默认 127.0.0.1:9090 用于 metrics，/run/containerd/containerd.sock 用于 gRPC）
sudo ss -tlnp | grep containerd
sudo ls -la /run/containerd/containerd.sock

# 使用 ctr 客户端连接 containerd
sudo ctr version
# 输出示例：
# Client:
#   Version:  v1.7.20
#   Revision: 8fc6bcff513189441796b22e1ccca2854e0d0b8b
#
# Server:
#   Version:  v1.7.20
#   Revision: 8fc6bcff513189441796b22e1ccca2854e0d0b8b

# 查看 containerd 命名空间
sudo ctr namespace ls
# 默认应包含：default

# 拉取测试镜像验证运行时
sudo ctr image pull docker.io/library/hello-world:latest
sudo ctr run --rm docker.io/library/hello-world:latest test

# 通过 gRPC 健康检查（需安装 grpcurl）
grpcurl -plaintext -d '{"service": "containerd.services.containers.v1.Containers"}' \
  unix:///run/containerd/containerd.sock grpc.health.v1.Health/Check

# 检查 containerd 配置是否加载成功
sudo containerd config dump | head -20