本文首发于Gevin的博客

原文链接：如何构建基于docker的开发环境

未经 Gevin 授权，禁止转载

【概要】想了解整个构建思路的同学可以将本文通读一遍，如果只想了解如何构建，直接调到第三部分简化方案即可

最近docker发布了Mac版本和Windows版本，使开发者用起来更方便简单了。Docker本来就是虚拟化技术，基于Docker来构建开发环境顺理成章。Gevin这两天也整理了构建开发环境的思路，在Mac下试验了一下，整体效果还是满意的。今天以django开发环境的构建为例，把构建思路记录下来，和大家分享一下。

一、基本思路

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项目建立在当前目录下，也没必要更换数据卷了。

因此，可以把上面的方案再理一下，按下面步骤构建开发环境，并应用到开发中去。

1. 创建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. 构建镜像

docker build -t gevin/django-example:0.1 .

3. 创建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. 创建项目

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. 拉起项目

docker-compose up

四、其他

Gevin认为，虽然基于docker可以构建开发环境，但还是vagrant用起来更舒服，docker更加适合做CI，测试和部署。

实际工作中如何使用docker，就仁者见仁，智者见智了。

如何构建基于 docker 的开发环境