为 ArcGIS Notebook Server 安装 Docker

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

Docker 版本

Docker 共有两个版本。 Docker Desktop 和 Mirantis Container Runtime（之前为 Docker Engine Enterprise）。

操作系统	Docker 版本	Notebook 运行时（容器）镜像类型	其他要求
Windows Server 2019 标准版和数据中心版 Windows Server 2022 标准版和数据中心版	Windows 版本 4.4.4 或更高版本上的 Docker Desktop	Linux	必须提供 Hyper-V
Windows Server 2022 标准版和数据中心版	Mirantis Container Runtime 版本 20.10 或更高版本	Windows 测试版本	Hyper-V 为可选项。 在 Windows Server 2022 标准版上可以使用 Hyper-V 隔离运行的容器的最大数量存在限制。 有关详细信息，请参阅 Windows 常见问题解答。

在 ArcGIS Notebook Server 11.0 中，Docker Desktop 是与 Windows 搭配使用的合适版本。 您可通过该软件运行 ArcGIS Notebook Server。

注：

在 ArcGIS Notebook Server 11.0 版本中，ArcGIS Notebook Server 支持将 Mirantis Container Runtime for Windows Server 作为测试版本。 对于此版本，建议您仅出于测试目的将 ArcGIS Notebook Server 与 Mirantis Container Runtime 搭配使用。

有关在 11.0 中将 Mirantis Container Runtime 与 ArcGIS Notebook Server 搭配使用的详细信息，请参阅 Docker 和 ArcGIS Notebook Server。

注：

Docker 和 Mirantis Container Runtime 是第三方软件组件，本主题可能不会提供安装它们的完整过程。 有关其安装过程的详细信息，请参阅 Docker 和 Mirantis Container Runtime 站点。

安装 Docker Desktop

按照以下步骤安装 Docker Desktop：

1. 通过搜索 Hyper-V Manager 应用程序来验证 Windows 计算机上是否安装了 Hyper-V。 如果不是这样，请在继续之前进行安装。 有关步骤，请参阅以下 Microsoft 文档：
   • 如果您的操作系统是 Windows Server 2022 或 Windows Server 2019，请参阅在 Windows Server 上安装 Hyper-V 角色。
   • 如果您的操作系统是 Windows 10，请参阅在 Windows 10 上安装 Hyper-V。

   ArcGIS Notebook Server 需要 Docker Desktop 可用于 Windows（版本 4.4.4 或更高版本）。

2. 在浏览器中，转到 Docker Hub 商店中的 Docker Desktop (Windows) 下载页面。
3. 登录到您现有的 Docker Hub 帐户，或注册一个新帐户。
4. 下载 Docker Desktop 软件。
5. 双击 Docker for Windows Installer 以运行此程序。
6. 在安装程序的配置对话框中，取消选中使用 WSL2 而非 Hyper-V。
7. 完成运行后请关闭此安装程序。
8. 单击开始菜单中的 Docker Desktop 按钮以启动 Docker。
9. 使用以下方法之一验证 Docker 是否已启动：
   • 检查 Windows 系统托盘中 Docker 图标（通常位于屏幕的右下角）的状态。
   • 打开命令提示符窗口，然后运行以下命令：
     docker version
     docker run hello-world

     第一个命令用于提供您计算机上 Docker 的版本；第二个用于验证 Docker 是否可以访问和运行容器镜像。

配置 Docker 设置

在计算机上安装 Docker 后，请修改下述设置。

修改常规设置

您将使用 Docker 远程 API，此操作需要使用端口 2375。 此端口仅可供 ArcGIS Notebook Server 内部使用，且应防止对其进行外部使用。

1. 右键单击 Windows 系统托盘中的 Docker 按钮并单击设置。
2. 在常规页面上，选中在不使用 TLS 的 tcp://localhost:2375 上显示后台程序。

   您可能会接收到一个安全警告。 请确保您的系统管理员知道此端口为内部使用端口，且不允许对其进行外部访问。

