在 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 地址。保留默认值。这将使您的服务器可以从浏览器访问。

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

    • 公共入站端口。选中 HTTPHTTPSSSH

    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
    

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

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