• 原文地址：How to write Dockerfiles for Python Web Apps
• 原文作者：Praveen Durairaj
• 譯文出自：https://github.com/xitu/gold-miner
• 本文永久鏈接：github.com/xitu/gold-m…
• 譯者：lsvih
• 校對(duì)者：Starriers, steinliber

TL;DR

本文涵蓋了從創(chuàng)建簡(jiǎn)單的 Dockerfile 到生產(chǎn)環(huán)境多級(jí)構(gòu)建 Python 應(yīng)用的例子。以下為本指南的內(nèi)容摘要：

• 使用合適的基礎(chǔ)鏡像（開(kāi)發(fā)環(huán)境使用 debian，生產(chǎn)環(huán)境使用 alpine）。
• 在開(kāi)發(fā)時(shí)使用 gunicorn 進(jìn)行熱加載。
• 優(yōu)化 Docker 的 cache layer（緩存層）—— 按照正確的順序使用命令，僅在必要時(shí)運(yùn)行 pip install。
• 使用 flask 的 static 及 template 目錄部署靜態(tài)文件（比如 React、Vue、Angular 生成的 bundle）。
• 使用 alpine 進(jìn)行生產(chǎn)環(huán)境下的多級(jí)構(gòu)建，減少最終鏡像文件的大小。
• #彩蛋?—?在開(kāi)發(fā)時(shí)可以用 gunicorn 的 --reload 與 --reload_extra_files 監(jiān)視文件（包括 html、css 及 js）的修改。

如果你需要以上步驟的代碼，請(qǐng)參考 GitHub repo.

內(nèi)容

• 簡(jiǎn)單的 Dockerfile 與 .dockerignore
• 使用 gunicorn 實(shí)現(xiàn)熱加載
• 運(yùn)行一個(gè)單文件 python 腳本
• 部署靜態(tài)文件
• 生產(chǎn)環(huán)境中的直接構(gòu)建
• 生產(chǎn)環(huán)境中的多級(jí)構(gòu)建

假設(shè)我們有一個(gè)名為 python-app 的應(yīng)用，為其準(zhǔn)備一個(gè)簡(jiǎn)單的目錄結(jié)構(gòu)。在頂級(jí)目錄下，包含 Dockerfile 以及 src 文件夾。

python app 的源碼就存放在 src 目錄中，app 的依賴(lài)關(guān)系保存在 requirements.txt 里。為了簡(jiǎn)潔起見(jiàn)，我們假設(shè) server.py 定義了一個(gè)運(yùn)行于 8080 端口的 flask 服務(wù)。

python-app
├── Dockerfile
└── src
    └── server.py
    └── requirements.txt

1. 簡(jiǎn)單的 Dockerfile 樣例

FROM python:3.6
# 創(chuàng)建 app 目錄
WORKDIR /app
# 安裝 app 依賴(lài)
COPY src/requirements.txt ./
RUN pip install -r requirements.txt
# 打包 app 源碼
COPY src /app
EXPOSE 8080
CMD [ "python", "server.py" ]

我們將使用最新版本的 python:3.6 作為基礎(chǔ)鏡像。

在構(gòu)建鏡像時(shí)，docker 會(huì)獲取所有位于 context 目錄下的文件。為了提高 docker 構(gòu)建的速度，可以在 context 目錄中添加 .dockerignore 文件來(lái)排除不需要的文件與目錄。

通常，你的 .dockerignore 文件件應(yīng)該如下所示：

.git
__pycache__
*.pyc
*.pyo
*.pyd
.Python
env

構(gòu)建并運(yùn)行此鏡像：

$ cd python-docker
$ docker build -t python-docker-dev .
$ docker run --rm -it -p 8080:8080 python-docker-dev

