## 使用 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
```
- 前言
- 修訂記錄
- 如何貢獻
- Docker 簡介
- 什么是 Docker
- 為什么要用 Docker
- 基本概念
- 鏡像
- 容器
- 倉庫
- 安裝 Docker
- Ubuntu
- Debian
- CentOS
- Raspberry Pi
- macOS
- Windows PC
- 鏡像加速器
- 使用鏡像
- 獲取鏡像
- 列出鏡像
- 刪除本地鏡像
- 利用 commit 理解鏡像構成
- 使用 Dockerfile 定制鏡像
- Dockerfile 指令詳解
- COPY 復制文件
- ADD 更高級的復制文件
- CMD 容器啟動命令
- ENTRYPOINT 入口點
- ENV 設置環境變量
- ARG 構建參數
- VOLUME 定義匿名卷
- EXPOSE 暴露端口
- WORKDIR 指定工作目錄
- USER 指定當前用戶
- HEALTHCHECK 健康檢查
- ONBUILD 為他人作嫁衣裳
- 參考文檔
- Dockerfile 多階段構建
- 其它制作鏡像的方式
- 實現原理
- 操作容器
- 啟動
- 守護態運行
- 終止
- 進入容器
- 導出和導入
- 刪除
- 訪問倉庫
- Docker Hub
- 私有倉庫
- 私有倉庫高級配置
- Nexus 3
- 數據管理
- 數據卷
- 掛載主機目錄
- 使用網絡
- 外部訪問容器
- 容器互聯
- 配置 DNS
- 高級網絡配置
- 快速配置指南
- 容器訪問控制
- 端口映射實現
- 配置 docker0 網橋
- 自定義網橋
- 工具和示例
- 編輯網絡配置文件
- 實例:創建一個點到點連接
- Docker 三劍客之 Compose 項目
- 簡介
- 安裝與卸載
- 使用
- 命令說明
- Compose 模板文件
- 實戰 Django
- 實戰 Rails
- 實戰 WordPress
- Docker 三劍客之 Machine 項目
- 安裝
- 使用
- Docker 三劍客之 Docker Swarm
- Swarm mode
- 基本概念
- 創建 Swarm 集群
- 部署服務
- 使用 compose 文件
- 管理敏感數據
- 管理配置信息
- 滾動升級
- 安全
- 內核命名空間
- 控制組
- 服務端防護
- 內核能力機制
- 其它安全特性
- 總結
- 底層實現
- 基本架構
- 命名空間
- 控制組
- 聯合文件系統
- 容器格式
- 網絡
- Etcd 項目
- 簡介
- 安裝
- 集群
- 使用 etcdctl
- CoreOS 項目
- 簡介
- 工具
- 快速搭建 CoreOS 集群
- Kubernetes 項目
- 簡介
- 快速上手
- 基本概念
- kubectl 使用
- 架構設計
- Mesos - 優秀的集群資源調度平臺
- Mesos 簡介
- 安裝與使用
- 原理與架構
- Mesos 配置項解析
- 日志與監控
- 常見應用框架
- 本章小結
- 容器與云計算
- 簡介
- 亞馬遜云
- 騰訊云
- 阿里云
- 小結
- 實戰案例-操作系統
- Busybox
- Alpine
- Debian Ubuntu
- CentOS Fedora
- 本章小結
- 實戰案例-CI/CD
- Drone
- Docker 開源項目
- LinuxKit
- 附錄
- 附錄一:常見問題總結
- 附錄二:熱門鏡像介紹
- Ubuntu
- CentOS
- MySQL
- MongoDB
- Redis
- Nginx
- WordPress
- Node.js
- 附錄三:Docker 命令查詢
- 附錄四:Dockerfile 最佳實踐
- 附錄五:資源鏈接
- 附錄六:Docker 中文資源