3. 如果已选中使用基于 WSL2 的引擎，则取消选中该选项。

设置文件共享

Docker 容器能够访问将要配置为工作空间目录的本地驱动器或将要配置为 notebook 服务器的自定义数据目录的。 请在初始安装期间执行以下步骤，并在运行方式帐户的凭据发生更改或运行方式帐户本身发生更改时重复这些步骤。 如果您在 ArcGIS Notebook Server 安装过程中创建了一个帐户，则您将返回到这些步骤。

1. 右键单击 Windows 系统托盘中的 Docker 按钮并单击设置。
2. 从设置菜单中，单机资源 > 文件共享。
3. 添加用于 ArcGIS Notebook Server 工作空间或自定义数据目录的驱动器或目录路径。

   注：

   如果工作空间目录或自定义数据目录（例如 C:\arcgisnotebookserver）当前不存在，请在执行此步骤之前创建 ArcGIS Notebook Server 站点或注册数据目录。

   注：

   用于 Windows 的 Docker 仅支持 Windows 上的本地目录，这些目录将与 Linux 容器共享。

限制高级资源

您可以使用 Docker Desktop 设置面板为 ArcGIS Notebook Server 和运行于您服务器站点的容器限制可用资源。

1. 右键单击 Windows 系统托盘中的 Docker 按钮并选择设置。 在设置菜单上，单击资源 > 高级。
2. 或者，更改以下设置：
   • CPU：计算机上容器可用的 CPU 内核数。 默认情况下，设置为两个内核。 您可以根据计算机上的可用资源和为 notebook 运行时设置的 CPU 限制来更新此值。
   • 内存：计算机上容器可用的内存量。 默认情况下，设置为 2 GB。 将此设置值增加到最低 6 GB。 您可能想要根据计算机上的可用资源和为 notebook 运行时设置的内存限制来增加此值。
   • 交换：达到上述限制时容器可用于内存的磁盘空间量。
   • 磁盘镜像大小 - 磁盘镜像的大小。 如果为 Notebooks 安装 Docker 容器镜像导致出现磁盘空间不足错误，请查看并根据需要更新此值。
   • 磁盘镜像位置 - 存储容器和镜像的目录。

   注：

   在对 notebook 运行时配置的 CPU 或内存资源进行更新时，随时都可以重新访问此步骤。

3. 设置好资源限制后，请单击应用。

在 Windows 上安装 Mirantis Container Runtime

警告：

系统支持将 Windows 上的 Mirantis Container Runtime 作为 Windows Server 2022 上 ArcGIS Notebook Server 的测试版本。 在测试阶段中，这些功能可能存在已知的性能或质量问题，并且不会受到 Esri 技术支持部门的支持。 请勿启用 Hyper-V，原因是在 Windows Server 2022 上安装 Mirantis Container Runtime 不需要用到它。 在安装 Mirantis Container Runtime 之前，请勿在本地服务器上启用容器要素。

1. 卸载计算机上所有 Docker 的先前版本。
2. 按照 Mirantis 提供的在 Windows Server 上安装 MCR 文档中介绍的步骤进行操作。
3. 通过运行以下命令验证 Mirantis Container Runtime 是否已正确安装并已启动：

   docker run hello-world:nanoserver

4. 完成后，请按照以下步骤配置 Mirantis Container Runtime。

配置 Mirantis Container Runtime

可遵循以下步骤在您的计算机中配置 Mirantis Container Runtime。

1. 启用端口 2375 以便能够使用 Docker 远程 API。

   此端口仅可供 ArcGIS Notebook Server 内部使用，且应防止对其进行外部使用。

   以管理员身份打开命令提示符，然后运行以下命令：

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

2. 以管理员身份打开一个 PowerShell 窗口，并运行以下命令：
   Restart-Service docker

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

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