自定义安装程序#

安装程序可以使用命令行参数进行自定义。默认安装程序以以下方式执行

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
 | sudo python3 - \
   <parameters>

此页面记录了您可以作为命令行参数传递给安装程序的各种选项。

提供一个临时的“TLJH 正在构建”页面#

--show-progress-page 在 TLJH 构建时提供一个临时的“TLJH 正在构建”进度页面。

Temporary progress page while TLJH is building

该页面将在您的浏览器中 http://<tljh-public-ip>/index.html 可访问。当 TLJH 安装完成后，进度页面将停止，您将能够像往常一样在 http://<tljh-public-ip> 访问 TLJH。
从进度页面，您还可以通过单击“日志”按钮或直接在浏览器中访问 http://<tljh-public-ip>/logs 来访问安装日志。要更新日志，请刷新页面。

注意

http://<tljh-public-ip>/index.html 页面每 30 秒自动刷新一次。当 JupyterHub 启动时，将显示 JupyterHub 404 HTTP 错误消息（Jupyter 有很多卫星，但这不是其中之一……），而不是进度页面。这意味着 JupyterHub 已成功启动，您可以通过单击“控制面板”按钮或直接访问 http://<tljh-public-ip>/ 来访问它。

例如，要启用进度页面并添加第一个管理员用户，您将运行

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
| sudo python3 - \
 --admin admin --show-progress-page

添加管理员用户#

--admin <username>:<password> 将用户 <username> 添加到 JupyterHub 作为管理员用户，并将密码设置为 <password>。虽然不建议这样做，但您可以在此时只设置管理员用户名，并在安装后设置管理员密码。

此外，--admin 标志可以重复多次。例如，要将 admin-user1 和 admin-user2 作为管理员添加到安装过程中，根据您是否希望在安装过程中设置其密码，您将

使用 password-user1 设置 admin-user1 的密码，使用 password-user2 设置 admin-user2 的密码，使用

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
 | sudo python3 - \
   --admin admin-user1:password-user1 --admin admin-user2:password-user2

将 admin-user1 和 admin-user2 设置为管理员，此时没有任何密码，使用

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
 | sudo python3 - \
   --admin admin-user1 --admin admin-user2

使用 password-user1 设置 admin-user1 的密码，此时 admin-user2 没有密码，使用

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
 | sudo python3 - \
   --admin admin-user1:password-user1 --admin admin-user2

在用户环境中安装 Python 包#

--user-requirements-txt-url <url-to-requirements.txt> 在安装时将位于给定 URL 的 requirements.txt 中指定的包安装到用户环境中。当您想要一次性设置具有特定用户环境的集线器时，这非常有用。

例如，要在新的 Hub 中安装运行 UC Berkeley 的 data8 课程所需的最新依赖项，您需要运行以下命令：

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
 | sudo python3 - \
   --user-requirements-txt-url https://raw.githubusercontent.com/data-8/materials-sp18/HEAD/requirements.txt

URL **必须** 指向有效的 requirements.txt 文件。如果存在任何错误，安装将失败。

注意

指向 GitHub 上的文件时，请确保使用“原始”版本。它应该指向 raw.githubusercontent.com，而不是 github.com。

安装 TLJH 插件#

Littlest JupyterHub 可以安装额外的插件，提供更多功能。它们最常用于安装特定的堆栈 - 例如用于地球科学研究的 PANGEO 堆栈，特定课程的堆栈等。您可以在 TLJH 插件中找到有关编写插件和现有插件列表的更多信息。

--plugin <plugin-to-install> 安装并激活插件。您可以根据需要多次传递它。由于插件以 Python 包的形式分发，<plugin-to-install> 可以是任何可以传递给 pip install 的内容 - plugin-name-on-pypi==<version> 和 git+https://github.com/user/repo@tag 是最常用的。强烈建议指定版本或标签。

例如，要在新的 TLJH 安装中安装 PANGEO 插件版本 0.1（如果版本 0.1 存在），您需要使用以下命令：

curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py \
 | sudo python3 - \
   --plugin git+https://github.com/yuvipanda/[email protected]

可以使用以下命令一次安装多个插件：--plugin <first-plugin-to-install> <second-plugin-to-install>。

注意

插件非常强大，可以执行大量任意操作。只安装您信任的插件。