实战 Django · DOCKER

## 使用 Django 本小节内容适合 `Python` 开发人员阅读。我们现在将使用 `Docker Compose` 配置并运行一个 `Django/PostgreSQL` 应用。在一切工作开始前，需要先编辑好三个必要的文件。第一步，因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面，那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下： ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">FROM python:3</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">ENV PYTHONUNBUFFERED 1</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">RUN mkdir /code</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">WORKDIR /code</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">ADD requirements.txt /code/</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">RUN pip install -r requirements.txt</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">ADD . /code/</code></li> </ol> ``` 以上内容指定应用将使用安装了 Python 以及必要依赖包的镜像。更多关于如何编写 `Dockerfile` 文件的信息可以查看 [镜像创建](%24image-create.md#%E5%88%A9%E7%94%A8%20Dockerfile%20%E6%9D%A5%E5%88%9B%E5%BB%BA%E9%95%9C%E5%83%8F) 和 [ Dockerfile 使用](%24dockerfile-README.md)。第二步，在 `requirements.txt` 文件里面写明需要安装的具体依赖包名。 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">Django>=1.8,<2.0</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">psycopg2</code></li> </ol> ``` 第三步，`docker-compose.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷，以及服务开放的端口。 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">version: "3"</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">services:</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"></code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> db:</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> image: postgres</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"></code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> web:</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> build: .</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> command: python3 manage.py runserver 0.0.0.0:8000</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> volumes:</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> - .:/code</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> ports:</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> - "8000:8000"</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> links:</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> - db</code></li> </ol> ``` 查看 [`docker-compose.yml` 章节](%24yml_ref.md) 了解更多详细的工作机制。现在我们就可以使用 `docker-compose run` 命令启动一个 `Django` 应用了。 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">$ docker-compose run web django-admin.py startproject django_example .</code></li></ol> ``` Compose 会先使用 `Dockerfile` 为 web 服务创建一个镜像，接着使用这个镜像在容器里运行 `django-admin.py startproject composeexample` 指令。这将在当前目录生成一个 `Django` 应用。 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">$ ls</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">Dockerfile docker-compose.yml django_example manage.py requirements.txt</code></li> </ol> ``` 如果你的系统是 Linux,记得更改文件权限。 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">sudo chown -R $USER:$USER .</code></li></ol> ``` 首先，我们要为应用设置好数据库的连接信息。用以下内容替换 `django_example/settings.py` 文件中 `DATABASES = ...` 定义的节点内容。 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">DATABASES = {</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> 'default': {</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> 'ENGINE': 'django.db.backends.postgresql',</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> 'NAME': 'postgres',</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> 'USER': 'postgres',</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> 'HOST': 'db',</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"> 'PORT': 5432,</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"> }</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">}</code></li> </ol> ``` 这些信息是在 [postgres](https://store.docker.com/images/postgres/) 镜像固定设置好的。然后，运行 `docker-compose up` ： ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">$ docker-compose up</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9"></code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">django_db_1 is up-to-date</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">Creating django_web_1 ...</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">Creating django_web_1 ... done</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">Attaching to django_db_1, django_web_1</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">db_1 | The files belonging to this database system will be owned by user "postgres".</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">db_1 | This user must also own the server process.</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">db_1 |</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">db_1 | The database cluster will be initialized with locale "en_US.utf8".</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">db_1 | The default database encoding has accordingly been set to "UTF8".</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">db_1 | The default text search configuration will be set to "english".</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9"></code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 | Performing system checks...</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 |</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 | System check identified no issues (0 silenced).</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 |</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 | November 23, 2017 - 06:21:19</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 | Django version 1.11.7, using settings 'django_example.settings'</code></li> <li class="l1"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 | Starting development server at http://0.0.0.0:8000/</code></li> <li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">web_1 | Quit the server with CONTROL-C.</code></li> </ol> ``` 这个 `Django` 应用已经开始在你的 Docker 守护进程里监听着 `8000` 端口了。打开 `127.0.0.1:8000` 即可看到 `Django` 欢迎页面。你还可以在 Docker 上运行其它的管理命令，例如对于同步数据库结构这种事，在运行完 `docker-compose up` 后，在另外一个终端进入文件夹运行以下命令即可： ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre10 pcalibre11 pcalibre9">$ docker-compose run web python manage.py syncdb</code></li></ol> ```