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地址,就会出现登录窗口,如下图所示。
UserName输入上面设置的admin,密码Password任意输入,但一定要记好,登陆后即可进入Notebook的文件管理页面。
与普通的Jupyter Notebook不同,这里的右上角有两个按钮,退出Logout和Control Panel控制面板,如下图。
点Control Panel进入管理页面,如下图所示,点击进入Admin管理。
在这里可以看到所有用户的列表,点击AddUsers添加用户,每行一个用户名,可以一次添加多个用户,勾选admin则为管理员用户。
用户界面设置
可以切换到另外的浏览器,使用新账号测试登录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页面效果。
密码设置
用户忘记密码侯怎样找回密码?暂时还没有找回密码功能。
可行的解决方法是让管理员在Admin页面删除用户delete user,然后再Add Users添加完全同名的账户,然后再用这个用户名登录的话就又可以重新设置密码了,并且他之前编写的文件也不会丢失。如下图所示。
登录后修改密码的页面是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按钮,如下所示。
点击进入,去掉顶部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、样式等,例如下图的效果。
如需重启,可以使用下面的命令。
tljh-config reload proxy
tljh-config reload hub
更多内容
TLJH支持更多功能,比如通过设置就可以直接支持GitHub登录、让用户自主注册。
更多内容请参照官方网站 https://jupyterhub.readthedocs.io/en/stable/index.html
END