如何Docker化Python Django應(yīng)用程序
Docker 是一個開源項目,為開發(fā)人員和系統(tǒng)管理員提供了一個開放平臺,可以將應(yīng)用程序構(gòu)建、打包為一個輕量級容器,并在任何地方運行。Docker 會在軟件容器中自動部署應(yīng)用程序。
Django 是一個用 Python 編寫的 Web 應(yīng)用程序框架,遵循 MVC(模型-視圖-控制器)架構(gòu)。它是免費的,并在開源許可下發(fā)布。它速度很快,旨在幫助開發(fā)人員盡快將他們的應(yīng)用程序上線。
在本教程中,我將逐步向你展示在 Ubuntu 16.04 中如何為現(xiàn)有的 Django 應(yīng)用程序創(chuàng)建 docker 鏡像。我們將學習如何 docker 化一個 Python Django 應(yīng)用程序,然后使用一個 docker-compose
腳本將應(yīng)用程序作為容器部署到 docker 環(huán)境。
為了部署我們的 Python Django 應(yīng)用程序,我們需要其它 docker 鏡像:一個用于 Web 服務(wù)器的 nginx docker 鏡像和用于數(shù)據(jù)庫的 PostgreSQL 鏡像。
我們要做什么?
- 安裝 Docker-ce
- 安裝 Docker-compose
- 配置項目環(huán)境
- 構(gòu)建并運行
- 測試
步驟 1 - 安裝 Docker-ce
在本教程中,我們將從 docker 倉庫安裝 docker-ce 社區(qū)版。我們將安裝 docker-ce 社區(qū)版和 docker-compose
(其支持 compose 文件版本 3)。
在安裝 docker-ce 之前,先使用 apt
命令安裝所需的 docker 依賴項。
sudo apt install -y \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
現(xiàn)在通過運行以下命令添加 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 服務(wù)并使其能夠在每次系統(tǒng)引導時啟動。
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 安裝已經(jīng)完成。
步驟 2 - 安裝 Docker-compose
在本教程中,我們將使用支持 compose 文件版本 3 的*** docker-compose
。我們將手動安裝 docker-compose
。
使用 curl
命令將***版本的 docker-compose
下載到 /usr/local/bin
目錄,并使用 chmod
命令使其有執(zhí)行權(quán)限。
運行以下命令:
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
現(xiàn)在檢查 docker-compose
版本。
docker-compose version
確保你安裝的是***版本的 docker-compose 1.21。
安裝 Docker-compose
已安裝支持 compose 文件版本 3 的 docker-compose
***版本。
步驟 3 - 配置項目環(huán)境
在這一步中,我們將配置 Python Django 項目環(huán)境。我們將創(chuàng)建新目錄 guide01
,并使其成為我們項目文件的主目錄,例如包括 Dockerfile、Django 項目、nginx 配置文件等。
登錄到 omar
用戶。
su - omar
創(chuàng)建一個新目錄 guide01
,并進入目錄。
mkdir -p guide01
cd guide01/
現(xiàn)在在 guide01
目錄下,創(chuàng)建兩個新目錄 project
和 config
。
mkdir project/ config/
注意:
project
目錄:我們所有的 python Django 項目文件都將放在該目錄中。config
目錄:項目配置文件的目錄,包括 nginx 配置文件、python pip 的requirements.txt
文件等。
創(chuàng)建一個新的 requirements.txt 文件
接下來,使用 vim
命令在 config
目錄中創(chuàng)建一個新的 requirements.txt
文件。
vim config/requirements.txt
粘貼下面的配置:
Django==2.0.4
gunicorn==19.7.0
psycopg2==2.7.4
保存并退出。
創(chuàng)建 Nginx 虛擬主機文件 django.conf
在 config
目錄下創(chuàng)建 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/;
}
}
保存并退出。
創(chuàng)建 Dockerfile
在 guide01
目錄下創(chuàng)建新文件 Dockerfile
。
運行以下命令:
vim Dockerfile
現(xiàn)在粘貼下面的 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 項目構(gòu)建基于 Alpine Linux 的 Docker 鏡像,Alpine 是最小的 Linux 版本。我們的 Django 項目將運行在帶有 Python 3.5 的 Alpine Linux 上,并添加 postgresql-dev 包以支持 PostgreSQL 數(shù)據(jù)庫。然后,我們將使用 python pip
命令安裝在 requirements.txt
上列出的所有 Python 包,并為我們的項目創(chuàng)建新目錄 /src
。
創(chuàng)建 Docker-compose 腳本
使用 vim 命令在 guide01
目錄下創(chuàng)建 docker-compose.yml
文件。
vim docker-compose.yml
粘貼以下配置內(nèi)容:
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
文件腳本,我們將創(chuàng)建三個服務(wù)。使用 alpine Linux 版的 PostgreSQL 創(chuàng)建名為 db
的數(shù)據(jù)庫服務(wù),再次使用 alpine Linux 版的 Nginx 創(chuàng)建 nginx
服務(wù),并使用從 Dockerfile 生成的自定義 docker 鏡像創(chuàng)建我們的 python Django 容器。
配置項目環(huán)境
配置 Django 項目
將 Django 項目文件復制到 project
目錄。
cd ~/django
cp -r * ~/guide01/project/
進入 project
目錄并編輯應(yīng)用程序設(shè)置 settings.py
。
cd ~/guide01/project/
vim hello_django/settings.py
注意:
我們將部署名為 “hello_django” 的簡單 Django 應(yīng)用程序。
在 ALLOW_HOSTS
行中,添加服務(wù)名稱 web
。
ALLOW_HOSTS = ['web']
現(xiàn)在更改數(shù)據(jù)庫設(shè)置,我們將使用 PostgreSQL 數(shù)據(jù)庫來運行名為 db
的服務(wù),使用默認用戶和密碼。
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 項目
現(xiàn)在我們準備在 docker 容器下構(gòu)建和運行 Django 項目。
步驟 4 - 構(gòu)建并運行 Docker 鏡像
在這一步中,我們想要使用 guide01
目錄中的配置為我們的 Django 項目構(gòu)建一個 Docker 鏡像。
進入 guide01
目錄。
cd ~/guide01/
現(xiàn)在使用 docker-compose
命令構(gòu)建 docker 鏡像。
docker-compose build
運行 docker 鏡像
啟動 docker-compose
腳本中的所有服務(wù)。
docker-compose up -d
等待幾分鐘讓 Docker 構(gòu)建我們的 Python 鏡像并下載 nginx 和 postgresql docker 鏡像。
使用 docker-compose 構(gòu)建鏡像
完成后,使用以下命令檢查運行容器并在系統(tǒng)上列出 docker 鏡像。
docker-compose ps
docker-compose images
現(xiàn)在,你將在系統(tǒng)上運行三個容器,列出 Docker 鏡像,如下所示。
docke-compose ps 命令
我們的 Python Django 應(yīng)用程序現(xiàn)在在 docker 容器內(nèi)運行,并且已經(jīng)創(chuàng)建了為我們服務(wù)的 docker 鏡像。
步驟 5 - 測試
打開 Web 瀏覽器并使用端口 8000 鍵入服務(wù)器地址,我的是:http://ovh01:8000/
。
現(xiàn)在你將看到默認的 Django 主頁。
默認 Django 項目主頁
接下來,通過在 URL 上添加 /admin
路徑來測試管理頁面。
http://ovh01:8000/admin/
然后你將會看到 Django 管理登錄頁面。
Django administration
Docker 化 Python Django 應(yīng)用程序已成功完成。
參考