編譯自： https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/

作者： Muhammad Arul

譯者： MjSeven

Docker 是一個開源項目，為開發人員和系統管理員提供了一個開放平台，可以將應用程序構建、打包為一個輕量級容器，並在任何地方運行。Docker 會在軟體容器中自動部署應用程序。

Django 是一個用 Python 編寫的 Web 應用程序框架，遵循 MVC（模型-視圖-控制器）架構。它是免費的，並在開源許可下發布。它速度很快，旨在幫助開發人員儘快將他們的應用程序上線。

在本教程中，我將逐步向你展示在 Ubuntu 16.04 中如何為現有的 Django 應用程序創建 docker 鏡像。我們將學習如何 docker 化一個 Python Django 應用程序，然後使用一個 docker-compose 腳本將應用程序作為容器部署到 docker 環境。

為了部署我們的 Python Django 應用程序，我們需要其它 docker 鏡像：一個用於 Web 伺服器的 nginx docker 鏡像和用於資料庫的 PostgreSQL 鏡像。

我們要做什麼？

1. 安裝 Docker-ce
2. 安裝 Docker-compose
3. 配置項目環境
4. 構建並運行
5. 測試

步驟 1 - 安裝 Docker-ce

在本教程中，我們將從 docker 倉庫安裝 docker-ce 社區版。我們將安裝 docker-ce 社區版和 docker-compose（其支持 compose 文件版本 3）。

在安裝 docker-ce 之前，先使用 apt 命令安裝所需的 docker 依賴項。

sudo apt install -y

apt-transport-https

ca-certificates

curl

software-properties-common

現在通過運行以下命令添加 docker 密鑰和倉庫。

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository

"deb [arch=amd64] https://download.docker.com/linux/ubuntu

$(lsb_release -cs)

stable"

安裝 Docker-ce

更新倉庫並安裝 docker-ce。

sudo apt update

sudo apt install -y docker-ce

安裝完成後，啟動 docker 服務並使其能夠在每次系統引導時啟動。

systemctl start docker

systemctl enable docker

接著，我們將添加一個名為 omar 的新用戶並將其添加到 docker 組。

useradd -m -s /bin/bash omar

usermod -a -G docker omar

啟動 Docker

以 omar 用戶身份登錄並運行 docker 命令，如下所示。

su - omar

docker run hello-world

確保你能從 Docker 獲得 hello-world 消息。

檢查 Docker 安裝

Docker-ce 安裝已經完成。

步驟 2 - 安裝 Docker-compose

在本教程中，我們將使用支持 compose 文件版本 3 的最新 docker-compose。我們將手動安裝 docker-compose。

使用 curl 命令將最新版本的 docker-compose 下載到 /usr/local/bin 目錄，並使用 chmod 命令使其有執行許可權。

運行以下命令：

sudo curl -L https://github.com/docker/compose/releases/download/1.21.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

現在檢查 docker-compose 版本。

docker-compose version

確保你安裝的是最新版本的 docker-compose 1.21。

安裝 Docker-compose

已安裝支持 compose 文件版本 3 的 docker-compose 最新版本。

步驟 3 - 配置項目環境

在這一步中，我們將配置 Python Django 項目環境。我們將創建新目錄 guide01，並使其成為我們項目文件的主目錄，例如包括 Dockerfile、Django 項目、nginx 配置文件等。

登錄到 omar 用戶。

su - omar

創建一個新目錄 guide01，並進入目錄。

mkdir -p guide01

cd guide01/

現在在 guide01 目錄下，創建兩個新目錄 project 和 config。

mkdir project/ config/

注意：

• project 目錄：我們所有的 python Django 項目文件都將放在該目錄中。
• config 目錄：項目配置文件的目錄，包括 nginx 配置文件、python pip 的requirements.txt 文件等。

創建一個新的 requirements.txt 文件

接下來，使用 vim 命令在 config 目錄中創建一個新的 requirements.txt 文件。

vim config/requirements.txt

粘貼下面的配置：

Django==2.0.4

gunicorn==19.7.0

psycopg2==2.7.4

保存並退出。

創建 Nginx 虛擬主機文件 django.conf

在 config 目錄下創建 nginx 配置目錄並添加虛擬主機配置文件 django.conf。

mkdir -p config/nginx/

vim config/nginx/django.conf

粘貼下面的配置：

upstream web {

ip_hash;

server web:8000;

}

# portal

server {

location / {

proxy_pass http://web/;

}

listen 8000;

server_name localhost;

location /static {

autoindex on;

alias /src/static/;

}

}

保存並退出。

創建 Dockerfile

在 guide01 目錄下創建新文件 Dockerfile。

運行以下命令：

vim Dockerfile

現在粘貼下面的 Dockerfile 腳本：

FROM python:3.5-alpine

