From 1cbd9645fcdac99b37e84db0694733bf180140b3 Mon Sep 17 00:00:00 2001 From: copuzzle Date: Wed, 14 Jan 2015 10:51:02 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=8F=A5=E5=AD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- fig/django.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/fig/django.md b/fig/django.md index 10e3f3d..6b11803 100644 --- a/fig/django.md +++ b/fig/django.md @@ -1,9 +1,9 @@ ##使用 Django 入门 Fig -我们现在将使用 Fig 配置并运行一个 Django/PostgreSQL 应用。在开始之前，先确保已经 [安装](install.md) Fig 。 +我们现在将使用 Fig 配置并运行一个 Django/PostgreSQL 应用。在此之前，先确保 Fig 已经 [安装](install.md)。 在一切工作开始前，需要先设置好三个必要的文件。 -首先，因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面，那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下： +第一步，因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面，那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下： ``` FROM python:2.7 @@ -14,16 +14,17 @@ ADD requirements.txt /code/ RUN pip install -r requirements.txt ADD . /code/ ``` -以上内容指定了的应用使用一个 Python 镜像，并安装必要的 Python 依赖包。更多关于如何编写 Dockerfile 文件的信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md) +以上内容指定应用将使用安装了 Python 以及必要依赖包的镜像。更多关于如何编写 Dockerfile 文件的信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md)。 -接着，在 `requirements.txt` 文件里面写明需要安装的具体依赖包名 。 +第二步，在 `requirements.txt` 文件里面写明需要安装的具体依赖包名 。 ``` Django psycopg2 ``` -就是这么简单。最后，`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个 数据库）、使用的 Docker 镜像、镜像之间的通讯、挂载的卷，以及服务开放的端口。 +就是这么简单。 +第三步，`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、使用的 Docker 镜像、镜像之间的关系、挂载到容器的卷，以及服务开放的端口。 ``` db: @@ -40,12 +41,12 @@ web: ``` 查看 [`fig.yml` 章节](yml_ref.md) 了解更多详细的工作机制。 -我们现在可以使用 `fig run` 命令启动一个 Django 应用了。 +我们现在就可以使用 `fig run` 命令启动一个 Django 应用了。 ``` $ fig run web django-admin.py startproject figexample . ``` -首先 Fig 会使用 `Dockerfile` 为 web 服务创建一个容器。然后它就会在容器里运行 `django-admin.py startproject figexample . ` 指令。 +Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像。接着使用这个镜像在容器里运行 `django-admin.py startproject figexample . ` 指令。 这将在当前目录生成一个 Django 应用。 @@ -53,7 +54,7 @@ $ fig run web django-admin.py startproject figexample . $ ls Dockerfile fig.yml figexample manage.py requirements.txt ``` -首先我们要为应用是设置好数据库的连接信息。用以下内容替换 `figexample/settings.py` 文件中 `DATABASES = ...` 定义的节点内容。 +首先，我们要为应用设置好数据库的连接信息。用以下内容替换 `figexample/settings.py` 文件中 `DATABASES = ...` 定义的节点内容。 ``` DATABASES = { @@ -66,7 +67,7 @@ DATABASES = { } } ``` -这些信息是在 [postgres](https://registry.hub.docker.com/_/postgres/) Docker 镜像预先定义好的。 +这些信息是在 [postgres](https://registry.hub.docker.com/_/postgres/) Docker 镜像固定设置好的。 然后，运行 `fig up` ： ``` @@ -88,7 +89,7 @@ myapp_web_1 | Quit the server with CONTROL-C. ``` 这个 web 应用已经开始在你的 docker 守护进程里面监听着 5000 端口了（如果你有使用 boot2docker ，执行 `boot2docker ip` ，就会看到它的地址）。 -你还可以在 Docker 上运行其它的管理命令，例如对于管理数据库这种事，在另外一个终端运行 `fig up` 命令即可： +你还可以在 Docker 上运行其它的管理命令，例如对于同步数据库结构这种事，在运行完 `fig up` 后，在另外一个终端运行以下命令即可： ``` $ fig run web python manage.py syncdb