95 lines
3.4 KiB
Markdown
95 lines
3.4 KiB
Markdown
##使用 Django 入门 Fig
|
||
|
||
我们现在将使用 Fig 配置并运行一个 Django/PostgreSQL 应用。在此之前，先确保 Fig 已经 [安装](install.md)。
|
||
|
||
在一切工作开始前，需要先设置好三个必要的文件。
|
||
第一步，因为应用将要运行在一个满足所有环境依赖的 Docker 容器里面，那么我们可以通过编辑 `Dockerfile` 文件来指定 Docker 容器要安装内容。内容如下：
|
||
|
||
```
|
||
FROM python:2.7
|
||
ENV PYTHONUNBUFFERED 1
|
||
RUN mkdir /code
|
||
WORKDIR /code
|
||
ADD requirements.txt /code/
|
||
RUN pip install -r requirements.txt
|
||
ADD . /code/
|
||
```
|
||
以上内容指定应用将使用安装了 Python 以及必要依赖包的镜像。更多关于如何编写 Dockerfile 文件的信息可以查看 [镜像创建](../image/create.md#利用 Dockerfile 来创建镜像) 和 [Dockerfile 使用](../dockerfile/README.md)。
|
||
|
||
第二步，在 `requirements.txt` 文件里面写明需要安装的具体依赖包名 。
|
||
|
||
```
|
||
Django
|
||
psycopg2
|
||
```
|
||
|
||
就是这么简单。
|
||
第三步，`fig.yml` 文件将把所有的东西关联起来。它描述了应用的构成（一个 web 服务和一个数据库）、使用的 Docker 镜像、镜像之间的连接、挂载到容器的卷，以及服务开放的端口。
|
||
|
||
```
|
||
db:
|
||
image: postgres
|
||
web:
|
||
build: .
|
||
command: python manage.py runserver 0.0.0.0:8000
|
||
volumes:
|
||
- .:/code
|
||
ports:
|
||
- "8000:8000"
|
||
links:
|
||
- db
|
||
```
|
||
查看 [`fig.yml` 章节](yml_ref.md) 了解更多详细的工作机制。
|
||
|
||
现在我们就可以使用 `fig run` 命令启动一个 Django 应用了。
|
||
|
||
```
|
||
$ fig run web django-admin.py startproject figexample .
|
||
```
|
||
Fig 会先使用 `Dockerfile` 为 web 服务创建一个镜像，接着使用这个镜像在容器里运行 `django-admin.py startproject figexample . ` 指令。
|
||
|
||
这将在当前目录生成一个 Django 应用。
|
||
|
||
```
|
||
$ ls
|
||
Dockerfile fig.yml figexample manage.py requirements.txt
|
||
```
|
||
首先，我们要为应用设置好数据库的连接信息。用以下内容替换 `figexample/settings.py` 文件中 `DATABASES = ...` 定义的节点内容。
|
||
|
||
```
|
||
DATABASES = {
|
||
'default': {
|
||
'ENGINE': 'django.db.backends.postgresql_psycopg2',
|
||
'NAME': 'postgres',
|
||
'USER': 'postgres',
|
||
'HOST': 'db',
|
||
'PORT': 5432,
|
||
}
|
||
}
|
||
```
|
||
这些信息是在 [postgres](https://registry.hub.docker.com/_/postgres/) Docker 镜像固定设置好的。
|
||
然后，运行 `fig up` ：
|
||
|
||
```
|
||
Recreating myapp_db_1...
|
||
Recreating myapp_web_1...
|
||
Attaching to myapp_db_1, myapp_web_1
|
||
myapp_db_1 |
|
||
myapp_db_1 | PostgreSQL stand-alone backend 9.1.11
|
||
myapp_db_1 | 2014-01-27 12:17:03 UTC LOG: database system is ready to accept connections
|
||
myapp_db_1 | 2014-01-27 12:17:03 UTC LOG: autovacuum launcher started
|
||
myapp_web_1 | Validating models...
|
||
myapp_web_1 |
|
||
myapp_web_1 | 0 errors found
|
||
myapp_web_1 | January 27, 2014 - 12:12:40
|
||
myapp_web_1 | Django version 1.6.1, using settings 'figexample.settings'
|
||
myapp_web_1 | Starting development server at http://0.0.0.0:8000/
|
||
myapp_web_1 | Quit the server with CONTROL-C.
|
||
```
|
||
这个 web 应用已经开始在你的 docker 守护进程里监听着 5000 端口了（如果你有使用 boot2docker ，执行 `boot2docker ip` ，就会看到它的地址）。
|
||
|
||
你还可以在 Docker 上运行其它的管理命令，例如对于同步数据库结构这种事，在运行完 `fig up` 后，在另外一个终端运行以下命令即可：
|
||
|
||
```
|
||
$ fig run web python manage.py syncdb
|
||
``` |