在 Azure 上安装#

目标#

通过本教程，您应该能够在 Microsoft Azure 上运行一个 JupyterHub，其中包含一些管理员用户和安装了您所需软件包的用户环境。

本教程将指导您逐步在 Azure 云上手动部署您自己的 JupyterHub。

注意

✨ 部署到 Azure 按钮 项目允许您以最少的手动配置步骤部署您自己的 JupyterHub。“部署到 Azure”按钮允许您通过一次点击和分配一些变量来获得一个原始配置。

请访问 trallard/TLJH-azure-button 查看。

先决条件#

  • 一个 Microsoft Azure 帐户。

  • 要开始使用，您可以获得一个免费帐户，其中包含价值 150 美元的 Azure 积分（在此处获取免费帐户）

这些说明涵盖了如何在 Microsoft Azure 上设置虚拟机。有关创建和配置 JupyterHub 的后续信息，请参阅 The Littlest JupyterHub 指南。

步骤1：安装The Littlest JupyterHub#

我们首先创建可以运行 TLJH (The Littlest JupyterHub) 的虚拟机。

  1. 转到 Azure 门户并使用您的 Azure 帐户登录。

  2. 通过点击仪表板左上角的“>>”按钮展开左侧面板。找到“虚拟机”选项卡并点击它。

    Virtual machines on Azure portal

  3. 点击 + 添加 创建新的虚拟机

    Add a new virtual machine

  4. 在下一个屏幕中选择 从 Marketplace 创建 VM。将显示一个新屏幕，其中包含 Azure 中虚拟机的所有选项。

    Create VM from the marketplace

  5. 为您的 VM 选择 Ubuntu 服务器:

    • 点击 Ubuntu Server 22.04 LTS。

    • 确保在下一个屏幕中选择了 Resource Manager，然后点击 创建

    Ubuntu VM

  6. 自定义虚拟机基础知识

    • 订阅。如果您正在使用“免费试用”，请选择它。否则，选择其他计划。这是将被收费的计费帐户。

    • 资源组。资源组允许您将 Azure 工具/资源保持在同一个可用区域（例如，西欧）。如果您已经有要使用的资源组，请选择该资源组。

    注意

    如果您从未创建过资源组，请点击 创建新资源组

    Create a new resource group

    • 名称。为您的虚拟机使用一个描述性名称（请注意，您不能使用空格或特殊字符）。

    • 区域。选择一个靠近您预期用户所在位置的区域。

    • 可用性选项。选择“无需基础结构冗余”。

    • 映像。确保选择了“Ubuntu Server 22.04 LTS”（来自上一步）。

    • 身份验证类型。将身份验证类型更改为“密码”。

    • 用户名。选择一个容易记住的用户名，这将是您的“root”用户，您稍后会需要它。

    • 密码。输入密码，这将在以后用于管理员访问，因此请确保它容易记住。

      Add password to VM

    • 使用 Azure Active Directory 登录。选择“关闭”（通常是默认设置）

    • 入站端口规则。暂时保留默认值，我们将在后面的网络配置步骤中更新这些值。

  7. 在点击“下一步”之前，我们需要为映像选择 RAM 大小。

    • 为此，我们需要确保有足够的 RAM 来容纳您的用户。例如，如果每个用户需要 2GB RAM，并且您总共有 10 个用户，则机器上至少需要 20GB RAM。最好还有一些超出您认为需要的“缓冲”RAM。

    • 点击 更改大小（见下图）

      Choose vm size

      注意

      有关估算内存、CPU 和磁盘需求的更多信息，请查看 TLJH 文档中的内存部分

    • 选择合适的映像（要查看您所在区域的可用映像和价格，请点击此链接）。

  8. 磁盘（存储）

    • 磁盘选项：选择操作系统磁盘类型，有 SDD 和 HDD 选项。 SSD 持久性磁盘比 HDD 提供更快但更昂贵的磁盘。

    • 数据磁盘。点击“创建并附加新磁盘”。选择适当的类型和大小，然后点击“确定”。

    • 点击“下一步”。

    Create and attach disk Choose a disk size

  9. 网络

    • 虚拟网络。保留默认值。

    • 子网。保留默认值。

    • 公共 IP 地址。保留默认值。这将使您的服务器可以从浏览器访问。

    • 网络安全组。选择“基本”

    • 公共入站端口。选中 HTTP、HTTPS 和 SSH。

    Choose networking ports

  10. 管理

    • 监控

      • 启动诊断。选择“开”。

      • OS 来宾诊断。选择“关”。

      • 诊断存储帐户。保留为默认值。

    • 自动关机

      • 启用自动关机。选择“关”。

    • 备份

      • 备份。选择“关”。

      • 系统分配的托管标识。选择“关”。

    Choose VM Backup

  11. 高级设置

    • 扩展。确保没有列出任何扩展

    • Cloud init。我们将使用此部分将 TLJH 直接安装到我们的虚拟机中。

      复制以下代码片段

      #!/bin/bash
curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
  | sudo python3 - \
    --admin <admin-user-name>

      其中 admin-user-name 是您为虚拟机选择的 root 用户名。

      Install TLJH

      注意

      如果您想了解安装程序到底在做什么，请参阅 安装程序做什么？。自定义安装程序 文档介绍了可以传递给安装程序的其他选项。

  12. 检查摘要并确认创建您的虚拟机。

  13. 检查您的虚拟机是否创建成功。

    • 等待虚拟机创建。这可能需要大约 5-10 分钟。

    • 完成后，您应该会看到与下面类似的屏幕

    Deployed VM

  14. 请注意，Littlest JupyterHub 应该在您的新服务器上后台安装。此安装大约需要 5-10 分钟才能完成。

  15. 点击 前往资源按钮

    Go to VM

  16. 通过复制您的虚拟机的 公共 IP 地址，并尝试使用浏览器访问它，来检查安装是否完成。

    Public IP address

    请注意，在安装完成之前，访问 JupyterHub 将失败，请耐心等待。

  17. 安装完成后，它应该会给您一个JupyterHub登录页面。

    JupyterHub log-in page

  18. 使用您在步骤6中使用的 管理员用户名 和密码登录。使用一个强密码并将其记在某个地方，因为这将是管理员用户账户从现在开始的密码。

  19. 恭喜，您有一个正在运行的 JupyterHub！ 🎉

步骤2：添加更多用户#

JupyterHub的大部分管理和配置可以直接从Web UI完成。让我们添加一些可以登录的用户！

  1. 在文件菜单中选择 Hub 控制面板 条目。

    Hub Control panel entry in lab File menu

  2. 在控制面板中，打开左上角的 Admin 链接。

    Admin button in control panel, top left

    这将打开JupyterHub管理页面，您可以在其中添加/删除用户、启动/停止用户的服务器以及查看谁在线。

  3. 点击 添加用户 按钮。

    Add Users button in the admin page

    一个 添加用户 对话框打开。

  4. 在对话框中键入您想添加到此JupyterHub的用户名称，每行一个。

    Adding users with add users dialog

    如果您想将管理员权限也授予所有这些用户，可以勾选 管理员 复选框。

  5. 点击对话框中的 添加用户 按钮。您的用户现在已添加到JupyterHub！当他们第一次登录时，他们可以设置密码——并使用该密码将来再次登录。

恭喜，您现在有一个多用户JupyterHub，您可以随意添加用户！

步骤3：为所有用户安装conda / pip软件包#

用户环境 是JupyterHub中所有用户共享的conda环境。安装在此环境中的库可立即供所有用户使用。管理员用户可以使用 sudo -E 在此环境中安装软件包。

  1. 以管理员用户身份登录并在Jupyter Notebook中打开一个终端。

    New Terminal button under New menu

  2. 从 conda-forge 安装 gdal。

    sudo -E conda install -c conda-forge gdal

    sudo -E 非常重要！

  3. 使用 pip 安装 there

    sudo -E pip install there

软件包 gdal 和 there 现在可供JupyterHub中的所有用户使用。如果用户已经运行着Python笔记本，他们必须重新启动笔记本的内核才能使新库可用。

有关更多信息，请参阅 安装conda、pip或apt软件包。

本页内容
在 GitHub 上编辑
显示源代码