在 OVH 上安装#

目标#

在本教程结束时,您应该在 OVH 上运行一个 JupyterHub,其中包含一些管理员用户和一个包含您想要安装的软件包的用户环境。

先决条件#

  1. 一个 OVH 帐户。

步骤 1:安装最小的 JupyterHub#

让我们创建可以在其上运行 JupyterHub 的服务器。

  1. 登录到 OVH 控制面板

  2. 单击导航栏中的 **公共云** 按钮。

    Public Cloud entry in the navigation bar
  3. 如果您还没有 OVH 堆栈,您可以通过单击以下按钮创建一个

    Button to create an OVH stack
  4. 为项目选择一个名称

    Select a name for the project
  5. 如果您还没有付款方式,请选择一个并单击“创建我的项目”

    Select a payment method
  6. 使用 **公共云界面**,单击 **创建实例**

    Create a new instance
  7. 为实例 **选择一个模型**。一个好的开始是 **共享资源** 下的 **S1-4** 模型,它附带 4GB 内存、1 个 vCore 和 20GB SSD。

  8. 选择一个区域.

  9. 选择 **Ubuntu 22.04** 作为镜像

    Select Ubuntu 22.04 as the image
  10. OVH 要求设置 SSH 密钥才能连接到实例。您可以按照 这些说明 创建一个新的 SSH。请务必复制 ~/.ssh/id_rsa.pub 文件的内容,该文件对应于 SSH 密钥的 **公钥部分**。

  11. 选择 **配置您的实例**,并为实例选择一个名称。在 **安装后脚本** 下,复制下面的文本并将其粘贴到文本框中。将 <admin-user-name> 替换为此 JupyterHub 的第一个 **管理员用户** 的名称。此管理员用户可以在 JupyterHub 设置后登录,并根据需要对其进行配置。**请务必添加您的用户名!**

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

    注意

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

    Add post-installation script
  12. 选择计费周期:每月或每小时。

  13. 单击 **创建实例** 按钮!您将被带到另一个屏幕,您可以在其中看到服务器创建的进度。

    Select suitable hostname for your server
  14. 几秒钟后,您的服务器将被创建,您将看到用于访问它的 **公共 IP**。

    Server finished creating, public IP available
  15. 最小的 JupyterHub 现在正在您的新服务器后台安装。此安装大约需要 5-10 分钟才能完成。

  16. 通过复制服务器的 **公共 IP** 并尝试使用浏览器访问它来检查安装是否完成。在安装完成之前,这将失败,所以请耐心等待。

  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 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 包#

用户环境是一个 conda 环境,由 JupyterHub 中的所有用户共享。在此环境中安装的库将立即对所有用户可用。管理员用户可以使用 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
    

现在,所有 JupyterHub 用户都可以使用 gdalthere 包。如果用户已经运行了 Python 笔记本,他们需要重新启动笔记本的内核才能使用新库。

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