安装 ArcGIS Notebook Server 和 Windows 容器

在 11.0 中，带有 Windows 容器和 Mirantis Container Runtime 的 ArcGIS Notebook Server 将在 Windows 上作为测试版本提供。

注：

在测试阶段中，这些功能可能存在已知的性能或质量问题，并且不会受到 Esri 技术支持部门的支持。

ArcGIS Notebook Server 和 Windows 容器

与其他 ArcGIS Notebook Server 部署类似，带有 Windows 容器的 ArcGIS Notebook Server 安装于服务器操作系统中，并使用 ArcGIS Enterprise 门户进行配置和联合。 此外，Web Adaptor 可在 ArcGIS Notebook Server 软件之前部署。

ArcGIS Notebook Server 将使用名为容器的虚拟化操作系统来隔离 notebook 创作者的环境。 因此，容器允许每个创作者使用服务器资源子集，且在工作或资源使用中不会互相干扰。

这些容器由第三方软件组件 Mirantis Container Runtime（此前为 Docker Engine Enterprise）进行分配和维护。 在安装 ArcGIS Notebook Server 之前，您必须安装 Mirantis Container Runtime 版本 20.10 或更高版本。 安装 ArcGIS Notebook Server 后，必须将其配置为与 Mirantis Container Runtime 搭配使用。

ArcGIS Notebook Server 将向站点中每个 notebook 创作者针对每个运行时分配一个容器，并且只有他们可以在容器中工作。 创作者在运行 notebook 时使用的计算资源不会影响其他创作者的容器。

当具有相应权限的门户成员打开其第一个 Notebook 时，将启动 ArcGIS Notebook Server 站点上的容器。 Notebook 和容器之间的会话将在整个 notebook 运行期间持续进行。

ArcGIS Notebook Server 可以在一个站点中将多台计算机连接在一起。 多机配置中的计算机必须具有相同的配置，并且每台计算机都可以运行 ArcGIS Notebooks。

Notebook 运行时和 Windows 容器图像

Esri 为 ArcGIS Notebook Server 提供了单个 Windows 容器图像。 此容器图像中包括了标准和高级 notebook 运行时，这使得 Python 资源可在 ArcGIS Notebooks 中使用。 有关每个运行时中可用的库的详细信息，请参阅可用的 Python 库。

可将两个 ArcGIS Notebook Server 运行时（标准和高级）作为容器图像的一部分在 notebook 中使用。 可以使用标准运行时或同时使用标准和高级运行时，具体取决于您的许可和用户权限。

ArcGIS Notebook Server 站点中的 Windows 容器支持进程和 Hyper-V 两种运行时隔离模式。 有关这些模式的详细信息，请参阅有关隔离模式的 Microsoft 文档。 如果您将站点配置为使用 Hyper-V 隔离，则必须在计算机上安装 Hyper-V 角色。

注：

将 Windows 容器与 Hyper-V 搭配使用时，可以运行的容器数量存在限制。 有关详细信息，请参阅此 Microsoft 常见问题解答。

启动容器时，Esri 提供的 Windows 容器图像将应用于该容器。 运行时将取决于为 ArcGIS Notebook Server 配置的许可和 notebook 创作者的权限。

注：

11.0 中存在一个已知限制，当导入 torch 库或将 torch 作为依赖项的 Python 库时，可能会导致 WinError 1455。

注：

fiona、rasterstats 和 rasterio 未安装在 Windows 容器中。

设置必备软件

在安装 ArcGIS Notebook Server 之前，您必须安装和配置以下必备软件。

系统要求

使用 Windows 容器安装 ArcGIS Notebook Server 必须满足以下系统要求：

• Windows Server 2022 是带有 Windows 容器的 ArcGIS Notebook Server 所支持的唯一操作系统。
• 带有 Windows 容器的 ArcGIS Notebook Server 需要 Mirantis Container Runtime 版本 20.10 或更高版本。
• Hyper-V 为可选项，具体取决于您为 ArcGIS Notebook Server 站点选择的运行时隔离模式。
• 带有 Windows 容器的 ArcGIS Notebook Server 至少需要 75 GB 的可用磁盘空间。
• 查看 ArcGIS Notebook Server 系统要求。

启用 Hyper-V（可选）

仅当您打算在 Hyper-V 隔离模式下运行 Windows 容器时才需要 Hyper-V。

要启用 Hyper-V，请参阅 Microsoft 文档中的在 Windows Server 上安装 Hyper-V 角色。

安装 Mirantis Container Runtime

请按照以下步骤在您的计算机上安装 Mirantis Container Runtime。

1. 卸载计算机上所有 Docker 的先前版本。
2. 在安装 Mirantis Container Runtime 之前，请勿在本地服务器上启用容器要素。 如果此要素已启用，请在您的服务器计算机上将其禁用。 有关详细信息，请参阅 Microsoft 文档中的安装或卸载角色、角色服务或要素。
3. 请按照 Mirantis 文档中在 Windows Server 上安装 Mirantis Container Runtime 中的步骤进行操作。
4. 通过运行以下命令验证 Mirantis Container Runtime 是否已安装并已启动：
   docker run hello-world:nanoserver

5. 完成后，请按照以下步骤配置 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://localhost:2375 -H npipe://"

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

   Restart-Service docker

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

   注：

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

安装 ArcGIS Notebook Server

按照安装 ArcGIS Notebook Server 帮助主题中的步骤使用安装向导或命令行来安装 ArcGIS Notebook Server。

安装后配置 ArcGIS Notebook Server

