以下步骤描述了如何下载、安装和配置 ArcGIS Notebook Server 所需的 Docker 容器分配软件。 有关 Docker 的简介及其在 ArcGIS Notebook Server 中的用法,请参阅 Docker 和 ArcGIS Notebook Server。
Docker 版本
Docker 以 Docker Desktop 的形式提供。
操作系统 | Docker 版本 | Notebook 运行时(容器)镜像类型 | 其他要求 |
---|---|---|---|
Windows Server 2019 标准版和数据中心版 Windows Server 2022 标准版和数据中心版 | Docker Desktop on Windows(版本 4.24.2) | Linux | 必须提供 Hyper-V |
注:
Docker 是第三方软件组件,本主题可能不会提供此组件的完整安装过程。 有关安装过程的详细信息,请参阅 Docker 站点。
安装 Docker Desktop
按照以下步骤安装 Docker Desktop:
- 通过搜索 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 for Windows(版本 4.24.2)。
- 在浏览器中,转到 Docker Hub 商店中的 Docker Desktop (Windows) 下载页面。
- 登录到您现有的 Docker Hub 账户,或注册一个新账户。
- 下载 Docker Desktop 软件。
- 双击 Docker for Windows Installer 以运行此程序。
- 在安装程序的配置对话框中,取消选中使用 WSL2 而非 Hyper-V。
- 完成运行后请关闭此安装程序。
- 单击开始菜单中的 Docker Desktop 按钮以启动 Docker。
- 使用以下方法之一验证 Docker 是否已启动:
- 检查 Windows 系统托盘中 Docker 图标(通常位于屏幕的右下角)的状态。
- 打开命令提示符窗口,然后运行以下命令:
第一个命令用于提供您计算机上 Docker 的版本;第二个用于验证 Docker 是否可以访问和运行容器镜像。docker version docker run hello-world
配置 Docker 设置
在计算机上安装 Docker 后,请修改下述设置。
配置常规设置
您将使用 Docker 远程 API,此操作需要使用端口 2375。 此端口仅可供 ArcGIS Notebook Server 内部使用,且应防止对其进行外部使用。
- 右键单击 Windows 系统托盘中的 Docker 按钮并单击设置。
- 在常规页面上,选中在不使用 TLS 的 tcp://localhost:2375 上显示后台程序。
您可能会接收到一个安全警告。 请确保您的系统管理员知道此端口为内部使用端口,且不允许对其进行外部访问。
- 如果已选中使用基于 WSL2 的引擎,则取消选中该选项。
更改默认 Docker 镜像安装位置
要更改默认 Docker 镜像安装位置,请执行以下步骤:
- 打开 Docker Desktop 设置。
- 单击资源 > 高级。
- 将 Disk image location 设置为计算机中的选定本地目录路径。
设置文件共享
Docker 容器能够访问将要配置为工作空间目录的本地驱动器或将要配置为 notebook 服务器的自定义数据目录的。 请在初始安装期间执行以下步骤,并在运行方式账户的凭据发生更改或运行方式账户本身发生更改时重复这些步骤。 如果您在 ArcGIS Notebook Server 安装过程中创建了一个账户,则您将返回到这些步骤。
- 右键单击 Windows 系统托盘中的 Docker 按钮并单击设置。
- 从设置菜单中,单击资源 > 文件共享。
- 添加用于 ArcGIS Notebook Server 工作空间或自定义数据目录的驱动器或目录路径。
注:
如果工作空间目录或自定义数据目录(例如 C:\arcgisnotebookserver)当前不存在,请在执行此步骤之前创建 ArcGIS Notebook Server 站点或注册数据目录。
注:
用于 Windows 的 Docker 仅支持 Windows 上的本地目录,这些目录将与 Linux 容器共享。
配置高级资源
您可以使用 Docker Desktop 设置面板为 ArcGIS Notebook Server 和运行于您服务器站点的容器限制可用资源。
- 右键单击 Windows 系统托盘中的 Docker 按钮并选择设置。 在设置菜单上,单击资源 > 高级。
- 更改以下设置:
- CPU:计算机上容器可用的 CPU 内核数。 默认情况下,设置为两个内核。 您可以根据计算机上的可用资源和为 notebook 运行时设置的 CPU 限制来更新此值。
- 内存:计算机上容器可用的内存量。 默认情况下,设置为 2 GB。 将此设置值增加到最低 6 GB。 您可能想要根据计算机上的可用资源和为 notebook 运行时设置的内存限制来增加此值。
- 交换:达到上述限制时容器可用于内存的磁盘空间量。
- 磁盘镜像大小 - 磁盘镜像的大小。 如果为 Notebooks 安装 Docker 容器镜像导致出现磁盘空间不足错误,请查看并根据需要更新此值。
- 磁盘镜像位置 - 存储容器和镜像的目录。
注:
在对 notebook 运行时配置的 CPU 或内存资源进行更新时,随时都可以重新访问此步骤。 - 设置好资源限制后,请单击应用。
安装 Docker 组件后,请重新启动计算机。 每次安装或升级 Docker 组件时,都必须重新启动计算机。
现在,您即可在计算机上安装 ArcGIS Notebook Server 了。