Skip to main content

为 ArcGIS Notebook Server 安装容器引擎

以下步骤描述了如何下载、安装和配置 ArcGIS Notebook Server 所需的容器分配软件。 有关容器引擎以及如何在 ArcGIS Notebook Server 中使用的介绍，请参阅容器引擎和 ArcGIS Notebook Server。

下载并安装容器引擎

Linux 系统支持两种容器引擎：Docker Engine 和 Mirantis Container Runtime。

如果正在运行 Ubuntu 或 Red Hat Enterprise Linux Server，可以使用任一 Docker 版本。

容器引擎

操作系统

Docker Engine Community edition 29.2.0 或更高版本

注:

如果当前使用的是 Docker Engine 29 或更高版本，并且该版本是从历史版本升级而来，请编辑 /etc/docker/daemon.json 以启用 containerd 镜像存储。 有关详细信息，请参阅配置 Docker 设置和环境中的步骤 4。

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 update 10

Red Hat Enterprise Linux Server 9 update 7

Rocky Linux 8 update 10

Rocky Linux 9 update 7

AlmaLinux 8 update 10

AlmaLinux 9 update 7

Mirantis Container Runtime 25.0.15 或更高版本

注:

有关最新信息，请参阅 Mirantis Container Runtime 25.0 兼容性矩阵。

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 update 10

Red Hat Enterprise Linux Server 9 update 7

Oracle Linux 9 update 7

Rocky Linux 8 update 10

Rocky Linux 9 update 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

在 Windows 上使用 Mirantis Container Runtime 的 ArcGIS Notebook Server 支持以下操作系统：

操作系统

容器引擎

其他要求

Windows Server 2022 标准版和数据中心版

Mirantis Container Runtime 25.0.15 或更高版本

（可选）您可以安装 Hyper-V。

注:

在 Windows Server 标准版上可以使用 Hyper-V 隔离运行的容器的最大数量存在限制。

有关详细信息，请参阅 Windows 常见问题解答。

通过二进制文件安装的 Docker Engine

在 Windows 上使用通过二进制文件安装的 Docker Engine 的 ArcGIS Notebook Server 支持以下操作系统和 Docker Engine 版本：

操作系统

容器引擎

其他要求

Windows Server 2025 标准版和数据中心版

Windows Server 2022 标准版和数据中心版

Docker Engine - 社区版 29.2.0 或更高版本

（可选）您可以安装 Hyper-V。

注:

在 Windows Server 标准版上可以使用 Hyper-V 隔离运行的容器的最大数量存在限制。

有关详细信息，请参阅 Windows 常见问题解答。
注:

由于 Docker 为第三方软件组件，本主题不会详细介绍安装 Docker 的完整步骤。 查看并参考 Docker 网站以获取最新信息。

在 Red Hat Enterprise Linux Server、Ubuntu、SUSE Linux Enterprise Server 以及 Oracle Linux 上安装 Mirantis Container Runtime

要安装 Mirantis Container Runtime，您必须获得该软件的试用版或订阅该软件。

  1. 卸载计算机上所有 Docker 的先前版本。

    有关卸载的完整步骤，请参阅该版本的 Docker 文档。

  2. 按照您的 Linux 发行版的 Mirantis Container Runtime 安装指南中的步骤操作。

    注:

    当前，Mirantis 没有适用于 Rocky Linux 的独立安装指南，但是可以按照 Red Hat Enterprise Linux 安装指南中的步骤在 Rocky Linux 上进行安装。

    注:

    该文档概述了可用于安装软件的两种方法（从 Docker 资料档案库或通过 RPM 包）。

  3. 由于安装和配置后，Docker 不会自动启动，请通过运行以下命令来启动 Docker 后台程序：

$ sudo systemctl start docker

  1. 请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：

$ sudo docker run hello-world

继续下方的配置 Docker 设置和环境部分。