你將能在 [http://localhost:8080](http://localhost:8080.) 訪(fǎng)問(wèn)此 app。使用 Ctrl+C 組合鍵可以退出程序。

現(xiàn)在，假設(shè)你希望在每次修改代碼（比如在本地部署時(shí)）時(shí)都運(yùn)行以上代碼，那么你需要在啟停 python 服務(wù)時(shí)將代碼源文件掛載到容器中。

$ docker run --rm -it -p 8080:8080 -v $(pwd):/app \
             python-docker-dev bash
root@id:/app# python src/server.py

2. 使用 Gunicorn 實(shí)現(xiàn)熱更新

gunicorn 是一款運(yùn)行于 Unix 下的 Python WSGI HTTP server，使用的是 pre-fork worker 模型（注，Arbiter 是 gunicorn 的 master，因此稱(chēng) gunicorn 為 pre-fork worker）。你可以使用各種各樣的選項(xiàng)來(lái)配置 gunicorn。向 gunicorn 命令中傳入 --reload 或是將 reload 寫(xiě)入配置文件，就可以讓 gunicorn 在有文件發(fā)生變化時(shí)自動(dòng)重啟 python 服務(wù)。

FROM python:3.6
# 創(chuàng)建 app 目錄
WORKDIR /app
# 安裝 app 依賴(lài)
COPY gunicorn_app/requirements.txt ./
RUN pip install -r requirements.txt
# 打包 app 源碼
COPY gunicorn_app /app
EXPOSE 8080

我們將構(gòu)建鏡像并運(yùn)行 gunicorn，以便在 app 目錄下文件發(fā)生變動(dòng)時(shí)對(duì)代碼進(jìn)行 rebuild。

$ cd python-docker
$ docker build -t python-hot-reload-docker .
$ docker run --rm -it -p 8080:8080 -v $(pwd):/app \
             python-hot-reload-docker bash
root@id:/app# gunicorn --config ./gunicorn_app/conf/gunicorn_config.py gunicorn_app:app

一切在 app 目錄下 python 文件的更改都會(huì)觸發(fā) rebuild，發(fā)生的變化都能在 [http://localhost:8080](http://localhost:8080.) 上實(shí)時(shí)展示。請(qǐng)注意，我們已經(jīng)將文件掛載到了容器中，因此 gunicorn 才能正常工作。

其它格式的文件怎么辦？ 如果你希望 gunicorn 在監(jiān)視代碼變動(dòng)的時(shí)候也監(jiān)視其它類(lèi)型的文件（如 template、view 之類(lèi)的文件），可以在 reload_extra_files 參數(shù)中進(jìn)行指定。此參數(shù)接受數(shù)組形式的多個(gè)文件名。

3. 運(yùn)行一個(gè)單文件 python 腳本

你可以通過(guò) docker run，使用 python 鏡像來(lái)簡(jiǎn)單地運(yùn)行 python 單文件腳本。

docker run -it --rm --name single-python-script -v "$PWD":/app -w /app python:3 python your-daemon-or-script.py

你也可以給腳本傳遞一些參數(shù)。在上面的例子中，我們就已經(jīng)掛載了當(dāng)前工作目錄，也就是說(shuō)可以將目錄中的文件當(dāng)做參數(shù)傳遞。

4. 部署靜態(tài)文件

上面的 Dockerfile 假定了你是使用 Python 運(yùn)行一個(gè) API 服務(wù)器。如果你想用 Python 為 React.js、Vue.js、Angular.js app 提供服務(wù)，可以使用 Flask。Flask 為渲染靜態(tài)文件提供了一種便捷的方式：html 文件放在 templates 目錄中，css、js 及圖片放在 static 目錄中。

請(qǐng)在此 repo 中查看簡(jiǎn)單的 hello world 靜態(tài) app 的目錄結(jié)構(gòu)。

FROM python:3.6
# 創(chuàng)建 app 目錄
WORKDIR /app
# 安裝 app 依賴(lài)
COPY static_app/requirements.txt ./
RUN pip install -r requirements.txt
# 打包 app 源碼
COPY static_app /app
EXPOSE 8080
CMD ["python","server.py"]

In your server.py,

if __name__ == '__main__':
    app.run(host='0.0.0.0')

請(qǐng)注意，host 需要設(shè)置為 0.0.0.0 - 這樣可以讓你的服務(wù)在容器外被訪(fǎng)問(wèn)。如果不設(shè)置此參數(shù)，host 會(huì)默認(rèn)設(shè)為 localhost。

5. 生產(chǎn)環(huán)境中的直接構(gòu)建

FROM python:3.6
# 創(chuàng)建 app 目錄
WORKDIR /app
# 安裝 app 依賴(lài)
COPY gunicorn_app/requirements.txt ./
RUN pip install -r requirements.txt
# 打包 app 源碼
COPY . /app
EXPOSE 8080
CMD ["gunicorn", "--config", "./gunicorn_app/conf/gunicorn_config.py", "gunicorn_app:app"]

構(gòu)建并運(yùn)行這個(gè)一體化鏡像：

$ cd python-docker
$ docker build -t python-docker-prod .
$ docker run --rm -it -p 8080:8080 python-docker-prod

由于底層為 Debian，構(gòu)建完成后鏡像約為 700MB（具體數(shù)值取決于你的源碼）。下面探討如何減小這個(gè)文件的大小。

6. 生產(chǎn)環(huán)境中的多級(jí)構(gòu)建

使用多級(jí)構(gòu)建時(shí)，將在 Dockerfile 中使用多個(gè) FROM 語(yǔ)句，但最后僅會(huì)使用最終階段構(gòu)建的文件。這樣，得到的鏡像將僅包含生產(chǎn)服務(wù)器中所需的依賴(lài)，理想情況下文件將非常小。

當(dāng)你需要使用依賴(lài)于系統(tǒng)的模塊或需要編譯的模塊時(shí)，這種構(gòu)建模式十分有用。比如 pycrypto 和 numpy 就很適合這種方法。

# ---- 基礎(chǔ) python 鏡像 ----
FROM python:3.6 AS base
# 創(chuàng)建 app 目錄
WORKDIR /app
# ---- 依賴(lài) ----
FROM base AS dependencies  
COPY gunicorn_app/requirements.txt ./
# 安裝 app 依賴(lài)
RUN pip install -r requirements.txt
# ---- 復(fù)制文件并 build ----
FROM dependencies AS build  
WORKDIR /app
COPY . /app
# 在需要時(shí)進(jìn)行 Build 或 Compile
# --- 使用 Alpine 發(fā)布 ----
FROM python:3.6-alpine3.7 AS release  
# 創(chuàng)建 app 目錄
WORKDIR /app
COPY --from=dependencies /app/requirements.txt ./
COPY --from=dependencies /root/.cache /root/.cache
# 安裝 app 依賴(lài)
RUN pip install -r requirements.txt
COPY --from=build /app/ ./
CMD ["gunicorn", "--config", "./gunicorn_app/conf/gunicorn_config.py", "gunicorn_app:app"]

使用上面的方法，用 Alpine 構(gòu)建的鏡像文件大小約 90MB，比之前少了 8 倍。使用 alpine 版本進(jìn)行構(gòu)建能有效減小鏡像的大小。

注意： 上面的 Dockerfiles 是為 python 3 編寫(xiě)的，你可以只做少數(shù)修改就能將其改為 python 2 版本。如果你要部署的是 django 應(yīng)用，也應(yīng)該能通過(guò)少數(shù)改動(dòng)就做出可部署于生產(chǎn)環(huán)境的 Dockerfiles。

此外，你是否試過(guò)將 python web app 部署在 Hasura 上呢？這其實(shí)是將 python 應(yīng)用部署于 HTTPS 域名的最快的方法（僅需使用 git push）。嘗試使用 hasura.io/hub/project… 的模板快速入門(mén)吧！Hasura 中所有的項(xiàng)目模板都帶有 Dockerfile 與 Kubernetes 標(biāo)準(zhǔn)文件，你可以自由進(jìn)行定義

以上就是Python Web App編寫(xiě)Dockerfiles示例的詳細(xì)內(nèi)容，更多關(guān)于Python Web App編寫(xiě)Dockerfiles的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論