From e2c2bb3385af08b0b97289d270566c2fa2487be2 Mon Sep 17 00:00:00 2001 From: windsonsea Date: Sat, 27 Aug 2022 21:15:17 +0800 Subject: [PATCH] [zh] Sync1.25 /production-environment/container-runtimes.md --- .../container-runtimes.md | 218 +++++++++--------- 1 file changed, 111 insertions(+), 107 deletions(-) diff --git a/content/zh-cn/docs/setup/production-environment/container-runtimes.md b/content/zh-cn/docs/setup/production-environment/container-runtimes.md index bd31373352..79aca92840 100644 --- a/content/zh-cn/docs/setup/production-environment/container-runtimes.md +++ b/content/zh-cn/docs/setup/production-environment/container-runtimes.md @@ -140,45 +140,118 @@ sudo sysctl --system On Linux, {{< glossary_tooltip text="control groups" term_id="cgroup" >}} are used to constrain resources that are allocated to processes. --> -## Cgroup 驱动程序 {#cgroup-drivers} +## cgroup 驱动 {#cgroup-drivers} -在 Linux 上，{{}} -用于限制分配给进程的资源。 +在 Linux 上，{{}}用于限制分配给进程的资源。 +{{< glossary_tooltip text="kubelet" term_id="kubelet" >}} 和底层容器运行时都需要对接控制组来强制执行 +[为 Pod 和容器管理资源](/zh-cn/docs/concepts/configuration/manage-resources-containers/) +并为诸如 CPU、内存这类资源设置请求和限制。若要对接控制组，kubelet 和容器运行时需要使用一个 **cgroup 驱动**。 +关键的一点是 kubelet 和容器运行时需使用相同的 cgroup 驱动并且采用相同的配置。 + + +可用的 cgroup 驱动有两个： + +* [`cgroupfs`](#cgroupfs-cgroup-driver) +* [`systemd`](#systemd-cgroup-driver) + + +### cgroupfs 驱动 {#cgroupfs-cgroup-driver} + +`cgroupfs` 驱动是 kubelet 中默认的 cgroup 驱动。当使用 `cgroupfs` 驱动时， +kubelet 和容器运行时将直接对接 cgroup 文件系统来配置 cgroup。 + +当 [systemd](https://www.freedesktop.org/wiki/Software/systemd/) 是初始化系统时， +**不** 推荐使用 `cgroupfs` 驱动，因为 systemd 期望系统上只有一个 cgroup 管理器。 +此外，如果你使用 [cgroup v2](/zh-cn/docs/concepts/architecture/cgroups)， +则应用 `systemd` cgroup 驱动取代 `cgroupfs`。 + + +### systemd cgroup 驱动 {#systemd-cgroup-driver} + 当某个 Linux 系统发行版使用 [systemd](https://www.freedesktop.org/wiki/Software/systemd/) 作为其初始化系统时，初始化进程会生成并使用一个 root 控制组（`cgroup`），并充当 cgroup 管理器。 -Systemd 与 cgroup 集成紧密，并将为每个 systemd 单元分配一个 cgroup。 -你也可以配置容器运行时和 kubelet 使用 `cgroupfs`。 -连同 systemd 一起使用 `cgroupfs` 意味着将有两个不同的 cgroup 管理器。 + +systemd 与 cgroup 集成紧密，并将为每个 systemd 单元分配一个 cgroup。 +因此，如果你 `systemd` 用作初始化系统，同时使用 `cgroupfs` 驱动，则系统中会存在两个不同的 cgroup 管理器。 -单个 cgroup 管理器将简化分配资源的视图，并且默认情况下将对可用资源和使用中的资源具有更一致的视图。 -当有两个管理器共存于一个系统中时，最终将对这些资源产生两种视图。 -在此领域人们已经报告过一些案例，某些节点配置让 kubelet 和 docker 使用 -`cgroupfs`，而节点上运行的其余进程则使用 systemd； -这类节点在资源压力下会变得不稳定。 +同时存在两个 cgroup 管理器将造成系统中针对可用的资源和使用中的资源出现两个视图。某些情况下， +将 kubelet 和容器运行时配置为使用 `cgroupfs`、但为剩余的进程使用 `systemd` +的那些节点将在资源压力增大时变得不稳定。 + +当 systemd 是选定的初始化系统时，缓解这个不稳定问题的方法是针对 kubelet 和容器运行时将 +`systemd` 用作 cgroup 驱动。 + +要将 `systemd` 设置为 cgroup 驱动，需编辑 [`KubeletConfiguration`](/zh-cn/docs/tasks/administer-cluster/kubelet-config-file/) +的 `cgroupDriver` 选项，并将其设置为 `systemd`。例如： + +```yaml +apiVersion: kubelet.config.k8s.io/v1beta1 +kind: KubeletConfiguration +... +cgroupDriver: systemd +``` -更改设置，令容器运行时和 kubelet 使用 `systemd` 作为 cgroup 驱动，以此使系统更为稳定。 -对于 Docker，要设置 `native.cgroupdriver=systemd` 选项。 +如果你将 `systemd` 配置为 kubelet 的 cgroup 驱动，你也必须将 `systemd` 配置为容器运行时的 cgroup 驱动。 +参阅容器运行时文档，了解指示说明。例如： + +* [containerd](#containerd-systemd) +* [CRI-O](#cri-o) {{< caution >}} -### Cgroup v2 {#cgroup-v2} - -Cgroup v2 是 cgroup Linux API 的下一个版本。与 cgroup v1 不同的是， -Cgroup v2 只有一个层次结构，而不是每个控制器有一个不同的层次结构。 - - -新版本对 cgroup v1 进行了多项改进，其中一些改进是： - -- 更简洁、更易于使用的 API -- 可将安全子树委派给容器 -- 更新的功能，如压力失速信息（Pressure Stall Information） - - -尽管内核支持混合配置，即其中一些控制器由 cgroup v1 管理，另一些由 cgroup v2 管理， -Kubernetes 仅支持使用同一 cgroup 版本来管理所有控制器。 - -如果 systemd 默认不使用 cgroup v2，你可以通过在内核命令行中添加 -`systemd.unified_cgroup_hierarchy=1` 来配置系统去使用它。 - - - -```shell -# 此示例适用于使用 DNF 包管理器的 Linux 操作系统 -# 你的系统可能使用不同的方法来设置 Linux 内核使用的命令行。 -sudo dnf install -y grubby && \ - sudo grubby \ - --update-kernel=ALL \ - --args="systemd.unified_cgroup_hierarchy=1" -``` - - -如果更改内核的命令行，则必须重新启动节点才能使更改生效。 - -切换到 cgroup v2 时，用户体验不应有任何明显差异， -除非用户直接在节点上或在容器内访问 cgroup 文件系统。 -为了使用它，CRI 运行时也必须支持 cgroup v2。 - ### 将 kubeadm 管理的集群迁移到 `systemd` 驱动 -如果你希望将现有的由 kubeadm 管理的集群迁移到 `systemd` cgroup 驱动程序， -请按照[配置 cgroup 驱动程序](/zh-cn/docs/tasks/administer-cluster/kubeadm/configure-cgroup-driver/)操作。 +如果你希望将现有的由 kubeadm 管理的集群迁移到 `systemd` cgroup 驱动， +请按照[配置 cgroup 驱动](/zh-cn/docs/tasks/administer-cluster/kubeadm/configure-cgroup-driver/)操作。 -#### 配置 `systemd` cgroup 驱动程序 {#containerd-systemd} +#### 配置 `systemd` cgroup 驱动 {#containerd-systemd} -结合 `runc` 使用 `systemd` cgroup 驱动，在 `/etc/containerd/config.toml` 中设置 +结合 `runc` 使用 `systemd` cgroup 驱动，在 `/etc/containerd/config.toml` 中设置： ``` [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc] @@ -359,6 +358,11 @@ To use the `systemd` cgroup driver in `/etc/containerd/config.toml` with `runc`, SystemdCgroup = true ``` + +如果你使用 [cgroup v2](/zh-cn/docs/concepts/architecture/cgroups)，则推荐 `systemd` cgroup 驱动。 + {{< note >}} -#### cgroup 驱动程序 {#cgroup-driver} +#### cgroup 驱动 {#cgroup-driver} -CRI-O 默认使用 systemd cgroup 驱动程序，这对你来说可能工作得很好。 -要切换到 `cgroupfs` cgroup 驱动程序，请编辑 `/etc/crio/crio.conf` 或在 +CRI-O 默认使用 systemd cgroup 驱动，这对你来说可能工作得很好。 +要切换到 `cgroupfs` cgroup 驱动，请编辑 `/etc/crio/crio.conf` 或在 `/etc/crio/crio.conf.d/02-cgroup-manager.conf` 中放置一个插入式配置，例如： ```toml @@ -522,7 +526,7 @@ You can use Mirantis Container Runtime with Kubernetes using the open source --> ### Mirantis 容器运行时 {#mcr} -[Mirantis Container Runtime](https://docs.mirantis.com/mcr/20.10/overview.html) (MCR) +[Mirantis Container Runtime](https://docs.mirantis.com/mcr/20.10/overview.html) (MCR) 是一种商用容器运行时，以前称为 Docker 企业版。 你可以使用 MCR 中包含的开源 [`cri-dockerd`](https://github.com/Mirantis/cri-dockerd) 组件将 Mirantis Container Runtime 与 Kubernetes 一起使用。