在 SLES (s390x) 上安装 Docker Engine

目录

注意

此页面上的安装说明指的是适用于 **s390x** 架构 (IBM Z) 的 SLES 软件包。其他架构（包括 x86_64）不受 SLES 支持。

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

先决条件

操作系统要求

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

  • SLES 15-SP4 on s390x (IBM Z)
  • SLES 15-SP5 on 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:27.3.1-1 | s390x | Docker CE Stable - s390x
  v  | docker-ce | package | 3:27.3.0-1 | s390x | Docker CE Stable - s390x

    返回的列表取决于启用的存储库，并且特定于您的SLES版本。

    通过其完全限定的包名称安装特定版本，该名称是包名称 (docker-ce) 加上版本字符串 (第二列)，用连字符 (-) 分隔。例如，docker-ce-3:27.3.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存储库中找到它。

在本地运行下载的脚本之前，务必检查其内容。安装之前，请熟悉便捷脚本的潜在风险和限制。

  • 该脚本需要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 Engine。在基于Debian的发行版上，docker服务会自动启动。在基于RPM的发行版（如CentOS、Fedora、RHEL或SLES）上，您需要使用适当的systemctl或service命令手动启动它。如消息所示，默认情况下，非root用户无法运行Docker命令。

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

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

安装预发行版

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

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

后续步骤