ArcGIS Notebook Server 安装完成后，运行安装后配置实用程序以安装 Windows 容器图像。 在 Esri Early Adopter Community (EAC) 中注册以加入 ArcGIS Enterprise 测试版功能测试计划，以便下载 Windows 容器图像。 对每台已安装 ArcGIS Notebook Server 的计算机执行以下步骤。

1. 以管理员身份打开命令提示符窗口。
2. 将目录更改为 ArcGIS Notebook Server 工具文件夹。 默认情况下，其路径为 C:\Program Files\ArcGIS\NotebookServer\tools\PostInstallUtility。
3. 要确定 Mirantis Container Runtime 在您的计算机上是否处于活动状态，请运行以下命令：

   PostInstallUtility.bat -d

4. 如果未安装 Mirantis Container Runtime，则请使用上面提供的说明对其进行安装和配置。
5. 运行以下命令：

   > PostInstallUtility.bat -l <path of .tar.gz Docker image>

创建 ArcGIS Notebook Server 站点

安装 ArcGIS Notebook Server 并使用安装后配置实用程序配置 Windows 容器图像后，按照创建 ArcGIS Notebook Server 站点中的说明创建服务器站点。

注：

如果您打算在多台计算机上部署 ArcGIS Notebook Server，请在创建站点之前阅读下面的 Notebook Server 目录和配置存储部分的注意事项。

Notebook Server 目录和配置存储的注意事项

如果您计划在多台计算机上部署 ArcGIS Notebook Server，内容目录和配置存储必须使用共享目录，通过通用命名约定 (UNC) 路径进行引用。 工作空间目录必须始终使用配置为映射网络的 UNC 路径，在参与该站点的所有计算机上具有匹配的驱动器盘符，并将其用作工作空间目录。

有关如何配置映射网络驱动器的说明，请参阅下面的为工作空间目录设置映射网络驱动器部分。

为 Notebook Server 启用 Windows 容器要素

成功创建站点后，请按照以下步骤选择将 ArcGIS Notebook Server 与 Windows 容器搭配使用。 创建 ArcGIS Notebook Server 站点后，登录到管理 API 以确保将站点配置为使用 Windows 容器。

1. 以管理员身份登录到 ArcGIS Notebook Server 管理目录。
2. 单击系统 > 属性。
3. 单击更新属性。
4. 更新要设置为 true 的 useWindowsContainers 属性。
5. 单击更新属性以保存更改。
6. Notebook Server 重新启动并且可以访问管理目录后，单击 Notebook > 运行时 > 恢复出厂运行时。

   https://notebook.domain.com:11443/arcgis/admin/notebooks/runtimes/restore

7. 单击恢复出厂运行时来更新 Notebook Server 标准和高级运行时，以使用 Windows 容器图像。

使用 ArcGIS Notebook Server 安装和配置 ArcGIS Web Adaptor

创建 ArcGIS Notebook Server 站点后，您必须安装 ArcGIS Web Adaptor 并将其注册到 ArcGIS Notebook Server。 有关详细信息，请参阅使用 ArcGIS Notebook Server 安装和配置 ArcGIS Web Adaptor。

安装和配置 ArcGIS Notebook Server 示例数据

ArcGIS Notebook Server 中包含的 Esri 精选示例 notebook 需要 ArcGIS Notebook Server 示例数据。 有关详细信息，请参阅安装和配置 ArcGIS Notebook Server 示例数据。

使用 ArcGIS Enterprise 门户配置 Notebook Server

在您安装 ArcGIS Notebook Server、使用 Mirantis Container Runtime 对其进行配置、创建服务器站点并将该站点注册到 Web Adaptor 之后，您即可使用 ArcGIS Enterprise 门户配置该站点。 有关详细信息，请参阅使用门户配置 ArcGIS Notebook Server。

将附加计算机加入 ArcGIS Notebook Server 站点

ArcGIS Notebook Server 支持多机站点。 在多机站点中，每台计算机都必须具有相同的配置、相同的操作系统、相同的 Mirantis Container Runtime 设置，以及具有相同工作空间目录驱动器盘符的映射网络驱动器。 有关详细信息，请参阅将附加计算机加入 ArcGIS Notebook Server 站点主题的安装并配置多机站点部分。

为工作空间目录设置映射网络驱动器

这是一个可选过程，仅当您计划设置多机 Notebook Server 站点时才必须用到。

1. 在可供 Notebook Server 访问的独立计算机上为 ArcGIS Notebook Server 工作空间目录创建 UNC 共享。

   注：

   此目录必须对 ArcGIS Notebook Server Windows 运行方式帐户具有读写权限。 建议您在参与 ArcGIS Notebook Server 站点的计算机以外的计算机上为 ArcGIS Notebook Server 工作空间目录创建 UNC 共享。 存在一个已知问题，即在与 Notebook Server 相同的计算机上创建的 SMB 共享将在重新启动该计算机时断开连接。

2. 在 Notebook Server 计算机上，以管理员身份打开一个 PowerShell 窗口。
3. 将您的 ArcGIS Notebook Server 用户帐户密码另存为受保护字符串，以便稍后使用以下命令：

   $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

4. 为 PowerShell 函数添加凭据支持：

   $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

5. 装载设置了“持续”标记的文件夹：

   New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

6. 在参与 ArcGIS Notebook Server 站点的所有计算机上重复步骤 2 到 5，并为所有计算机上的映射驱动器分配相同的驱动器盘符。
7. 创建 ArcGIS Notebook Server 站点时，使用上一步中创建的共享网络驱动器来配置工作空间目录。

扩展笔记本运行时

有关详细信息，请参阅扩展笔记本运行时。

成功执行本主题中的步骤后，您现在将使用 Windows 容器设置 ArcGIS Notebook Server 部署。