在 SLES (s390x) 上安装 Docker Engine

注意

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

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

先决条件

操作系统要求

要安装 Docker Engine,您需要以下 SLES 版本之一的维护版本:

  • SLES 15-SP4 (s390x, IBM Z)
  • SLES 15-SP5 (s390x, IBM Z)

您必须启用 SCC SUSE 仓库。

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

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

卸载旧版本

在安装 Docker Engine 之前,您需要卸载任何冲突的软件包。

您的 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 可能会报告您未安装这些软件包。

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

安装方法

您可以根据需要通过不同的方式安装 Docker Engine:

  • 您可以设置 Docker 的仓库并从中安装,以便于安装和升级。这是推荐的方法。

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

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

使用 rpm 仓库安装

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

设置仓库

设置仓库。

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

安装 Docker Engine

  1. 安装 Docker 软件包。


    要安装最新版本,请运行:

    $ 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:28.1.1-1 | s390x | Docker CE Stable - s390x
      v  | docker-ce | package | 3:28.1.0-1 | s390x | Docker CE Stable - s390x
    

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

    通过其完全限定的软件包名称安装特定版本,即软件包名称 (docker-ce) 加上版本字符串(第 2 列),用连字符 (-) 分隔。例如,docker-ce-3:28.1.1

    <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 Engine。

    $ 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 Engine

要升级 Docker Engine,请按照安装说明进行操作,选择您要安装的新版本。

从软件包安装

如果您无法使用 Docker 的 rpm 仓库安装 Docker Engine,可以下载您的发行版的 .rpm 文件并手动安装。每次要升级 Docker Engine 时,都需要下载新的文件。

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

  2. 安装 Docker Engine,将以下路径更改为您下载 Docker 软件包的路径。

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

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

  3. 启动 Docker Engine。

    $ 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 Engine

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

使用便捷脚本安装

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

在本地运行从互联网下载的脚本之前,务必检查它们。在安装之前,请熟悉便捷脚本的潜在风险和限制:

  • 该脚本需要 rootsudo 权限才能运行。
  • 该脚本会尝试检测您的 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 Engine。在基于 Debian 的发行版上,docker 服务会自动启动。在基于 RPM 的发行版上,如 CentOS、Fedora、RHEL 或 SLES,您需要使用相应的 systemctlservice 命令手动启动它。如消息所示,默认情况下非 root 用户无法运行 Docker 命令。

将 Docker 用作非特权用户,还是以无根模式安装?

安装脚本需要 rootsudo 权限才能安装和使用 Docker。如果您想授予非 root 用户访问 Docker 的权限,请参阅 Linux 安装后步骤。您也可以在没有 root 权限的情况下安装 Docker,或将其配置为以无根模式运行。有关在无根模式下运行 Docker 的说明,请参阅以非 root 用户(无根模式)运行 Docker daemon

安装预发布版本

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

要从测试通道安装 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
    

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

后续步骤

页面选项