在 SLES (s390x) 上安装 Docker Engine

注意

本页面上的安装说明适用于 s390x 架构（IBM Z）的 SLES 软件包。其他架构（包括 x86_64）不支持 SLES。

要在 SLES 上开始使用 Docker 引擎，请确保您 满足先决条件，然后按照 安装步骤进行操作。

前提条件

操作系统要求

要安装 Docker 引擎，您需要以下 SLES 版本的维护版本之一：

• SLES 15-SP4 on s390x (IBM Z)
• 在 s390x (IBM Z) 上的 SLES 15-SP5

您必须启用 SCC SUSE 仓库。

您必须添加 OpenSUSE SELinux 仓库。此仓库默认不添加。运行以下命令以添加它：

$ opensuse_repo="https://download.opensuse.org/repositories/security:/SELinux/openSUSE_Factory/security:SELinux.repo"
$ sudo zypper addrepo $opensuse_repo

卸载旧版本

在安装 Docker 引擎之前，您需要卸载所有冲突的软件包。

您的 Linux 发行版可能会提供非官方的 Docker 软件包，这些软件包可能会与 Docker 提供的官方软件包冲突。在安装 Docker Engine 官方版本之前，您必须卸载这些软件包。

$ sudo zypper remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine \
                  runc

zypper 可能会报告您没有安装这些软件包。

镜像、容器、卷和网络存储在 /var/lib/docker/ 中，在您卸载 Docker 时不会被自动删除。

安装方法

您可以根据自己的需求，通过不同的方式安装 Docker 引擎：

• 您可以 设置 Docker 的仓库并从中安装，以便轻松完成安装和升级任务。这是推荐的方法。

• 您可以下载 RPM 软件包， 手动安装，并完全手动管理升级。这对于在无法访问互联网的隔离系统（如 air-gapped 系统）上安装 Docker 等情况非常有用。

• 在测试和开发环境中，您可以使用自动化的 便捷脚本 来安装 Docker。

使用 rpm 仓库安装

在您首次在新主机上安装 Docker Engine 之前，您需要设置 Docker 仓库。之后，您可以从该仓库安装和更新 Docker。

设置仓库

设置仓库。

$ sudo zypper addrepo https://download.docker.com/linux/sles/docker-ce.repo

安装 Docker 引擎

1. 安装 Docker 软件包。

   Latest 特定版本

   ---

   要安装最新版本，请运行：

   $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
   

   如果提示接受 GPG 密钥，请验证指纹是否匹配 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35，如果匹配，请接受它。

   此命令安装 Docker，但不会启动 Docker。它还会创建一个 docker 组，但默认情况下不会将任何用户添加到该组中。

   要安装特定版本，首先列出仓库中的可用版本：

   $ sudo zypper search -s --match-exact docker-ce | sort -r
    
     v  | docker-ce | package | 3:27.4.0-1 | s390x | Docker CE Stable - s390x
     v  | docker-ce | package | 3:27.3.1-1 | s390x | Docker CE Stable - s390x
   

   返回的列表取决于启用了哪些仓库，并且特定于您的 SLES 版本。

   通过其完全限定包名称安装特定版本，即包名称（docker-ce）加上版本字符串（第二列），用连字符（-）分隔。例如，docker-ce-3:27.4.0。

   将 <VERSION_STRING> 替换为所需版本，然后运行以下命令进行安装：

   $ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
   

   此命令安装 Docker，但不会启动 Docker。它还会创建一个 docker 组，但默认情况下不会将任何用户添加到该组中。

   ---

2. 启动 Docker 引擎。

   $ sudo systemctl enable --now docker
   

   这会在您启动系统时配置 Docker systemd 服务以自动启动。如果您不希望 Docker 自动启动，请使用 sudo systemctl start docker 代替。

3. 通过运行 hello-world 镜像来验证安装是否成功：

   $ sudo docker run hello-world
   

   此命令下载一个测试镜像并在容器中运行它。当容器运行时，它会打印一条确认消息并退出。

您已成功安装并启动 Docker Engine。

提示

在没有 root 权限的情况下尝试运行时遇到错误？

docker 用户组存在但不包含任何用户，这就是为什么你需要使用 sudo 来运行 Docker 命令。继续前往 Linux 后安装步骤 以允许非特权用户运行 Docker 命令以及进行其他可选配置步骤。

升级 Docker 引擎

要升级 Docker Engine，请遵循 安装说明， 选择您想要安装的新版本。

从软件包安装

如果您无法使用 Docker 的 rpm 仓库来安装 Docker 引擎，您可以下载适用于您发布的 .rpm 文件并手动安装。每次想要升级 Docker 引擎时，您都需要下载一个新文件。

1. 前往 https://download.docker.com/linux/sles/ 并选择您的 SLES 版本。然后浏览到 s390x/stable/Packages/ 并下载您想要安装的 Docker 版本的 .rpm 文件。