在 Red Hat Enterprise Linux Server、Oracle Linux、Rocky Linux 或 AlmaLinux 上安装 Docker Engine

此 Docker Engine 版本支持免费下载，但您必须拥有 Docker 账户。

  1. 卸载计算机上所有 Docker 的先前版本。

    有关卸载的完整步骤，请参阅该版本的 Docker 文档。

  2. 按照在 RHEL 上安装 Docker Engine 中的步骤进行操作。

    该文档概述了可用于安装软件的两种方法（从 RPM 资料档案库或通过 RPM 包）。

    Docker 后台程序将在安装后自动启动。

  3. 请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：

$ sudo docker run hello-world

继续下方的配置 Docker 设置和环境部分。

在 Ubuntu 上安装 Docker Engine

此 Docker Engine 版本支持免费下载，但您必须拥有 Docker 账户。

  1. 卸载计算机上所有 Docker 的先前版本。

    有关卸载的完整步骤，请参阅该版本的 Docker 文档。

  2. 按照在 Ubuntu 上安装 Docker Engine 中的步骤进行操作。

    该文档概述了可用于安装软件的两种方法（从 Docker 资料档案库或通过 DEB 包）。

    Docker 后台程序将在安装后自动启动。

  3. 请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：

$ sudo docker run hello-world

继续下方的配置 Docker 设置和环境部分。

配置 Docker 设置和环境

当计算机上安装了相应的 Docker 版本后，请配置 Docker 以与 ArcGIS Notebook Server 配合使用。

  1. 将您的操作系统用户账户（或用于安装 ArcGIS Notebook Server 的账户）添加到名为 docker 的组中，该组在安装时自动创建。

$ sudo usermod -aG docker <ArcGIS Notebook Server install account>

  1. 登出并重新登录到 OS 用户账户以使更改生效。

  2. 验证您是否可以使用该账户运行 Docker 命令。

$ docker run hello-world

  1. 如果当前使用的是 Docker Engine 29 或更高版本，并且该版本是从历史版本升级而来，请编辑 /etc/docker/daemon.json 以启用 containerd 镜像存储。

    {
  "features": {
    "containerd-snapshotter": true
  }
}
    注:

    如果 daemon.json 不存在，请进行创建。

  2. 确保 /var 目录至少有 75 GB 的磁盘空间。

    Docker 使用 /var 目录作为容器镜像的本地注册表。 在后续版本的升级过程中，新镜像也将复制到 /var 目录。 如果空间不足，请增加对 /var 目录的分配空间，或者按照以下子步骤更改 Docker 根目录的位置。

    1. 编辑 /etc/docker/daemon.json 以将计算机上具有足够空间的本地目录设置为数据根目录 (data-root)。

      注:

      如果此文件不存在，进行创建。

      示例路径：

      {"data-root" : "/data/docker"}

      以下是包含 containerd-snapshotter 与 data-root 属性的 /etc/docker/daemon.json 示例：

      {
   "features": {
      "containerd-snapshotter": true
   },
   "data-root" : "/data/docker"
}

    2. 移除 /var/lib/docker 并创建指向上一步中指定的路径的符号链接。

       $ sudo mkdir /data/docker
   $ sudo rm -rf /var/lib/docker
   $ sudo ln -s /data/docker /var/lib/docker
    1. 仅在使用 Docker 容器引擎版本 29 时需要此步骤。 移除 /var/lib/containerd 并创建指向上一步中指定的路径的符号链接。
       $ sudo mkdir /data/containerd
   $ sudo rm -rf /var/lib/containerd
   $ sudo ln -s /data/containerd /var/lib/containerd

  3. 重新启动 Docker 服务以应用更改。

    $ sudo systemctl stop docker.service
$ sudo systemctl stop docker.socket
$ sudo systemctl stop containerd
$ sudo systemctl start containerd
$ sudo systemctl start docker.service
$ sudo systemctl start docker.socket

