Docker-compose实战——Django+PostgreSQL

今天我们来用docker-compose 快速安装一个Django+PostgreSQL的开发环境。

Compose简介

Compose 定位是“defining and running complex applications with Docker”，前身是 Fig，兼容 Fig 的模板文件。

Dockerfile 可以让用户管理一个单独的应用容器；而 Compose 则允许用户在一个模板（YAML 格式）中定义一组相关联的应用容器（被称为一个 project，即项目），例如一个 Web 服务容器再加上后端的数据库服务容器等。

该项目由 Python 编写，实际上调用了 Docker 提供的 API 来实现。

安装docker-compose请戳这里，安装好后就让我们一起开始吧！

一、定义项目组件

1.1 创建一个空的项目目录

[root@localhost sparks]# mkdir django_test

1.2 在你的项目目录下创建一个名为Dockerfile文件

Docker 可以通过 Dockerfile 的内容来自动构建镜像。Dockerfile 是一个包含创建镜像所有命令的文本文件，通过docker build命令可以根据 Dockerfile 的内容构建镜像，在介绍如何构建之前先介绍下 Dockerfile 的基本语法结构。

想要了解更多官方文档

1.3 添加如下的内容到Dockerfile

 FROM python:3

 ENV PYTHONUNBUFFERED 1

 RUN mkdir /code

 WORKDIR /code

 ADD requirements.txt /code/

 RUN pip install -r requirements.txt

 ADD . /code/

　　这个dockerfile文件开始于python3基础镜像，创建并移动工作目录至code目录，将requirements.txt添加到code目录中，并用pip命令安装该文件中的依赖包。

1.4 在你的项目目录下创建并添加如下内容至requirements.txt

 Django>=1.8,<2.0

 psycopg2

1.5 在你的项目目录下创建并添加如下内容至docker-compose.yml

version: '3'

services:

  db:

    image: postgres

  web:

    build: .

    command: python3 manage.py runserver 0.0.0.0:8000

    volumes:

      - .:/code

    ports:

      - "8000:8000"

    depends_on:

      - db

　　这个文件定义了两个服务，数据库（db）服务和web服务，想要了解更多请点击这里

二、创建Django项目

在这一步，用之前步骤创建的文件制作镜像并用这个镜像来创建Django项目

2.1 转至项目根目录，运行如下命令来创建Django项目

sudo docker-compose run web django-admin.py startproject composeexample .

　　这里django-admin.py startproject composeexample需要使用web服务的镜像和配置，但是web镜像目前并不存在，所以compose自动在当前目录下寻找和创建该服务，

　　具体可以参见docker-compose.yml中 build: . 这一行。

　　一旦web服务镜像被创建，就在该容器中运行django-admin.py startproject 来创建Django项目

2.2 在上面的命令执行完后，查看你的项目目录文件

 $ 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

　　如果你是在linux上运行docker，manage.py文件属于root创建，因为在容器内运行都是用root用户，可以通过如下命令改变权限

sudo chown -R $USER:$USER .

三、连接数据库

在这一部分，我们将创建数据库并连接Django

3.1 在你的项目目录下，编辑composeexample/settings.py文件

3.2 将文件中DATABASES = ...替换为如下内容

DATABASES = {

    'default': {

        'ENGINE': 'django.db.backends.postgresql',

        'NAME': 'postgres',

        'USER': 'postgres',

        'HOST': 'db',

        'PORT': 5432,

    }

}

3.3 运行命令在你的项目根目录下

$ docker-compose up

djangosample_db_1 is up-to-date

Creating djangosample_web_1 ...

Creating djangosample_web_1 ... done

Attaching to djangosample_db_1, djangosample_web_1

db_1   | The files belonging to this database system will be owned by user "postgres".

db_1   | This user must also own the server process.

db_1   |

db_1   | The database cluster will be initialized with locale "en_US.utf8".

db_1   | The default database encoding has accordingly been set to "UTF8".

db_1   | The default text search configuration will be set to "english".

. . .

web_1  | May 30, 2017 - 21:44:49

web_1  | Django version 1.11.1, using settings 'composeexample.settings'

web_1  | Starting development server at http://0.0.0.0:8000/

web_1  | Quit the server with CONTROL-C.

　　到了这里，你的Django应用已经运行在docker主机的8000端口上啦，使用浏览器输入http://localhost:8000就可以看到Django的欢迎界面啦

3.4 查看正在运行的容器

　　在另一个终端上，你可以通过 docker ps 命令查看正在运行的容器

$ docker ps

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                    NAMES

def85eff5f51        django_web          "python3 manage.py..."   10 minutes ago      Up 9 minutes        0.0.0.0:8000->8000/tcp   django_web_1

678ce61c79cc        postgres            "docker-entrypoint..."   20 minutes ago      Up 9 minutes        5432/tcp                 django_db_1

　　一个web容器，一个postgre容器都在后台运行中，至此我们已经大功告成啦！