为 ArcGIS Notebook Server 安装 Docker

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

下载和安装 Docker

在 Windows 上运行 ArcGIS Notebook Server 所需的 Docker 版本为 Docker Desktop Community。 可通过 Docker Desktop for Windows 应用程序对其进行访问。 请按照以下步骤在您的计算机上安装 Docker。

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

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

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

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

配置 Docker 设置

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

使用端口 2375

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

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

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

设置文件共享

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. 设置好资源限制后，请单击应用。

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

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