Ubuntu下 部署TheLittlestJupyterHub

Ubuntu部署TheLittlestJupyterHub

在阿里云ubuntu服务器上安装TLJH（The Littlest Jupyter Hub），实现团队多人公用的在线Jupyter Notebook编程环境。

安装准备

购买阿里云ECS服务器，如果不是长期持续使用的话，建议购买按量付费版本，随用随开，用完关机，缺点是IP地址不固定。

我购买了2cpu8G内存的云服务器，每小时不到6毛，需要先充值100元才能购买按量付费产品。

由于TLJH目前只支持Ubuntu18.04以上版本，不支持其他操作系统，所以必须购买服务器时候也不要选其他的。

购买成功侯从控制台进入服务器页面，点击【远程连接】进入命令行模式。

执行下面的代码，检查是否缺少必须的软件工具。

sudo apt install python3 python3-dev git curl

提示缺少git，使用下面的命令安装git。

sudo apt update

sudo apt install git

安装成功侯用下面命令检查git是否安装成功,正常应该输出版本号。

git --version

推荐使用谷歌浏览器，因为在Edge浏览器中可能出问题不能输入yes确认。

安装TLJH

使用下面的命令安装TLJH，最后一个admin是管理员名称，后续要用。

curl -L https://tljh.jupyter.org/bootstrap.py | sudo -E python3 - --admin admin

这个安装可能需要5~10分钟，耐心等最后出现Done就表示成功了。

增加用户

从浏览器地址中打开云服务器的IP地址，就会出现登录窗口，如下图所示。

正在上传…重新上传取消

image.png

UserName输入上面设置的admin，密码Password任意输入，但一定要记好，登陆后即可进入Notebook的文件管理页面。

与普通的Jupyter Notebook不同，这里的右上角有两个按钮，退出Logout和Control Panel控制面板，如下图。

正在上传…重新上传取消

image.png

点Control Panel进入管理页面，如下图所示，点击进入Admin管理。

正在上传…重新上传取消

image.png

在这里可以看到所有用户的列表，点击AddUsers添加用户，每行一个用户名，可以一次添加多个用户,勾选admin则为管理员用户。

正在上传…重新上传取消

image.png

用户界面设置

可以切换到另外的浏览器，使用新账号测试登录Notebook和编写代码，同样是初次登录直接设置密码即可。

默认打开的是../tree地址,可以手工改为/lab或/nteract切换不同的界面风格。

如果要强制修改界面风格，可以用管理员登录，右上角New新建终端terminal，然后使用下面的命令更改设置。

sudo tljh-config set user_environment.default_app jupyterlab

或

sudo tljh-config set user_environment.default_app nteract

然后用下面的命令刷新使其生效。

sudo tljh-config reload hub

下图展示的是jupyterlab页面效果。

正在上传…重新上传取消

image.png

密码设置

用户忘记密码侯怎样找回密码？暂时还没有找回密码功能。

可行的解决方法是让管理员在Admin页面删除用户delete user，然后再Add Users添加完全同名的账户，然后再用这个用户名登录的话就又可以重新设置密码了，并且他之前编写的文件也不会丢失。如下图所示。

正在上传…重新上传取消

image.png

登录后修改密码的页面是http:.../hub/auth/change-password。

管理员密码丢失怎么办？可以创建新的管理员，然后用上面的方法重置。

在阿里云控制台远程连接服务器，然后执行下面的命令，新增管理员（root），然后可以在页面上用root账户并设置新密码登录。

sudo tljh-config add-item users.admin root

sudo tljh-config reload

安装库和插件

管理员直接New新建Terminal终端就可以执行命令，比如安装Numpy可以使用下面的命令。

sudo -E conda install numpy

这里的-E是针对所有用户安装，安装后即时生效。

也可以使用conda-forge或者pip等命令，比如下面安装Pandas或Matplotlib。

sudo -E conda install -c conda-forge pandas

或者

conda install -c conda-forge matplotlib

如果命令不能直接Ctrl+V粘贴的话可以右键粘贴。

普通用户也可以在自己的Notebook中执行下面的命令查看已经安装的工具包列表。

!conda list

使用下面的命令安装Notebook扩展插件，可以实现自动提示和自动格式化等功能。

sudo -E conda install -c conda-forge jupyter_contrib_nbextensions

注意，这个扩展功能只对新用户有效。解决办法是把旧用户删掉再重新创建，所以，强烈推荐及早安装。

安装成功后Logout退出再重新登录，就可以在Notebook的文件管理页面看到Nbextension按钮，如下所示。

正在上传…重新上传取消

image.png

点击进入，去掉顶部disable...的勾选，然后新增选中下面的Code pretty（代码格式化）和Hinterland（代码自动提示）。

在jupyter lab界面模式下不支持nbextensions扩展。

共享文件

管理员如何把一个文件共享给其他用户？

所有用户文件都存储在/home/下面并且以jupyter开头，比如jupyter-admin文件夹存储了管理员创建的文件。

另外，所有新用户都会复制/etc/skel的文件结构。

所以，如果我们需要把一个文件或文件夹发送给所有用户，那么只要把这个文件或文件夹的会计方式放入/etc/skel即可。当然，也可以把快捷方式或者文件直接复制到这个用户的文件jupyter-xxx目录中，让他一打开就可以看到。

使用下面的命令将一个文件夹的快捷方式复制到新用户初始文件结构中。

sudo mkdir -p /srv/scratch 创建一个文件夹。

sudo chown root:jupyterhub-users /srv/scratch 修改它的权限可以被用户访问。

sudo chmod 777 /srv/scratch 其他用户也可以在这里创建文件夹和文件。

sudo chmod g+s /srv/scratch 新文件的权限保持默认，即创建者可更改，其他用户只读。

sudo ln -s /srv/scratch /etc/skel/scratch 将这个文件夹的快捷方式放到新用户初始结构中。

上面设置完成后，新建用户登录后就会看到一个scratch文件，可以在里面看到其他人创建的文件，只读；也可以在这里创建自己的文件让他人方便访问。

对于已经存在的用户，建议使用WinSCP或者Transmit工具登录服务器，将/etc/skel/scratch中的快捷方式复制到/home/文件夹下面的各个用户文件夹中。

自定义页面

在终端可以用下面的命令查找到Notebook实际展示的页面地址。

find / -iname "page.html"

应该类似是/opt/tljh/user/pkgs/notebook-6.2.0-py37h89c1867_0/lib/python3.7/site-packages/notebook/templates这样的目录。

可以使用网页开发工具进行有限的修改，比如更换Logo、样式等,例如下图的效果。

正在上传…重新上传取消

image.png

如需重启，可以使用下面的命令。

tljh-config reload proxy

tljh-config reload hub

更多内容

TLJH支持更多功能，比如通过设置就可以直接支持GitHub登录、让用户自主注册。

更多内容请参照官方网站 https://jupyterhub.readthedocs.io/en/stable/index.html

作者：zhyuzh3d
链接：https://www.jianshu.com/p/4b36079e5532
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。