如何构建基于docker的开发环境
本文首发于Gevin的博客
最近docker发布了Mac版本和Windows版本，使开发者用起来更方便简单了。Docker本来就是虚拟化技术，基于Docker来构建开发环境顺理成章。Gevin这两天也整理了构建开发环境的思路，在Mac下试验了一下，整体效果还是满意的。今天以django开发环境的构建为例，把构建思路记录下来，和大家分享一下。
如何构建基于docker的开发环境
一、基本思路
1. 创建一个用于开发Django App的目录
mkdir django-example && cd django-example
2. 构建基本开发环境
touch Dockerfile
touch pip.conf requirements.txt
pip.conf文件填入以下内容，以便一会用pip安装Python 模块时使用阿里云镜像加速：
[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host=mirrors.aliyun.com
requirements.txt文件中填入要安装的Python 模块：
django
编写构建开发环境的Dockerfile文件，填入以下内容：
# MAINTAINER Gevin <flyhigher139@gmail.com>
# DOCKER-VERSION 1.12.0
#
# Dockerizing Python: Dockerfile for building python applications
FROM python:2.7.12
MAINTAINER Gevin <flyhigher139@gmail.com>
WORKDIR /usr/src/app
# 使用阿里云的pip镜像
COPY pip.conf /root/.pip/pip.conf
COPY requirements.txt /usr/src/app/requirements.txt
RUN pip install -r /usr/src/app/requirements.txt
EXPOSE 8000
CMD ["bash"]
然后执行下面命令构建镜像：
docker build -t gevin/django-example:0.1 .
构建成功后，执行docker images命令，可以查看到当前构建好的image
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
gevin/django-example 0.1 1855fc3c8062 12 hours ago 698.9 MB
3. 使用构建的image拉起开发环境
执行下面命令，可以以前台形式拉起django-example镜像的一个container：
docker run -it --rm -v $(pwd):/usr/src/app gevin/django-example:0.1
上面命令使用了data volume，把当前目录挂载到container中的工作目录下，这样当前目录下的所有文件都会映射到container的工作目录下，在工作目录下的所有改动，也都会保存到宿主机的当前目录下。
4. 创建django项目
上一步的命令创建了一个安装了django的交互式的container，直接在该container中执行创建django项目的命令即可：
root@7c91f460599f:/usr/src/app# django-admin startproject dj_example
上述命令，在container中基于django的命令创建了一个django项目，由于上一步操作时把宿主机的当前目录挂载到container的工作目录下，因此，刚刚在container中创建的django项目，在宿主机上也能看到。
container:
root@7c91f460599f:/usr/src/app# ls
Dockerfile dj_example pip.conf requirements.txt
宿主机：
django-example ls
Dockerfile dj_example pip.conf requirements.txt
5. 启动django项目
docker run -it --rm -p 8000:8000 -v $(pwd):/usr/src/app gevin/django-example:0.1 python dj_example/manage.py runserver 0.0.0.0:8000
二、Docker-compose与Django环境的结合
每次使用上面章节中介绍的冗长命令来使用django环境非常麻烦，docker-compose可以简化操作。
首先在当前目录下创建docker-compose.yml文件：
➜ django-example touch docker-compose.yml
然后在该文件中写入如下内容：
version: '2'
services:
django-example:
image: gevin/django-example:0.1
volumes:
- ./dj_example:/usr/src/app
ports:
- 8000:8000
command: python manage.py runserver 0.0.0.0:8000
执行下面命令即可拉起django服务：
➜ django-example docker-compose up
# Starting djangoexample_django-example_1
# Attaching to djangoexample_django-example_1
在浏览器中访问http://localhost:8000，即可看到默认的django页面
注：
上面的docker-compose文件，把
./dj_example目录挂载到/usr/src/app，免去执行django命令时，需要对应到下级目录的麻烦，但这样隐藏了原来container中的requirements.txt文件，需要注意。
基于docker-compose 执行django 命令
使用docker-compose 的 run命令，可以在容器内执行相应操作，如：
对django服务的数据库做migrate操作：
docker-compose run django-example python manage.py migrate
创建超级用户:
docker-compose run django-example python manage.py createsuperuser
# Username (leave blank to use 'root'): gevin
# Email address:
# Password:
# Password (again):
# Superuser created successfully.
创建成功后，访问http://localhost:8000/admin，即可使用刚创建的用户(即gevin)，登录数据库管理页面
由于使用了数据卷，保存在sqlite数据库中的数据会一直有效。
三、简化方案
上面方案已经成功构建了django 环境，并应用于开发。上面的方案主要是为了阐述实现思路，在实际操作起来至少有两个麻烦：（1）需要进入容器里面创建django项目；（2）由于django项目是建立在当前目录的子目录下，使用docker-compose 时为了命令简单通用，更换了数据卷。
在实践中，利用docker-compose的run命令，没必要进入容器创建django项目；只要把django项目建立在当前目录下，也没必要更换数据卷了。
因此，可以把上面的方案再理一下，按下面步骤构建开发环境，并应用到开发中去。
Outline:
1. <a name="create-dockefile"></a>创建Dockerfile文件
对Python开发环境而言，最好再创建pip.conf和requirements.txt文件，以便方便安装项目必须的Python依赖，其他语言的开发环境就具体情况而定。
以Python为例，Dockerfile 内容如下：
# MAINTAINER Gevin <flyhigher139@gmail.com>
# DOCKER-VERSION 1.12.0
#
# Dockerizing Python: Dockerfile for building python applications
FROM python:2.7.12
MAINTAINER Gevin <flyhigher139@gmail.com>
WORKDIR /usr/src/app
# 使用阿里云的pip镜像
COPY pip.conf /root/.pip/pip.conf
COPY requirements.txt /usr/src/app/requirements.txt
RUN pip install -r /usr/src/app/requirements.txt
EXPOSE 8000
CMD ["bash"]
2. <a name="build-image"></a> 构建镜像
docker build -t gevin/django-example:0.1 .
3. <a name="create-docker-compose"></a> 创建docker-compose文件
docker-compose文件内容如下：
version: '2'
services:
django-example:
image: gevin/django-example:0.1
volumes:
- .:/usr/src/app
ports:
- 8000:8000
command: python manage.py runserver 0.0.0.0:8000
4. <a name="create-project"></a> 创建项目
docker-compose run django-example django-admin startproject dj_project .
果然需要migrate数据库，创建超级用户等，可以在这里一并创建，也可以在后面的开发中再创建：
docker-compose run django-example python manage.py migrate
docker-compose run django-example python manage.py createsuperuser
5. <a name="run-project"></a> 拉起项目
docker-compose up
四、其他
Gevin认为，虽然基于docker可以构建开发环境，但还是vagrant用起来更舒服，docker更加适合做CI，测试和部署。
实际工作中如何使用docker，就仁者见仁，智者见智了。
