• 使用 Django

    使用 Django

    本小节内容适合 Python 开发人员阅读。

    我们现在将使用 Docker Compose 配置并运行一个 Django/PostgreSQL 应用。

    在一切工作开始前，需要先编辑好三个必要的文件。

    第一步，因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面，那么我们可以通过编辑 Dockerfile 文件来指定 Docker 容器要安装内容。内容如下：

    1. FROM python:3
    2. ENV PYTHONUNBUFFERED 1
    3. RUN mkdir /code
    4. WORKDIR /code
    5. COPY requirements.txt /code/
    6. RUN pip install -r requirements.txt
    7. COPY . /code/

    以上内容指定应用将使用安装了 Python 以及必要依赖包的镜像。更多关于如何编写 Dockerfile 文件的信息可以查看 Dockerfile 使用。

    第二步，在 requirements.txt 文件里面写明需要安装的具体依赖包名。

    1. Django>=2.0,<3.0
    2. psycopg2>=2.7,<3.0

    第三步，docker-compose.yml 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷，以及服务开放的端口。

    1. version: "3"
    2. services:
    4.   db:
    5.     image: postgres
    7.   web:
    8.     build: .
    9.     command: python manage.py runserver 0.0.0.0:8000
    10.     volumes:
    11.       - .:/code
    12.     ports:
    13.       - "8000:8000"
    14.     links:
    15.       - db

    查看 docker-compose.yml 章节 了解更多详细的工作机制。

    现在我们就可以使用 docker-compose run 命令启动一个 Django 应用了。

    1. $ docker-compose run web django-admin startproject django_example .

    由于 web 服务所使用的镜像并不存在，所以 Compose 会首先使用 Dockerfile 为 web 服务构建一个镜像，接着使用这个镜像在容器里运行 django-admin startproject django_example 指令。

    这将在当前目录生成一个 Django 应用。

    1. $ ls
    2. Dockerfile       docker-compose.yml          django_example       manage.py       requirements.txt

    如果你的系统是 Linux,记得更改文件权限。

    1. $ sudo chown -R $USER:$USER .

    首先，我们要为应用设置好数据库的连接信息。用以下内容替换 django_example/settings.py 文件中 DATABASES = ... 定义的节点内容。

    1. DATABASES = {
    2.     'default': {
    3.         'ENGINE': 'django.db.backends.postgresql',
    4.         'NAME': 'postgres',
    5.         'USER': 'postgres',
    6.         'HOST': 'db',
    7.         'PORT': 5432,
    8.     }
    9. }

    这些信息是在 postgres 镜像固定设置好的。然后，运行 docker-compose up ：

    1. $ docker-compose up
    3. django_db_1 is up-to-date
    4. Creating django_web_1 ...
    5. Creating django_web_1 ... done
    6. Attaching to django_db_1, django_web_1
    7. db_1   | The files belonging to this database system will be owned by user "postgres".
    8. db_1   | This user must also own the server process.
    9. db_1   |
    10. db_1   | The database cluster will be initialized with locale "en_US.utf8".
    11. db_1   | The default database encoding has accordingly been set to "UTF8".
    12. db_1   | The default text search configuration will be set to "english".
    14. web_1  | Performing system checks...
    15. web_1  |
    16. web_1  | System check identified no issues (0 silenced).
    17. web_1  |
    18. web_1  | November 23, 2017 - 06:21:19
    19. web_1  | Django version 1.11.7, using settings 'django_example.settings'
    20. web_1  | Starting development server at http://0.0.0.0:8000/
    21. web_1  | Quit the server with CONTROL-C.

    这个 Django 应用已经开始在你的 Docker 守护进程里监听着 8000 端口了。打开 127.0.0.1:8000 即可看到 Django 欢迎页面。

    你还可以在 Docker 上运行其它的管理命令，例如对于同步数据库结构这种事，在运行完 docker-compose up 后，在另外一个终端进入文件夹运行以下命令即可：

    1. $ docker-compose run web python manage.py syncdb