现在，您即可在计算机上安装 ArcGIS Notebook Server 了。

容器引擎要求

Windows 上的 ArcGIS Notebook Server 支持将 Mirantis Container Runtime 和通过二进制文件安装的 Docker Engine 作为容器引擎。 有关容器引擎以及如何在 ArcGIS Notebook Server 中集成的介绍，请参阅容器引擎和 ArcGIS Notebook Server。

Linux 系统支持两种容器引擎：Docker Engine 和 Mirantis Container Runtime。

如果正在运行 Ubuntu 或 Red Hat Enterprise Linux Server，可以使用任一 Docker 版本。

容器引擎

操作系统

Docker Engine Community edition 29.2.0 或更高版本

注:

如果当前使用的是 Docker Engine 29 或更高版本，并且该版本是从历史版本升级而来，请编辑 /etc/docker/daemon.json 以启用 containerd 镜像存储。 有关详细信息，请参阅配置 Docker 设置和环境中的步骤 4。

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 update 10

Red Hat Enterprise Linux Server 9 update 7

Rocky Linux 8 update 10

Rocky Linux 9 update 7

AlmaLinux 8 update 10

AlmaLinux 9 update 7

Mirantis Container Runtime 25.0.15 或更高版本

注:

有关最新信息，请参阅 Mirantis Container Runtime 25.0 兼容性矩阵。

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 update 10

Red Hat Enterprise Linux Server 9 update 7

Oracle Linux 9 update 7

Rocky Linux 8 update 10

Rocky Linux 9 update 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

在 Windows 上使用 Mirantis Container Runtime 的 ArcGIS Notebook Server 支持以下操作系统：

操作系统

容器引擎

其他要求

Windows Server 2022 标准版和数据中心版

Mirantis Container Runtime 25.0.15 或更高版本

（可选）您可以安装 Hyper-V。

注:

在 Windows Server 标准版上可以使用 Hyper-V 隔离运行的容器的最大数量存在限制。

有关详细信息，请参阅 Windows 常见问题解答。

通过二进制文件安装的 Docker Engine

在 Windows 上使用通过二进制文件安装的 Docker Engine 的 ArcGIS Notebook Server 支持以下操作系统和 Docker Engine 版本：

操作系统

容器引擎

其他要求

Windows Server 2025 标准版和数据中心版

Windows Server 2022 标准版和数据中心版

Docker Engine - 社区版 29.2.0 或更高版本

（可选）您可以安装 Hyper-V。

注:

在 Windows Server 标准版上可以使用 Hyper-V 隔离运行的容器的最大数量存在限制。

有关详细信息，请参阅 Windows 常见问题解答。

安装 Mirantis Container Runtime

要安装 Mirantis Container Runtime，请完成以下步骤：

  1. 卸载计算机上所有 Docker 的先前版本。

  2. 在安装 Mirantis Container Runtime 之前，请勿在本地服务器上启用容器功能。 如果此功能已启用，请在您的服务器计算机上将其禁用。 有关详细信息，请参阅 Microsoft 文档中的安装或卸载角色、角色服务或功能。

  3. 要获取并运行适用于 Windows Server 的 Mirantis Container Runtime 的 install.ps1 安装脚本，请按照 Mirantis 文档中在 Windows Server 上安装 Mirantis Container Runtime 中的步骤进行操作。

    要运行安装脚本，请使用下方代码：

    ./install.ps1

  4. 通过运行以下命令验证 Mirantis Container Runtime 是否已安装并已启动：

docker run hello-world:nanoserver

  1. 完成后，请按照配置 Docker 组件中的步骤配置 Mirantis Container Runtime。

通过二进制文件安装 Docker Engine

要通过二进制文件安装 Docker Engine，请完成以下步骤：

  1. 卸载计算机上所有 Docker 的先前版本。

  2. 如果容器功能已启用，请在本地服务器上禁用此功能。

    有关详细信息，请参阅 Microsoft 文档。

  3. 在 Microsoft PowerShell 中使用管理权限运行以下命令以启用 Windows 容器功能：

