Docker Compose 搭建簡單的Python網絡應用程序(步驟詳解)
在這個頁面上,你可以建立一個簡單的Python網絡應用程序,運行在Docker Compose上。該應用使用Flask框架,並在Redis中維護一個點擊計數器。雖然樣本使用瞭Python,但即使你不熟悉它,這裡展示的概念也應該是可以理解的。(官網教程翻譯)
前提條件
請確保你已經安裝瞭Docker Engine和Docker Compose。你不需要安裝Python或Redis,因為兩者都是由Docker鏡像提供的。
第1步:設置
定義應用程序的依賴。
- 為該項目創建一個目錄。
$ mkdir composetest $ cd composetest
- 在你的項目目錄下創建一個名為
app.py
的文件,並把以下內容粘貼進去:
import time import redis from flask import Flask app = Flask(__name__) cache = redis.Redis(host='redis', port=6379) def get_hit_count(): retries = 5 while True: try: return cache.incr('hits') except redis.exceptions.ConnectionError as exc: if retries == 0: raise exc retries -= 1 time.sleep(0.5) @app.route('/') def hello(): count = get_hit_count() return 'Hello World! I have been seen {} times.\n'.format(count)
在這個例子中,redis
是應用程序網絡中的redis容器的主機名。我們使用Redis的默認端口,6379。
處理瞬時錯誤 註意
get_hit_count
函數的編寫方式。這個基本的重試循環讓我們在redis服務不可用時多次嘗試我們的請求。這在應用程序上線的時候很有用,而且如果Redis服務需要在應用程序的生命周期內隨時重啟,這也使我們的應用程序更具彈性。在一個集群中,這也有助於處理節點之間的瞬間連接中斷。
- 在你的項目目錄下創建另一個名為
requirements.txt
的文件,並將以下內容粘貼進去:
flask redis
第2步:創建一個Dockerfile
在這一步,你要寫一個Dockerfile來構建一個Docker鏡像。這個鏡像包含瞭Python應用程序所需的所有依賴項,包括Python本身。
在你的項目目錄中,創建一個名為 Dockerfile
的文件並粘貼以下內容:
# syntax=docker/dockerfile:1 FROM python:3.7-alpine WORKDIR /code ENV FLASK_APP=app.py ENV FLASK_RUN_HOST=0.0.0.0 RUN apk add --no-cache gcc musl-dev linux-headers COPY requirements.txt requirements.txt RUN pip install -r requirements.txt EXPOSE 5000 COPY . . CMD ["flask", "run"]
這告訴Docker:
-
從Python 3.7鏡像開始構建一個鏡像。
-
設置工作目錄為
/code
。 -
設置
flask
命令使用的環境變量。 -
安裝gcc和其他依賴項
-
復制
requirements.txt
並安裝Python依賴項。 -
給鏡像添加元數據,描述容器在5000端口上監聽
-
將項目中的當前目錄.復制到鏡像中的工作目錄.。
-
將容器的默認命令設置為
flask run
。
第3步:在Compose文件中定義服務
在你的項目目錄下創建一個名為 docker-compose.yml
的文件,並粘貼以下內容:
version: "3.9" services: web: build: . ports: - "8000:5000" redis: image: "redis:alpine"
這個 Compose 文件定義瞭兩個服務:web
和 redis
。
Web服務
web
服務使用一個從當前目錄下的 Dockerfile
文件構建的鏡像。然後它將容器和主機綁定到暴露的端口8000上。本例服務使用Flask網絡服務器的默認端口,即5000。
Redis服務
redis
服務使用瞭一個從Docker Hub倉庫中拉取的公共Redis鏡像。
第4步:用Compose構建和運行你的應用
- 在你的項目目錄中,通過運行
docker-compose up
來啟動你的應用程序。
$ docker-compose up Creating network "composetest_default" with the default driver Creating composetest_web_1 ... Creating composetest_redis_1 ... Creating composetest_web_1 Creating composetest_redis_1 ... done Attaching to composetest_web_1, composetest_redis_1 web_1 | * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit) redis_1 | 1:C 17 Aug 22:11:10.480 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo redis_1 | 1:C 17 Aug 22:11:10.480 # Redis version=4.0.1, bits=64, commit=00000000, modified=0, pid=1, just started redis_1 | 1:C 17 Aug 22:11:10.480 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf web_1 | * Restarting with stat redis_1 | 1:M 17 Aug 22:11:10.483 * Running mode=standalone, port=6379. redis_1 | 1:M 17 Aug 22:11:10.483 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128. web_1 | * Debugger is active! redis_1 | 1:M 17 Aug 22:11:10.483 # Server initialized redis_1 | 1:M 17 Aug 22:11:10.483 # WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled. web_1 | * Debugger PIN: 330-787-903 redis_1 | 1:M 17 Aug 22:11:10.483 * Ready to accept connections
Compose會拉取一個Redis鏡像,為你的代碼構建一個鏡像,並啟動你定義的服務。在這種情況下,代碼在構建時被靜態地復制到鏡像中。
- 在瀏覽器中輸入http://localhost:8000/,可以看到應用程序正在運行。
如果你在本地Linux上使用Docker、Docker Desktop for Mac或Docker Desktop for Windows,那麼網絡應用現在應該在你的Docker守護主機上監聽8000端口。將你的網絡瀏覽器指向http://localhost:8000,找到`Hello World` 消息。如果這還沒有解決,你也可以試試http://127.0.0.1:8000。
你應該在你的瀏覽器中看到一條消息說:
Hello World! I have been seen 1 times.
3. 刷新頁面。
這個數字應該是遞增的。
Hello World! I have been seen 2 times.
- 切換到另一個終端窗口,並輸入
docker image ls
來列出本地圖像。
在這一點上,列出圖像應該返回 redis
和 web
。
$ docker image ls REPOSITORY TAG IMAGE ID CREATED SIZE composetest_web latest e2c21aa48cc1 4 minutes ago 93.8MB python 3.4-alpine 84e6077c7ab6 7 days ago 82.5MB redis alpine 9d8fa9aa0e5b 3 weeks ago 27.5MB
你可以用 docker inspect <tag or id>
檢查鏡像。
- 停止應用程序,可以在第二個終端中的項目目錄中運行
docker-compose down
,或者在啟動應用程序的原始終端中點擊CTRL+C。
第5步:編輯Compose文件以添加綁定掛載
在你的項目目錄中編輯 docker-compose.yml
,為 web
服務添加一個綁定掛載。
version: "3.9" services: web: build: . ports: - "8000:5000" volumes: - .:/code environment: FLASK_ENV: development redis: image: "redis:alpine"
新的 volumes
鍵將主機上的項目目錄(當前目錄)掛載到容器內的 /code
,允許你即時修改代碼,而不需要重建鏡像。environment
鍵設置 FLASK_ENV
環境變量,它告訴 flask run
在開發模式下運行,並在代碼變化時重新加載。這種模式隻應在開發中使用。
第6步:用Compose重新構建並運行應用程序
在你的項目目錄下,輸入 docker-compose up
,用更新的Compose文件構建應用程序,並運行它。
$ docker-compose up Creating network "composetest_default" with the default driver Creating composetest_web_1 ... Creating composetest_redis_1 ... Creating composetest_web_1 Creating composetest_redis_1 ... done Attaching to composetest_web_1, composetest_redis_1 web_1 | * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit) ...
再次在網絡瀏覽器中檢查 Hello World
消息,並刷新以看到計數的增加。
共享文件夾、卷和綁定掛載
如果你的項目在
Users
目錄之外(cd ~
),那麼你需要共享你正在使用的Dockerfile文件和volume的驅動器或位置。如果你得到運行時的錯誤,表明找不到應用文件,卷掛載被拒絕,或服務無法啟動,請嘗試啟用文件或驅動器共享。卷掛載需要在C:\Users
(Windows)或/Users
(Mac)之外的項目共享驅動器,而且對於Docker Desktop for Windows上任何使用Linux容器的項目都是必需的。如果你在舊的Windows操作系統上使用Oracle VirtualBox,你可能會遇到這個VB故障單中描述的共享文件夾的問題。較新的Windows系統符合Docker Desktop for Windows的要求並且不需要VirtualBox。
第7步:更新應用程序
因為應用程序代碼現在是用volume裝入容器的,所以你可以對其代碼進行修改,並立即看到變化,而不需要重建鏡像。
改變 app.py
中的問候語,並保存它。例如,將 Hello World!
的信息改為 Hello from Docker!
。
return 'Hello from Docker! I have been seen {} times.\n'.format(count)
在你的瀏覽器中刷新該應用程序。問候語應該被更新,而計數器應該仍然在遞增。
第8步:試驗一些其他命令
如果你想在後臺運行你的服務,你可以向 docker-compose up
傳遞 -d
標志(用於 "分離 "模式),並使用docker-compose ps
來查看當前正在運行的內容:
$ docker-compose up -d Starting composetest_redis_1... Starting composetest_web_1... $ docker-compose ps Name Command State Ports ------------------------------------------------------------------------------------- composetest_redis_1 docker-entrypoint.sh redis ... Up 6379/tcp composetest_web_1 flask run Up 0.0.0.0:8000->5000/tcp
docker-compose
的運行命令允許你為你的服務運行一次性的命令。例如,看看 web
服務有哪些環境變量可用:
$ docker-compose run web env
參見 docker-compose --help
以查看其他可用的命令。
如果你用 docker-compose up -d
啟動瞭Compose,一旦你完成瞭你的服務,就停止它們:
$ docker-compose stop
你可以用 down
命令來關閉一切,完全刪除容器。通過 --volumes
,也可以刪除Redis容器所使用的數據卷:
$ docker-compose down --volumes
在這一點上,你已經明白瞭 Compose 是如何工作的。
到此這篇關於Docker Compose 搭建簡單的Python網絡應用程序的詳細步驟的文章就介紹到這瞭,更多相關Docker Compose 搭建Python網絡應用程序內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- 解決使用Docker Compose管理容器的問題
- Docker Compose的安裝和使用步驟
- docker-compose教程之安裝使用和快速入門
- docker打包Python環境的過程詳解
- Docker compose部署SpringBoot項目連接MySQL及遇到的坑