## 使用 Django 本小節內容適合 `Python` 開發人員閱讀。 我們現在將使用 `Docker Compose` 配置并運行一個 `Django/PostgreSQL` 應用。 在一切工作開始前，需要先編輯好三個必要的文件。 第一步，因為應用將要運行在一個滿足所有環境依賴的 Docker 容器里面，那么我們可以通過編輯 `Dockerfile` 文件來指定 Docker 容器要安裝內容。內容如下： ```docker FROM python:3 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` 文件里面寫明需要安裝的具體依賴包名。 ```bash Django>=1.8,<2.0 psycopg2 ``` 第三步，`docker-compose.yml` 文件將把所有的東西關聯起來。它描述了應用的構成（一個 web 服務和一個數據庫）、使用的 Docker 鏡像、鏡像之間的連接、掛載到容器的卷，以及服務開放的端口。 ```yaml version: "3" services: db: image: postgres web: build: . command: python3 manage.py runserver 0.0.0.0:8000 volumes: - .:/code ports: - "8000:8000" links: - db ``` 查看 [`docker-compose.yml` 章節](yml_ref.md) 了解更多詳細的工作機制。 現在我們就可以使用 `docker-compose run` 命令啟動一個 `Django` 應用了。 ```bash $ docker-compose run web django-admin.py startproject django_example . ``` Compose 會先使用 `Dockerfile` 為 web 服務創建一個鏡像，接著使用這個鏡像在容器里運行 `django-admin.py startproject composeexample` 指令。 這將在當前目錄生成一個 `Django` 應用。 ```bash $ ls Dockerfile docker-compose.yml django_example manage.py requirements.txt ``` 如果你的系統是 Linux,記得更改文件權限。 ```bash sudo chown -R $USER:$USER . ``` 首先，我們要為應用設置好數據庫的連接信息。用以下內容替換 `django_example/settings.py` 文件中 `DATABASES = ...` 定義的節點內容。 ```python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'postgres', 'USER': 'postgres', 'HOST': 'db', 'PORT': 5432, } } ``` 這些信息是在 [postgres](https://store.docker.com/images/postgres/) 鏡像固定設置好的。然后，運行 `docker-compose up` ： ```bash $ docker-compose up django_db_1 is up-to-date Creating django_web_1 ... Creating django_web_1 ... done Attaching to django_db_1, django_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 | Performing system checks... web_1 | web_1 | System check identified no issues (0 silenced). web_1 | web_1 | November 23, 2017 - 06:21:19 web_1 | Django version 1.11.7, using settings 'django_example.settings' web_1 | Starting development server at http://0.0.0.0:8000/ web_1 | Quit the server with CONTROL-C. ``` 這個 `Django` 應用已經開始在你的 Docker 守護進程里監聽著 `8000` 端口了。打開 `127.0.0.1:8000` 即可看到 `Django` 歡迎頁面。 你還可以在 Docker 上運行其它的管理命令，例如對于同步數據庫結構這種事，在運行完 `docker-compose up` 后，在另外一個終端進入文件夾運行以下命令即可： ```bash $ docker-compose run web python manage.py syncdb ```