Add-WindowsFeature Containers

  1. 按照提示重新启动计算机。

  2. 通过运行以下命令验证容器功能的安装情况：

Get-WindowsFeature Containers

  1. 请按照 Docker 文档的在 Windows 上安装服务器和客户端二进制文件部分中的说明操作。

    注:

    通过二进制文件安装的 Docker Engine 不会自动更新。 您必须手动将 Docker 升级至较新的版本。 有关通过二进制文件安装的 Docker 在生产环境中的使用限制，请参阅通过二进制文件安装 Docker Engine 文档。 虽然本页面推荐使用 Docker Desktop，但使用 Windows 容器的 ArcGIS Notebook Server 并不支持在 Windows 上使用 Docker Desktop 作为容器引擎。

  2. 将 Docker 目录路径（例如 C:\Program Files\docker）添加到系统变量中的“路径”环境变量。

  3. 通过运行以下命令验证安装情况和 Docker 后台程序的运行状态：

docker version

  1. 完成后，请按照配置 Docker 组件中的步骤配置 Docker Engine。

配置 Docker 组件

要配置 Docker 组件，请完成以下步骤：

  1. 如果用于安装 ArcGIS Notebook Server 的账户不属于管理员组，则执行以下步骤：

    1. 从 Windows 计算机的开始菜单打开计算机管理应用程序。

    2. 在左侧边栏上，展开本地用户和组项目，然后打开组文件夹。

    3. 从组列表中选择 docker-users 组，然后双击。

      如果 docker-users 组尚不存在，请进行创建。

    4. 单击添加按钮，找到用于安装 ArcGIS Notebook Server 的账户，然后将其选中。 单击确定以确认。

    5. 单击确定以关闭组对话框。

    6. 在 C:\ProgramData\docker\config\daemon.json 下创建配置文件以设置 Docker 的安全组。

    7. 编辑 C:\ProgramData\docker\config\daemon.json 以添加 docker-users 组。

       {
     "group" : "docker-users"
   }

  2. 将 Docker 服务配置为通过以下命令在指定管道上侦听：

sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H npipe://"

  1. 使用以下命令重新启动 Docker：

    net stop docker
net start docker

  2. 安装 Docker 组件后，请重新启动计算机。

    注:

    每次安装或升级 Docker 组件时，都必须重新启动计算机。

更改默认 Docker 镜像安装位置

（可选）要更改默认 Docker 镜像安装位置，请完成以下步骤：

  1. 编辑 C:\ProgramData\docker\config\daemon.json 下的文件。

  2. 通过将 data-root 位置设置为本地计算机上所选的位置来更改默认 Docker 镜像安装位置。

     {
"data-root": "d:\\\\docker"
}

  3. 保存 daemon.json。

  4. 通过运行以下命令重新启动 Docker：

    net stop docker
net start docker

现在，您即可在计算机上安装 ArcGIS Notebook Server 了。

为 Docker 配置一个非默认临时目录

Docker Engine 29.4 及更高版本支持使用 DOCKER_TMPDIR 环境变量配置非默认临时目录。 此环境变量使 Docker 能够使用默认 C:\temp 位置以外的目录进行临时存储，例如在安装后加载 Notebook 运行时镜像期间。 按照以下步骤为 Docker 配置一个非默认临时目录：

  1. 在非默认驱动器上创建一个临时目录。

    示例：

    d:\docker-temp

  2. 在 Windows 中，依次单击系统属性 > 高级 > 环境变量 > 系统变量。

  3. 使用以下信息设置系统范围的环境变量：

    变量名称：DOCKER_TMPDIR

    变量值：<new temporary directory created in step 1>

  4. 重启 Docker 服务：

    net stop docker
net start docker