为 ArcGIS Notebook Server 安装容器引擎（Linux 容器）

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

下载和安装 Docker

Docker 有两个版本可用于 Linux 系统：Docker Engine Community 和 Mirantis Container Runtime。ArcGIS Notebook Server 支持 Red Hat Enterprise Linux 和 Ubuntu 操作系统。 您应使用的 Docker 版本取决于您的计算机所运行的操作系统 (OS)：

• 如果您正在运行 Red Hat Enterprise Linux，则 ArcGIS Notebook Server 仅支持 Mirantis Container Runtime。
• 如果您正在运行 Ubuntu，则可以使用任何一个 Docker 版本。 有关适合您部署版本的详细信息，请参阅 Docker 和 ArcGIS Notebook Server。

Docker 版本	操作系统	Notebook 运行时（容器）镜像类型
Docker Engine 社区版 20.10.13 或更高版本	Ubuntu Server LTS 18.04 Ubuntu Server LTS 20.04 Ubuntu Server LTS 22.04 Rocky Linux 8.6	Linux
Mirantis Container Runtime 20.10.13 版本或更高版本	Ubuntu Server LTS 18.04 Ubuntu Server LTS 20.04 Ubuntu Server LTS 22.04 Red Hat Enterprise Linux Server 8.6 Oracle Linux 8.6 Rocky Linux 8.6	Linux

注：

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

在 Red Hat Enterprise Linux、Ubuntu 和 Rocky 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

4. 请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：
   $ sudo docker run hello-world

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

在 Ubuntu 上安装 Docker Engine Community

此 Docker Engine Community 版本可以免费下载，但要求您拥有一个 Docker 帐户。

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

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

2. 请遵循获取适用于 Ubuntu 的 Docker CE 中的步骤。

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

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

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

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

在 Rocky Linux 上安装 Docker Engine Community

此 Docker Engine Community 版本可以免费下载，但要求您拥有一个 Docker 帐户。

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

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

2. 按照 Rocky Linux Docker 指南中的步骤操作。

   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>

2. 登出并重新登录到 OS 用户帐户以使更改生效，并验证您是否可以从该帐户运行 Docker 命令。

   $ docker run hello-world

   Docker 使用 /var 目录作为容器镜像的本地注册表。 在后续版本的升级过程中，新镜像也将复制到 /var 目录。

3. 为避免将来升级时磁盘空间不足，请确保 /var 目录至少有 50 GB 的磁盘空间。
4. 切换至根帐户。 要将 Docker 用于存储容器镜像的目录由 /var/lib/docker 更改为其他目录，请在终端中输入以下命令（请注意，这些命令将停止并重新启动 Docker）。

   在以下命令中，新的目标目录为 /data/docker：

   1. systemctl stop docker.service
   2. mkdir /data/docker
   3. chmod 755 /var/lib/docker
   4. mv /var/lib/docker /data/docker
   5. ln -s /data/docker /var/lib/docker
   6. systemctl start docker.service

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