本页内容

  • 先决条件
  • 安装 CRI-O 容器运行时
  • 安装 CNI(Container Network Interface)插件
  • 安装 CRI-Tools 软件包
  • 使用 crictl 创建 Pod 和容器
  • 结论

CRI-O 是 Kubernetes 中替代 Docker 的轻量级容器运行时。它是 Kubernetes CRI(Container Runtime Interface)的一种实现,并符合 OCI runtime(Open Container Initiative)规范。CRI-O 让 Kubernetes 能够直接执行容器,无需任何额外工具或对代码进行调整。

CRI-O 支持多种镜像格式,包括 Docker 镜像格式。它还提供管理容器镜像的功能,例如管理 image layer、overlay filesystems、管理容器进程生命周期、容器的监控与日志记录,并提供资源隔离。

本教程将指导你在 Ubuntu 22.04 服务器上完成 CRI-O 容器运行时的安装。其中还包括如何为 CRI-O 配置 CNI 插件,以及用于管理 Pod 和容器的 " cri-tools " 的基本用法。

先决条件

在开始之前,你必须满足以下要求:

  • 一台 Ubuntu 22.04 服务器 —— 本指南使用的 Ubuntu Server 主机名为 "server-ubuntu",服务器 IP 地址为 "192.168.5.10"。
  • 一个具备 root/administrator 权限的非 root 用户。

安装 CRI-O 容器运行时

CRI-O 可以通过多种方式安装:通过 APT 命令安装,或者从源码构建并安装 CRI-O。在本示例中,你将通过第三方仓库安装 CRI-O 容器运行时。

在开始安装之前,运行以下命令来设置环境变量 " $OS " 和 " $CRIO_VERSION "。在本示例中,我们将为 Ubuntu 22.04 安装 CRI-O v1.24.0。

export OS=xUbuntu_22.04
export CRIO_VERSION=1.24

现在运行以下命令,为 Ubuntu 22.04 服务器添加 CRI-O 仓库。

echo "deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/ /"|sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list
echo "deb http://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable:/cri-o:/$CRIO_VERSION/$OS/ /"|sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable:cri-o:$CRIO_VERSION.list

使用以下命令添加 CRI-O 仓库的 GPG key。

curl -L https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable:cri-o:$CRIO_VERSION/$OS/Release.key | sudo apt-key add -
curl -L https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/Release.key | sudo apt-key add -

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

现在更新你的 Ubuntu 仓库并刷新软件包索引。你应该能看到 CRI-O 仓库已被添加到软件包索引列表中。

sudo apt update

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

之后,使用以下命令检查 CRI-O 软件包的版本。如你所见,你将安装 CRI-O 软件包的最新版本 v1.24。

sudo apt info cri-o

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

现在使用下面的 apt 命令安装 CRI-O 容器运行时。输入 Y 确认安装并按 ENTER 继续,安装即会开始。

sudo apt install cri-o cri-o-runc

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

安装完成后,使用下面的 " systemctl " 命令启动 CRI-O 服务并将其设为开机自启。

sudo systemctl start crio
sudo systemctl enable crio

最后,使用以下命令检查并验证 CRI-O 服务。你应该能看到 CRI-O 服务已启用,并会在系统启动时自动运行,且 CRI-O 服务当前状态为 running。

sudo systemctl status crio

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

安装 CNI(Container Network Interface)插件

CNI(Container Network Interface)是 CRI-O 容器运行时所必需的。CNI 插件允许你为容器和 Pod 配置网络。你将从官方 ubuntu 仓库安装 CNI 插件,并为其配置 CRI-O 容器运行时。

软件包 " containernetworking-plugins " 在大多数 Linux 发行版上都可用。要安装它,运行下面的 apt 命令,安装即会开始。

sudo apt install containernetworking-plugins

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

安装完成后,使用以下命令编辑 CRI-O 配置文件 " /etc/crio/crio.conf "。

sudo nano /etc/crio/crio.conf

在 "[crio.network]" 段落中,取消 " network_dir " 和 " plugin_dirs " 选项的注释。另外,务必把 CNI 插件目录 " /usr/lib/cni/ " 添加到 " plugin_dirs " 选项中。

# The crio.network table containers settings pertaining to the management of
# CNI plugins.
[crio.network]
# The default CNI network name to be selected. If not set or "", then
# CRI-O will pick-up the first one found in network_dir.
# cni_default_network = ""
# Path to the directory where CNI configuration files are located.
network_dir = "/etc/cni/net.d/"
# Paths to directories where CNI plugin binaries are located.
plugin_dirs = [
        "/opt/cni/bin/",
        "/usr/lib/cni/",
]

完成后,保存并关闭文件。

接下来,删除默认的 bridge CNI 配置 " /etc/cni/net.d/100-crio-bridge.conf "。然后,将新的 bridge CNI 配置下载到 " /etc/cni/net.d/11-crio-ipv4-bridge.conf "。

新的 bridge CNI 配置将只为 Pod 和容器启用 IPv4。

rm -f /etc/cni/net.d/100-crio-bridge.conf
sudo curl -fsSLo /etc/cni/net.d/11-crio-ipv4-bridge.conf https://raw.githubusercontent.com/cri-o/cri-o/main/contrib/cni/11-crio-ipv4-bridge.conf

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

