python應用——在 Docker 中運行一個 Python 的 Web 應用

編程語言 Python Docker 軟件 Flask 編程小派克 2018-12-04

參考資源

原始的Python應用(非Docker化)源代碼託管在GitHub上(master版本),網址為https://github.com/awslabs/eb-py-flask-signup/tree/docker。Docker化的版本在docker版本中,網址為:https://github.com/awslabs/eb-py-flask-signup/tree/docker

如果你喜歡代碼和不同版本間的比對,你可利用GitHub對比功能查看兩個版本的區別。網址為https://github.com/awslabs/eb-py-flask-signup/compare/master...docker。你也可以查看Docker化後添加的每個文件或者每行代碼。

Docker化階段1:添加Dockerfile文件

首先從GitHub上克隆源代碼:

$> git clone [email protected]:awslabs/eb-py-flask-signup.git
$> cd eb-py-flask-signup
$> git checkout master

通過查看目錄內容,知道這是一個簡單的Python應用,使用Flask框架,Boto和一些其他的依賴(在requirements.txt中聲明瞭該依賴),其中Boto用於DynamoDB和SNS的互動。

足夠簡單,以至於我們只需創建一個Dockerfile,構建一個適用於運行該應用的鏡像。Dockerfile和其他應用源均放在目錄中(即,和requirements.txt, application.py等等放在一塊)。

FROM ubuntu:12.10
# Install Python Setuptools
RUN apt-get install -y python-setuptools
# Install pip
RUN easy_install pip
# Add and install Python modules
ADD requirements.txt /src/requirements.txt
RUN cd /src; pip install -r requirements.txt
# Bundle app source
ADD . /src
# Expose
EXPOSE 5000
# Run
CMD ["python", "/src/application.py"]

Docker化階段 2 :在本地測試

雖然這個應用程序需要一個DynamoDB表和SNS主題來完成全部功能,不過我可以但沒有測試它們:

首先, 構建 Docker 鏡像:

$> docker build -t eb-py-sample .

最後 (直接到可以使用後!),通過構建好的image運行一個container (映射 container 的5000端口到主機的8080端口, 並且按照下面的代碼設置一些環境變量):

$> docker run -d \
-e APP_CONFIG=application.config.example \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-p 8080:5000 \
eb-py-sample

在 OS X上,我打開 http://localhost:8080鏈接,下圖顯示的就是我的一個應用程序!

python應用——在 Docker 中運行一個 Python 的 Web 應用

邊欄:我們使用-e選項來傳遞一些選項:

  • APP_CONFIG: 這個程序使用這個選項加載(指向)它的配置文件. 默認我們指定一個默認的配置文件。 你可以創建一個 DynamoDB 表和SNS 主題並且將他們添加到這個配置文件中,以使你的應用程序在本地開發的時候可以更完美的工作。
  • AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY: 這個應用程序使用 Boto 來連接 DynamoDB 和SNS, 並且 Boto 使用這些環境變量來認證請求以上服務。這些設置僅僅是為了本地開發。 當我們向 Elastic Beanstalk 部署時將使用統一身份和訪問控制方案(IAM) 角色(Roles)。

Docker 化階段 3: 修改 .ebextensions

我們的應用程序擁有一個特殊的文件夾 .ebextensions,裡面有個 setup.config 文件。我們使用這個文件通知來 Elastic Beanstalk 創建我們程序所需要的 DynamoDB 表和 SNS 主題, 同時他會創建一個配置文件 /var/app/app.config ,這個文件包含了我們剛才創建的 DynamoDB 表和 SNS 主題的名字。

這個文件中還有一些特殊的地方是他擁有特殊的在 Elastic Beanstalk(相對於 Docker)中的 Python的環境類型(python版本?) ,我們需要把他們移除掉:

修改 files 的成員,並且移除掉 owner 和 group 鍵,使他看起來像下面的這些:

files:
"/var/app/app.config":
mode: "000444"
content: |
AWS_REGION = '`{ "Ref" : "AWS::Region"}`'
STARTUP_SIGNUP_TABLE = '`{ "Ref" : "StartupSignupsTable"}`'
NEW_SIGNUP_TOPIC = '`{ "Ref" : "NewSignupTopic"}`'

修改 option_settings ,刪除靜態文件映射。使他看起來像下面的這些:

option_settings:
"aws:elasticbeanstalk:customoption":
"AlarmEmail" : "[email protected]"
"aws:elasticbeanstalk:application:environment":
"APP_CONFIG": "/var/app/app.config"
"FLASK_DEBUG": "false"
"THEME": "flatly"

檢查一下setup.config文件,確認前面的所有變化是否正確,或者可以參考託管在在GitHub上的setup.config。

Docker化階段4: 部署到Elastic Beanstalk

我已經建立並測試了我的本地容器,移除了一些.ebextensions,它是特定的Elastic Beanstalk Python環境,我已經信心滿滿地準備部署它了!

我創建了一個文件,名字叫做Dockerrun.aws.json,與此類似,我創建了Dockerfile。這個文件將會告訴Elastic Beanstalk 怎麼去運行Docker容器並且它看起來像是這樣的(這個文件的詳細信息,請參閱下方)。

 {
"AWSEBDockerrunVersion": "1",
"Volumes": [
{
"ContainerDirectory": "/var/app",
"HostDirectory": "/var/app"
}
],
"Logging": "/var/eb_log"
}

關於Dockerrun.aws.json

Volumes成員將會在EC2上映射/var/app實例到容器上的/var/app。Docker容器通過訪問app.config文件並通過創建.ebextensions/setup.config得以讓app在容器上運行。Logging成員告訴Elastic Beanstalk我們的Docker app將會記錄日誌到/var/eb_log到容器中。在控制檯裡,無論什麼時候你點擊Snapshot Logs或者如果你啟用自動日誌輪轉,Beanstalk將會自動推送日誌/var/eb_log到這個目錄。

我將提交我的修改,並且使用 git archive 來生成一個zip文件以便部署到Elastic Beanstalk上(你可以使用zip工具、Finder或Windows 資源管理器來打包):

$> git add Docker* && git commit -am "Dockerized"
$> git archive --format=zip HEAD > eb-py-flask-signup.zip

之後,我通過 Elastic Beanstalk Management Console 來部署生成後的zip包

python應用——在 Docker 中運行一個 Python 的 Web 應用

當我的環境通過之後,我可以訪問它,確保它可以正常工作:

python應用——在 Docker 中運行一個 Python 的 Web 應用

我還保存了環境日誌的快照:

python應用——在 Docker 中運行一個 Python 的 Web 應用

由於我之前往Dockerrun.aws.json文件中添加了Logging 成員,所以,容器中輸出到/var/eb_log中的日誌可以被定向到S3,並且我可以在瀏覽器中訪問它們:

python應用——在 Docker 中運行一個 Python 的 Web 應用

相關推薦

推薦中...