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

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

下载和安装 Docker

两个版本的 Docker 适用于 Linux 系统：Docker Engine 和 Mirantis Container Runtime。

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


Docker 版本	操作系统	Notebook 运行时（容器）镜像类型
Docker Engine 社区版 28.3.0 或更高版本注：如果当前使用的是 Docker Engine 29 或更高版本，并且不是从先前版本升级而来的，请编辑 /etc/docker/daemon.json 以禁用 containerd 镜像存储。	Ubuntu Server LTS 24.04.2 Ubuntu Server LTS 22.04.5 Red Hat Enterprise Linux Server 9 update 6 Rocky Linux 9 update 6 AlmaLinux 9 update 6	Linux
Mirantis Container Runtime version 25.0.11 或更高版本	Ubuntu Server LTS 22.04.5 Red Hat Enterprise Linux Server 9 update 6 Oracle Linux 9 update 6 SUSE Linux Enterprise Server (SLES) 15 SP7	Linux

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

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

卸载计算机上所有 Docker 的先前版本。
有关完整的卸载步骤，请参阅该版本的 Docker 文档。
按照您的 Linux 发行版的 Mirantis Container Runtime 安装指南中的步骤操作。
注：
当前，Mirantis 没有适用于 Rocky Linux 的独立安装指南，但是可以按照 Red Hat Enterprise Linux 安装指南中的步骤在 Rocky Linux 上进行安装。
注：
该文档概述了可用于安装软件的两种方法（从 Docker 资料档案库或通过 RPM 包）。
由于安装和配置后，Docker 不会自动启动，请通过运行以下命令来启动 Docker 后台程序：
```
$ sudo systemctl start docker
```
请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：
```
$ sudo docker run hello-world
```

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

卸载计算机上所有 Docker 的先前版本。
有关完整的卸载步骤，请参阅该版本的 Docker 文档。
按照在 CentOS 上安装 Docker 引擎中的步骤进行操作。
该文档概述了可用于安装软件的两种方法（从 Docker 资料档案库或通过 DEB 包）。
Docker 后台程序将在安装后自动启动。
请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：
```
$ sudo docker run hello-world
```

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

卸载计算机上所有 Docker 的先前版本。
有关完整的卸载步骤，请参阅该版本的 Docker 文档。
按照在 Ubuntu 上安装 Docker 引擎中的步骤进行操作。
该文档概述了可用于安装软件的两种方法（从 Docker 资料档案库或通过 DEB 包）。
Docker 后台程序将在安装后自动启动。
请运行以下命令，以验证 Docker 是否已正确安装并且可以访问容器镜像：
```
$ sudo docker run hello-world
```

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

在计算机上安装了适当的 Docker 版本后，请配置 Docker 以便与 ArcGIS Notebook Server 搭配使用。

将您的操作系统用户账户（或用于安装 ArcGIS Notebook Server 的账户）添加到名为 docker 的组中，该组在安装时自动创建。
```
$ sudo usermod -aG docker <ArcGIS Notebook Server install account>
```
登出并重新登录到 OS 用户账户以使更改生效。
验证您是否可以从该账户运行 Docker 命令。
```
$ docker run hello-world
```
如果当前使用的是 Docker Engine 29 或更高版本，并且不是从先前版本升级而来的，请编辑 /etc/docker/daemon.json 以禁用 containerd 镜像存储。
```
{
  "features": {
    "containerd-snapshotter": false
  }
}
```
注：
如果 daemon.json 不存在，请进行创建。
确保 /var 目录至少有 75 GB 的磁盘空间。
Docker 使用 /var 目录作为容器镜像的本地注册表。在后续版本的升级过程中，新镜像也将复制到 /var 目录。如果空间不足，请增加对 /var 目录的分配，或者按照以下子步骤更改 Docker 根目录的位置。
1. 编辑 /etc/docker/daemon.json 以将数据根目录设置为具有足够空间的计算机上的本地目录。
  注：
  如果此文件不存在，进行创建。
  示例路径：
  {"data-root" : "/data/docker"}
2. 移除 /var/lib/docker 并创建指向上一步中指定的路径的符号链接。
  $ rm -rf /var/lib/docker $ ln -s /data/docker /var/lib/docker

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

$ systemctl stop docker.service
$ systemctl start docker.service

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