现在重启 CRI-O 服务,使 CNI 插件设置的新更改生效。

sudo systemctl restart crio

最后,再次使用以下命令检查并验证 CRI-O 服务。你应该能看到 CRI-O 服务正以新的 bridge CNI 配置运行。

sudo systemctl status crio

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

安装 CRI-Tools 软件包

你已完成 CRI-O 容器运行时的安装,现在它正配合正确的 CNI 插件运行。接下来你将安装 "cri-tools" 软件包,其中包含命令行工具 "crictl",可用于与 CRI-O 容器运行时交互。

" cri-tools " 可搭配多种容器运行时使用,例如 containerd、dockershim、CRI-O 和 cri-dockerd。

运行下面的 apt 命令安装 " cri-tools " 软件包。安装将自动开始。

sudo apt install cri-tools

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

安装完成后,运行下面的 " crictl " 命令检查当前的 runtime 版本。你将看到当前使用的容器运行时是 CRI-O v1.24。

crictl version

接下来,运行下面的 " crictl " 命令检查当前 Container Runtime 和 CNI Network Plugin 的状态。你应该能看到 CRI-O Container Runtime 为 " RuntimeReady ",CNI Plugin 为 " NetworkReady "。

crictl info

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

crictl 命令为你的 shell 提供自动补全功能,可手动生成。运行下面的 crictl 命令,为 Bash shell 生成命令补全并输出到 " /etc/bash_completion.d/crictl "。然后,通过 source ~/.bashrc 配置文件重新加载当前的 Bash 会话。

crictl completion > /etc/bash_completion.d/crictl source ~/.bashrc

现在运行 " crictl " 命令并按 TAB 键,查看所有可用的命令补全。

crictl TAB

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

使用 crictl 创建 Pod 和容器

现在 cri-tools 已安装在你的系统上,是时候使用 " crictl " 命令创建 Pod sandbox 和容器了。在本示例中,我们将为 Nginx 容器创建一个 Pod。

使用以下命令创建一个新目录 " ~/demo "。

mkdir ~/demo/

现在运行以下命令创建一个新的 JSON 配置文件,并为容器定义 Pod sandbox。

cat <<EOF | tee ~/demo/sandbox_nginx.json
{
    "metadata": {
        "name": "nginx-sandbox",
        "namespace": "default",
        "attempt": 1,
        "uid": "hdishd83djaidwnduwk28bcsb"
    },
    "linux": {
    },
    "log_directory": "/tmp"
}
EOF

使用下面的 " crictl " 命令运行 Pod sandbox。你应该能看到你的 Pod 的随机字符串。

sudo crictl runp ~/demo/sandbox_nginx.json

使用以下命令检查并验证正在运行的 Pod。你应该能看到 Pod sandbox " nginx-sandbox ",其 Pod id 为 " 7b0618800e251 ",状态为 " Ready "。

sudo crictl pods

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

要查看 Pod 的详细信息,运行下面的 " crictl " 命令,并务必更改 Pod id。在本示例中," nginx_sandbox " pod 的 IP 地址为 " 10.85.0.3 "。

sudo crictl inspectp --output table 7b0618800e251

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

现在 Pod sandbox 已就绪,是时候创建 Nginx 容器了。但首先,你将下载 Nginx 镜像。

运行下面的 crictl 命令下载 Nginx 镜像。然后,检查并验证可用镜像列表。

sudo crictl pull nginx
sudo crictl images

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

现在运行以下命令创建一个新的 JSON 文件,用于定义 Nginx 容器。

cat <<EOF | tee ~/demo/container_nginx.json
{
  "metadata": {
      "name": "nginx"
    },
  "image":{
      "image": "nginx"
    },
  "log_path":"nginx.0.log",
  "linux": {
  }
}
EOF

使用下面的 crictl 命令在 Pod sandbox " 7b0618800e251 " 中创建一个新容器。你应该能看到新 Nginx container id 的随机字符串。

sudo crictl create 7b0618800e251 ~/demo/container_nginx.json ~/demo/sandbox_nginx.json

使用以下命令启动 Nginx 容器,并务必更改 container id。

sudo crictl start 1100498979ee5d3a9cbdb7b8b8f18529a01298f2bb57f7fcd01f54dd5a0f8746

之后,使用以下命令检查并验证正在运行的容器。你应该能看到 Nginx 容器在 Pod " 7b0618800e251 " 内为 " Running " 状态。

sudo crictl ps

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

最后,你可以通过 Pod sandbox " nginx_sandbox " 的 IP 地址访问 Nginx 容器。对 " nginx_sandbox " 的 IP 地址 " 10.85.0.3 " 运行 curl 命令,你将看到 Nginx 容器的默认 index.html 页面。

curl 10.85.0.3

在 Ubuntu 22.04 系统上完整安装 CRI-O 容器运行时教程

结论

至此,你已在 Ubuntu 22.04 服务器上完成 CRI-O 容器运行时与 CNI 插件的安装和配置。现在你可以将其用作 Kubernetes 集群的容器运行时。你还学习了 "crictl" 命令的基本用法,以及如何使用 CRI-O 容器运行时创建 Pod 和容器。