2. 安装 Docker 引擎，将以下路径更改为您下载 Docker 包的路径。

   $ sudo zypper install /path/to/package.rpm
   

   Docker 已安装但未启动。已创建 docker 组，但未将任何用户添加到该组。

3. 启动 Docker 引擎。

   $ sudo systemctl enable --now docker
   

   这会在您启动系统时配置 Docker systemd 服务以自动启动。如果您不希望 Docker 自动启动，请使用 sudo systemctl start docker 代替。

4. 通过运行 hello-world 镜像来验证安装是否成功：

   $ sudo docker run hello-world
   

   此命令下载一个测试镜像并在容器中运行它。当容器运行时，它会打印一条确认消息并退出。

您已成功安装并启动 Docker Engine。

提示

在没有 root 权限的情况下尝试运行时遇到错误？

docker 用户组存在但不包含任何用户，这就是为什么你需要使用 sudo 来运行 Docker 命令。继续前往 Linux 后安装步骤 以允许非特权用户运行 Docker 命令以及进行其他可选配置步骤。

升级 Docker 引擎

要升级 Docker Engine，请下载较新的软件包文件并重复 安装过程，使用 zypper -y upgrade 代替 zypper -y install，并指向新文件。

使用便捷脚本安装

Docker 在 https://get.docker.com/ 提供了一个便捷脚本，用于在开发环境中非交互式地安装 Docker。虽然不建议在生产环境中使用便捷脚本，但它对于创建适合您需求的配置脚本非常有用。此外，请参阅 使用仓库安装步骤，了解通过软件包仓库进行安装的步骤。该脚本的源代码是开源的，您可以在 GitHub 上的 docker-install 仓库中找到它。

在本地运行之前，请务必检查从互联网下载的脚本。 在安装之前，请了解便捷脚本的潜在风险和限制：

• 该脚本需要 root 或 sudo 权限才能运行。
• 脚本会尝试检测您的 Linux 发行版和版本， 并为您配置包管理系统。
• 该脚本不允许您自定义大多数安装参数。
• 该脚本在未请求确认的情况下安装依赖项和建议。这可能会安装大量的软件包，具体取决于您主机的当前配置。
• 默认情况下，该脚本会安装 Docker、containerd 和 runc 的最新稳定版本。使用此脚本配置机器时，可能会导致 Docker 的意外主要版本升级。在部署到生产系统之前，请务必在测试环境中测试升级。
• 该脚本并非设计用于升级现有的 Docker 安装。当使用该脚本更新现有安装时，依赖项可能不会更新到预期版本，导致版本过时。

提示

在运行之前预览脚本步骤。您可以使用 --dry-run 选项运行脚本，以了解脚本在被调用时将执行的步骤：

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh ./get-docker.sh --dry-run

此示例从 https://get.docker.com/ 下载脚本并运行，以在 Linux 上安装 Docker 的最新稳定版本：

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh
Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b2737
<...>

您已经成功安装并启动了 Docker 引擎。在基于 Debian 的发行版上，docker 服务会自动启动。在基于 RPM 的发行版上，例如 CentOS、Fedora、RHEL 或 SLES，您需要使用适当的 systemctl 或 service 命令手动启动它。正如消息所示，非 root 用户默认情况下无法运行 Docker 命令。

以非特权用户身份使用 Docker，还是以无根模式安装？

安装脚本需要 root 或 sudo 权限来安装和使用 Docker。如果您想授予非 root 用户访问 Docker 的权限，请参阅 Linux 的安装后步骤。 您也可以在没有 root 权限的情况下安装 Docker，或配置为以 无根模式运行。有关在无根模式下运行 Docker 的说明，请参阅 以非 root 用户身份运行 Docker 守护进程（无根模式）。

安装预发布版本

Docker 还提供了一个便捷脚本，位于 https://test.docker.com/，用于在 Linux 上安装 Docker 的预发布版本。 此脚本与 get.docker.com 处的脚本相同，但会将您的软件包管理器配置为使用 Docker 软件包仓库的测试通道。 测试通道包括 Docker 的稳定版和预发布版（beta 版本、候选发布版）。 使用此脚本可以提前获取新版本，并在它们作为稳定版发布之前在测试环境中进行评估。

要从测试通道在 Linux 上安装最新版本的 Docker，请运行：

$ curl -fsSL https://test.docker.com -o test-docker.sh
$ sudo sh test-docker.sh

使用便捷脚本后升级 Docker

如果您使用便捷脚本安装了 Docker，则应该直接使用包管理器升级 Docker。重新运行便捷脚本没有任何优势。如果它尝试重新安装主机上已存在的仓库，可能会导致问题。

卸载 Docker Engine

1. 卸载 Docker Engine、CLI、containerd 和 Docker Compose 软件包：

   $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
   

2. 主机上的镜像、容器、卷或自定义配置文件 不会自动删除。要删除所有镜像、容器和卷：

   $ sudo rm -rf /var/lib/docker
   $ sudo rm -rf /var/lib/containerd
   

您必须手动删除任何已编辑的配置文件。

后续步骤

• 继续前往 Linux 的安装后步骤。