要求
安裝了1.13或者更高版本的Docker
閱讀了Part1中的定位(我沒寫)
介紹
是時候用Docker構建一個app了。我們會從構建這樣一個app的最底層開始,容器——我們這節所介紹的內容。在這層之上是服務,服務定義了容器們的在生產中的行為,在第3章介紹。最上層的是堆,定義了服務的交互行為,在第5章介紹。
堆(Stack)
服務(Services)
容器(container)
新開發環境
使用docker,您可以直接獲取一個可移植的Python運行時作為映像。然后,您的構建可以在應用程序代碼旁邊包含基本的Python映像,確保應用程序、它的依賴項和運行時環境一起運行。
用Dockerfile
定義一個容器
Dockerfile將定義容器內環境的內容。訪問像網絡接口和磁盤驅動器之類的資源在這個環境中是虛擬化的,這與系統的其他部分是隔離的,因此您必須將端口映射到外部世界,并具體地說明您想要“復制”到該環境中的文件。然而,在做了這些之后,您可以期望在這個Dockerfile中定義的應用程序的構建在運行的任何地方都是完全相同的。
Dockerfile
創建一個空目錄。將目錄(cd)更改為新目錄,創建一個名為Dockerfile的文件,將以下內容復制粘貼到該文件中,并保存它。注意在新Dockerfile中解釋每個語句的注釋。
# Use an official Python runtime as a parent image
FROM python:2.7-slim# Set the working directory to /app
WORKDIR /app# Copy the current directory contents into the container at /app
ADD . /app# Install any needed packages specified in requirements.txt
RUN pip install --trusted-host pypi.python.org -r requirements.txt# Make port 80 available to the world outside this container
EXPOSE 80# Define environment variable
ENV NAME World# Run app.py when the container launches
CMD ["python", "app.py"]
您是否使用了代理服務器?
代理服務器一旦啟動并運行,就可以阻塞連接到您的web應用程序。如果您在代理服務器后面,請在Dockerfile中添加以下幾行,使用ENV命令為您的代理服務器指定主機和端口:
# Set proxy server, replace host:port with values for your servers
ENV http_proxy host:port
ENV https_proxy host:port
這個Dockerfile和我們還沒有創建的兩個文件有聯系,即app.py和requirements.txt。接下來讓我們創建這些。
應用程序本身
創建兩個更多的文件,requirements.txt和app.py,并將它們放在與Dockerfile相同的文件夾中。這就完成了我們的應用程序,正如您所看到的非常簡單。當上述Dockerfile被構建成一個Image,由于Dockerfile的ADD命令會添加requirements.txt和app.py,感謝EXPOSE使app.py的輸出可以通過HTTP訪問。
requirements.txt
Flask
Redis
app.py
from flask import Flask
from redis import Redis, RedisError
import os
import socket# Connect to Redis
redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)app = Flask(__name__)@app.route("/")
def hello():try:visits = redis.incr("counter")except RedisError:visits = "<i>cannot connect to Redis, counter disabled</i>"html = "<h3>Hello {name}!</h3>" \"<b>Hostname:</b> {hostname}<br/>" \"<b>Visits:</b> {visits}"return html.format(name=os.getenv("NAME", "world"), hostname=socket.gethostname(), visits=visits)if __name__ == "__main__":app.run(host='0.0.0.0', port=80)
現在我們看到pip install -r requirements.txt
為Python安裝Flask和Redis庫,應用程序打印環境變量NAME
,以及調用socket.gethostname()的輸出。最后,因為Redis沒有運行(因為我們只安裝了Python庫,而不是Redis本身),我們應該期望在這里使用它的嘗試會失敗并產生錯誤消息。
注意:當容器內檢索容器ID時訪問主機名,這就像運行可執行文件的進程ID
就是這樣!您不需要Python或requirements.txt
中的任何東西在你的系統上,也不會在你的系統上安裝或運行這個映像。看起來你并沒有真正建立一個包含Python和Flask的環境,但是你有。
構建應用
我們已經準備好構建應用程序,確保您仍然處于新目錄的頂層。下面是ls應該展示的:
$ ls
Dockerfile app.py requirements.txt
現在運行build命令。這創建了一個Docker映像,我們將使用- t標記它,因此它有一個友好的名稱。
docker build -t friendlyhello .
你的構建的Image在哪里?就在你的機器的本地Docker圖像注冊表中:
$ docker imagesREPOSITORY TAG IMAGE ID
friendlyhello latest 326387cea398
提示:您可以使用命令
docker images
或較新的docker image ls
查看所有的鏡像。它們給出相同的輸出。
運行應用
運行應用程序,使用-p
,將您的機器的端口4000映射到容器已經發布的端口80:
docker run -p 4000:80 friendlyhello
您應該看到一條消息,Python正在以http://0.0.0.0:80為您的應用服務。但是這個消息來自容器內部,它不知道您將該容器的80端口映射到4000,從而使正確的URL http://localhost:4000。
在web瀏覽器中訪問該URL,可以看到web頁面上顯示的顯示內容,包括“Hello World”文本、容器ID和Redis錯誤消息。
注意:如果您在Windows 7上使用Docker工具,使用Docker機器IP而不是localhost。例如,http://192.168.99.100:4000。要查看IP地址,請使用命令docker -machine IP。
您還可以在shell中使用curl命令來查看相同的內容。
$ curl http://localhost:4000<h3>Hello World!</h3><b>Hostname:</b> 8fc990912a14<br/><b>Visits:</b> <i>cannot connect to Redis, counter disabled</i>
這個端口映射4000:80是為了演示在Dockerfile中公開的內容和使用docker run - p發布的內容之間的區別。在后面的步驟中,我們將把端口80映射到容器中的80端口,并使用http://localhost。
在你的終端按CTRL + C退出。
現在讓我們在后臺運行應用程序,在分離的模式下:
docker run -d -p 4000:80 friendlyhello
你得到了你的應用程序的容器長ID,然后被離開你的終端。您的容器將在后臺運行。您還可以看到縮寫容器ID通過docker container ls
(在運行命令時,這兩個工作都可以互換):
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED
1fa4ab2cf395 friendlyhello "python app.py" 28 seconds ago
您將看到匹配http://localhost:4000上的CONTAINER ID
現在使用docker容器停止進程,使用容器ID,例如:
docker container stop 1fa4ab2cf395
分享你的鏡像
為了演示我們剛剛創建的可移植性,讓我們上傳我們構建的映像并在其他地方運行它。畢竟,當您想要將容器部署到生產時,您需要學習如何推動注冊。
注冊表是存儲庫的集合,而存儲庫是鏡像的集合——有點像GitHub庫,只是代碼已經構建好了。注冊表上的帳戶可以創建許多存儲庫。docker CLI在默認情況下使用docker的公共注冊表。
注意:我們將在這里使用Docker的公共注冊表,因為它是免費和預配置的,但是有許多公共注冊中心可供選擇,而且您甚至可以使用Docker可信注冊表建立您自己的私有注冊表。
使用您的Docker ID登錄
如果你沒有Docker帳戶,在cloud.docker.com注冊一個。記下你的用戶名。
登錄到本地機器上的Docker公共注冊表。
$ docker login
標記鏡像
將本地映像與注冊表中的存儲庫關聯的符號是username/repository:tag
。標簽是可選的,但推薦,因為它是注冊中心用來給Docker映像提供一個版本的機制。提供存儲庫并為上下文標記有意義的名稱,例如get - started:part2。這將把鏡像放到get-started存儲庫中,并將其標記為part2。
docker tag image username/repository:tag
例如:
docker tag image username/repository:tag
運行docker image
以查看新標記的圖像。(您也可以使用docker image ls
)
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
friendlyhello latest d9e555c53008 3 minutes ago 195MB
john/get-started part2 d9e555c53008 3 minutes ago 195MB
python 2.7-slim 1c7128a655f6 5 days ago 183MB
...
發布鏡像
將您的標記鏡像上載到存儲庫
docker push username/repository:tag
一旦完成,這個上傳的結果是公開的。如果您登錄到Docker Hub,您將在那里看到新的圖像,使用它的pull命令。
從遠程存儲庫中提取和運行映像
從現在開始,你可以使用docker run
在任何機器上運行你的應用程序:
docker run -p 4000:80 username/repository:tag
如果映像在機器上沒有本地可用,Docker將從存儲庫中提取該映像。
$ docker run -p 4000:80 john/get-started:part2
Unable to find image 'john/get-started:part2' locally
part2: Pulling from john/get-started
10a267c67f42: Already exists
f68a39a6a5e4: Already exists
9beaffc0cf19: Already exists
3c1fe835fb6b: Already exists
4c9f1fa8fcb8: Already exists
ee7d8f576a14: Already exists
fbccdcced46e: Already exists
Digest: sha256:0601c866aab2adcc6498200efd0f754037e909e5fd42069adeff72d1e2439068
Status: Downloaded newer image for john/get-started:part2* Running on http://0.0.0.0:80/ (Press CTRL+C to quit)
注意:如果您沒有指定這些命令的標記部分
:tag
,那么將會假定您在構建和運行映像時都將使用最新的標記:latest
。Docker將使用沒有指定標記的圖像的最后一個版本(不一定是最近的圖像)。
無論docker運行在哪里,它都會拉出您的映像,以及Python以及來自需求的所有依賴項requirements.txt
,并運行您的代碼。它在一個整潔的小程序包中一起運行,而主機不需要安裝任何東西,而是安裝Docker來運行它。