ENV PYTHONUNBUFFERED 1

RUN apk update &&

apk add --virtual build-deps gcc python-dev musl-dev &&

apk add postgresql-dev bash

RUN mkdir /config

ADD /config/requirements.txt /config/

RUN pip install -r /config/requirements.txt

RUN mkdir /src

WORKDIR /src

保存並退出。

注意：

我們想要為我們的 Django 項目構建基於 Alpine Linux 的 Docker 鏡像，Alpine 是最小的 Linux 版本。我們的 Django 項目將運行在帶有 Python 3.5 的 Alpine Linux 上，並添加 postgresql-dev 包以支持 PostgreSQL 資料庫。然後，我們將使用 python pip 命令安裝在 requirements.txt 上列出的所有 Python 包，並為我們的項目創建新目錄 /src。

創建 Docker-compose 腳本

使用 vim 命令在 guide01 目錄下創建 docker-compose.yml 文件。

vim docker-compose.yml

粘貼以下配置內容：

version: "3"

services:

db:

image: postgres:10.3-alpine

container_name: postgres01

nginx:

image: nginx:1.13-alpine

container_name: nginx01

ports:

- "8000:8000"

volumes:

- ./project:/src

- ./config/nginx:/etc/nginx/conf.d

depends_on:

- web

web:

build: .

container_name: django01

command: bash -c "python manage.py makemigrations && python manage.py migrate && python manage.py collectstatic --noinput && gunicorn hello_django.wsgi -b 0.0.0.0:8000"

depends_on:

- db

volumes:

- ./project:/src

expose:

- "8000"

restart: always

保存並退出。

注意：

使用這個 docker-compose 文件腳本，我們將創建三個服務。使用 alpine Linux 版的 PostgreSQL 創建名為 db 的資料庫服務，再次使用 alpine Linux 版的 Nginx 創建 nginx 服務，並使用從 Dockerfile 生成的自定義 docker 鏡像創建我們的 python Django 容器。

配置項目環境

配置 Django 項目

將 Django 項目文件複製到 project 目錄。

cd ~/django

cp -r * ~/guide01/project/

進入 project 目錄並編輯應用程序設置 settings.py。

cd ~/guide01/project/

vim hello_django/settings.py

注意：

我們將部署名為 「hello_django」 的簡單 Django 應用程序。

在 ALLOW_HOSTS 行中，添加服務名稱 web。

ALLOW_HOSTS = ["web"]

現在更改資料庫設置，我們將使用 PostgreSQL 資料庫來運行名為 db 的服務，使用默認用戶和密碼。

DATABASES = {

"default": {

"ENGINE": "django.db.backends.postgresql_psycopg2",

"NAME": "postgres",

"USER": "postgres",

"HOST": "db",

"PORT": 5432,

}

}

至於 STATIC_ROOT 配置目錄，將此行添加到文件行的末尾。

STATIC_ROOT = os.path.join(BASE_DIR, "static/")

保存並退出。

配置 Django 項目

現在我們準備在 docker 容器下構建和運行 Django 項目。

步驟 4 - 構建並運行 Docker 鏡像

在這一步中，我們想要使用 guide01 目錄中的配置為我們的 Django 項目構建一個 Docker 鏡像。

進入 guide01 目錄。

cd ~/guide01/

現在使用 docker-compose 命令構建 docker 鏡像。

docker-compose build

運行 docker 鏡像

啟動 docker-compose 腳本中的所有服務。

docker-compose up -d

等待幾分鐘讓 Docker 構建我們的 Python 鏡像並下載 nginx 和 postgresql docker 鏡像。

使用 docker-compose 構建鏡像

完成後，使用以下命令檢查運行容器並在系統上列出 docker 鏡像。

docker-compose ps

docker-compose images

現在，你將在系統上運行三個容器，列出 Docker 鏡像，如下所示。

docke-compose ps 命令

我們的 Python Django 應用程序現在在 docker 容器內運行，並且已經創建了為我們服務的 docker 鏡像。

步驟 5 - 測試

打開 Web 瀏覽器並使用埠 8000 鍵入伺服器地址，我的是：http://ovh01:8000/。

現在你將看到默認的 Django 主頁。

默認 Django 項目主頁

接下來，通過在 URL 上添加 /admin 路徑來測試管理頁面。

http://ovh01:8000/admin/

然後你將會看到 Django 管理登錄頁面。

Django administration

Docker 化 Python Django 應用程序已成功完成。

參考

• https://docs.docker.com/

via: https://www.howtoforge.com/tutorial/docker-guide-dockerizing-python-django-application/

作者： Muhammad Arul 譯者： MjSeven 校對： wxy

本文由 LCTT 原創編譯， Linux中國 榮譽推出

點擊「了解更多」可訪問文內鏈接

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！