如何構建基於 docker 的開發環境

本文首發於Gevin的博客

原文連接：如何構建基於docker的開發環境

未經 Gevin 受權，禁止轉載

---

【概要】想了解整個構建思路的同窗能夠將本文通讀一遍，若是隻想了解如何構建，直接調到第三部分簡化方案便可

最近docker發佈了Mac版本和Windows版本，使開發者用起來更方便簡單了。Docker原本就是虛擬化技術，基於Docker來構建開發環境瓜熟蒂落。Gevin這兩天也整理了構建開發環境的思路，在Mac下試驗了一下，總體效果仍是滿意的。今天以django開發環境的構建爲例，把構建思路記錄下來，和你們分享一下。

如何構建基於docker的開發環境

1、基本思路

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複製代碼

2、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數據庫中的數據會一直有效。

3、簡化方案

上面方案已經成功構建了django 環境，並應用於開發。上面的方案主要是爲了闡述實現思路，在實際操做起來至少有兩個麻煩：（1）須要進入容器裏面建立django項目；（2）因爲django項目是創建在當前目錄的子目錄下，使用docker-compose 時爲了命令簡單通用，更換了數據卷。

在實踐中，利用docker-compose的run命令，不必進入容器建立django項目；只要把django項目創建在當前目錄下，也不必更換數據捲了。

所以，能夠把上面的方案再理一下，按下面步驟構建開發環境，並應用到開發中去。

Outline:

1. 建立Dockerfile文件
2. 構建鏡像
3. 建立docker-compose文件
4. 建立項目
5. 拉起項目

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複製代碼

4、其餘

Gevin認爲，雖然基於docker能夠構建開發環境，但仍是vagrant用起來更舒服，docker更加適合作CI，測試和部署。

實際工做中如何使用docker，就仁者見仁，智者見智了。