Docker部署IPython

本文的部署环境是Ubuntu 14.04

Docker

Docker 详细概念可以去search，简单来说就是把应用打包到一个容器里的轻量级系统虚拟化服务

IPython Notebook

IPython Notebook 既是一个交互计算平台，又是一个记录计算过程的「笔记本」。它由服务端和客户端两部分组成，其中服务端负责代码的解释与计算，而客户端负责与用户进行交互。服务端可以运行在本机也可以运行在远程服务器，包含负责运算的 IPython kernel (与 QT Console 的 kernel 相同) 以及一个 HTTP/S 服务器 (Tornado)。而客户端则是一个指向服务端地址的浏览器页面，负责接受用户的输入并负责渲染输出。

本文主要记录使用Docker 在服务器部署IPython Note 应用的过程。比传统的部署方案果然简单轻松不少。

知识点

Docker 的基本概念
部署IPython 容器
使用Nginx 容器反向代理IPython

Docker 的基本概念

下文的操作主要涉及Docker的一下几个知识点：

Docker 的镜像(image)、容器(container)、仓库(registerie)
Docker 的安装
Docker 的基础用法
Docker的端口映射
Docker 数据卷
链接容器

详细的信息可以自行搜索

部署IPython

下载IPython 的镜像

官方Docker镜像地址，里面包含5个镜像:

notebook
ipython
scipyserver
scipystack
nbvierer

简单说一下这几个镜像的区别 ipython 是以上几个镜像的共同的根镜像。notebook 提供了一个web的前端。scipystack在ipython的基础上安装了许多科学计算的包(cython,h5py,matplotlib,numpy,pandas,patsy,scikit-learn,scipy,seaborn,sympy,yt)，而scipyserver则在scipystack的基础上提供了web的前端。nbviewer则是nbviewer.ipython.org的实现

更多详细信息请到GitHub上的docker-notebook 查看

选择scipystack镜像最省事，但是需要下载的东西也越多。下文选择的也是scipystack

$ sudo docker pull ipython/scipyserver

运行IPython 容器

sudo docker run -d --name IPythonApp -p 8888:8888 -e "PASSWORD=your password" -e "USE_HTTP=1" -v /home/zhiyue/repos/ipython-notebook:/notebooks ipython/scipyserver

解析一下参数-d 是以后台的方式运行，--name 是容器的别名，-p 是端口映射，-e 是设置环境变量，这里的环境变量PASSWORD设置成你自己的密码就可以了，USE_HTTP=1 意思是使用http，-v 是设置数据卷，把宿主机的目录挂载到容器里，即使容器被删除，数据也可以保留下来

Nginx 反向代理 IPython

有两种方式，一种是使用官方的Nginx，另一种是使用jwilder / nginx-proxy，后一种方法更加简单和方便

方式1：nginx

使用Nginx的官方镜像nginx
Nginx 配置文件

ipython-server.conf



 map $http_upgrade $connection_upgrade {

        default upgrade;

        ''      close;

 }

server{

        listen 80;

        server_name note.everforget.com;

        location / {

                proxy_pass http://ipython:8888;

                proxy_http_version 1.1;

                proxy_set_header Upgrade $http_upgrade;

                proxy_set_header Connection "upgrade";

	            proxy_set_header X-Real-IP $remote_addr;

	            proxy_set_header Host $host;

	            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        }

}

这里面要注意一点是，ipython要使用websock因此要配置websocket，之前在这个问题查了好久。

proxy_pass http://ipython:8888; ipython和后面容器连接时的别名有关。

运行Nginx容器

$ sudo docker run -d -p 80:80 --name nginx --link IPythonApp:ipython  -v `pwd`/config:/etc/nginx/conf.d  -v `pwd`/logs:/var/log/nginx nginx

方式2：nginx-proxy

jwilder / nginx-proxy
运行nginx-proxy 容器

docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro jwilder/nginx-proxy

运行ipython 容器

sudo docker run -d -e "VIRTUAL_HOST=ipython.everforget.com" --name IPython -p 8888:8888 -e "PASSWORD=xxxxxx" -e "USE_HTTP=1" -v /home/zhiyue/repos/ipython-notebook:/notebooks ipython/scipyserver

最后放一张图：

这样就可以随时通过web来使用python了。

参考

更新日志：

2015-6-8 添加配图
2015-6-6 第一次撰写