本文主要是作为官方Quickstart: Compose and Django的导读,如果你当下还没了解过Docker,但想知道如何利用Docker来管理自己本地的开发环境,并统一开发和测试的环境,那你可以参考以下内容。
需求:
使用Docker搭建Django开发环境,即本地只需要有python代码即可。
预备知识:
Docker作为容器,和传统虚拟机是不一样的,如下图所示,它是基于Docker Engine的一个容器,且在这一层次上是相互隔离的,而传统虚拟化则是要虚拟化整个系统,因此理论上Docker容器可以更有效的利用资源,你可以很容易在本地环境搭建多服务的复杂系统环境。本篇以一台web服务器及一台数据库服务器为例,当然也可以搭建更复杂的,比如加入一台redis机器等等。
更多Docker介绍可以看开源版本的《Docker 从入门到实践》, 内容可能已经有点老,但是基本上还是作为参考。
更多,等新,等详细的解释看官方介绍What is a Cantainer
容器是基于一个镜像(image)建立的,比如本地有一个ubuntu的镜像,我们可以基于该镜像去新建多个容器实例,而它们之间可以做到互联,与本地机器的文件共享等。从而可以达到前文提到的,快速在本地搭建一个多服务器的复杂环境。
用户可以很方便地对容器进行启动、停止、删除等操作。一个基本的容器启动例子如下,它在启动一个容器后,打印一条Hello world
sudo docker run ubuntu:14.04 /bin/echo 'Hello world'
镜像被仓库统一管理,Docker官方有自己的仓库Docker Hub,国内可以使用阿里云的镜像仓库,我用的是阿里的,需要在阿里后台生成自己的私有地址,然后在Docker中配置。从镜像仓库获取镜像到本地后,就可以基于镜像新建容器使用了。
当然也可以搭建自己的私有仓库,在团队或公司内部使用。
镜像定制,当仓库中的官方镜像无法满足需求时,就需要自定义镜像,所有的自定义镜像都可以上传到仓库中,共享给其他用户。Docker镜像的定制主要通过Dockerfile指令文件实现,在指令文件中实现自己的需求即可,比如使用COPY命令将本机文件复制到容器中等。
Docker Compose,安装最新的Docker,默认已经包含这个工具,主要用于定义及启动多容器的场景(当前例子基于此工具),它需要一个docker-compose.yml文件来配置需要启动的容器及相关配置,然后就可以用下述语句新建及启动配置文件中的多容器
docker-compose up
docker-compose.yml实例:
version: '2'
services:
db: //数据库容器
image: postgres
web: //web服务器容器
build: .
command: python manage.py runserver 0.0.0.0:8000
volumes: //挂载本地机器文件夹
- .:/code
ports:
- "8000:8000"
depends_on:
- db
搭建Django开发环境:
Step 1: Define the project components
这个步骤主要是定义project的内容,这里的“project”指我们要搭建的基于Docker的Django开发环境,具体会包含Docker容器配置文件Dockerfile,Django环境需要的requirements.txt配置,docker-compose.yml配置
Dockerfile 实例:
FROM python:2.7 注:基础镜像
ENV PYTHONUNBUFFERED 1
RUN mkdir /code
WORKDIR /code 注:切换工作上下文
ADD requirements.txt /code/
RUN pip install -r requirements.txt 注:安装python依赖
ADD . /code/
Step 2:Create a Django project
官方例子是用docker-compose命令运行web服务器(docker-compose.yml配置了web和db两个容器),然后调用django-admn新建Django项目,由于挂在了本地目录到容器内部,因此当前命令生成的django项目文件能在本地机器目录直接访问。
docker-compose run web django-admin.py startproject composeexample .
注意,此时的web容器已经包含django环境了,因为在web容器的Dockerfile文件配置了python环境搭建的命令,如下所示:
RUN pip install -r requirements.txt
对于实际工作项目,我们只需在对应的本地机器目录(即运行docker-compose命令的上下文目录)准备好项目代码即可
$ ls -l
drwxr-xr-x 2 root root composeexample 注:该项目文件可以是实际工作代码文件夹
-rw-rw-r-- 1 user user docker-compose.yml
-rw-rw-r-- 1 user user Dockerfile
-rwxr-xr-x 1 root root manage.py
-rw-rw-r-- 1 user user requirements.txt
Step 3:Connect the database
这里主要就是设置Django框架下的settings.py文件,注意HOST名字使用
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'postgres',
'USER': 'postgres',
'HOST': 'db', //另一个容器的名字
'PORT': 5432,
}
}
最后就是再次使用docker-compose新建并启动多个容器
$ docker-compose up