Jupyterhub安装流程

2017/10/26 posted in  其它  

因业务需要,需要搭建JupyterHub的服务,按照官方的文档和其它教程,进行了一下Demo实践,过程中也踩了许多的坑,本文对安装流程进行整理,便于后期使用。
注:本文测试环境为Ubuntu16.04

安装Anaconda

JupyterHub是基于Python的,所以我们需要安装一下Python的相关环境。Anaconda是一个非常成熟的Python包管理工具,因此本文档选用该工具进行基础环境的安装,首先就是安装该工具。

下载安装文件

wget https://repo.continuum.io/archive/Anaconda3-4.4.0-Linux-x86_64.sh

执行安装命令

bash Anaconda3-4.4.0-Linux-x86_64.sh

安装过程中会询问你是否将anaconda的路径加入到环境变量中,默认是no,所以如果在安装的过程中手太快,一键到底了的话,可以通过手动添加的方式进行设置。

将anaconda加入环境变量

//1 打开
vi ~/.bashrc
//2 修改
在bashrc文件的最后添加:export PATH="路径/anaconda3/bin:$PATH"。(vi编辑器中按i进入编辑模式)
//3 保存
添加完按esc退出编辑模式,并按:x(保存并退出)
//4 更新环境变量
source ~/.bashrc

检测是否安装成功

检测Anaconda是否安装成功:

conda list

如果提示conda: command not found,请参考是否将Anaconda加入环境变量,并且更新生效。

Jupyterhub安装

只需要一条命令:

conda install -c conda-forge jupyterhub

检测安装是否成功

jupyterhub -h
configurable-http-proxy -h

创建配置文件

执行如下命令,可以在当前目录下生成默认配置文件:

jupyterhub --generate-config

一个简单的配置文件demo:

c.JupyterHub.ip = '你的IP地址'
c.JupyterHub.port = 所使用的端口
c.PAMAuthenticator.encoding = 'utf8'

//白名单
c.Authenticator.whitelist = {'jupyter1', 'jupyter2', 'jupyter3'} 

//管理用户
c.LocalAuthenticator.create_system_users = True
c.Authenticator.admin_users = {'jupyter1'}

c.Spawner.cmd=['jupyterhub-singleuser']
c.JupyterHub.statsd_prefix = 'jupyterhub'

注意:这里在白名单和管理用户都提到的访问的用户,这里的用户实际上就是我们Ubuntu服务器的用户,如果我们配置的用户没在系统当中,则会自动创建,创建后需要我们手工的指定用户密码,用于用户后期登录jupyterhub。

开启服务

jupyterhub --config=/etc/jupyterhub/jupyterhub.py --no-ssl

参数说明:

  • --config:读取配置文件的地址,默认会检测当前目录
  • --no-ssl:在不使用ssl的情况下启动,因为目前实验较为简单,ssl相关暂未配置,这个坑后面补。

至此,我们就可以通过浏览器对jupyterhub进行访问了。进一步的配置和使用,将会逐步更新。