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 jupyterlabsudo 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


END

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容