Docker官方文檔翻譯2
容器
準備工作
- 安裝Docker,版本為1.13或者1.13之上。
- 閱讀第一篇文章的內容
- 給你的Docker環境一個快速的測試,確保所有的工作準備就緒:
docker run hello-world
介紹
是時候以Docker的方式開始構建一個應用程序了。我們從這個層次結構的底部開始,即它是一個容器,這是我們在這個界面上介紹的。在這個層次(容器?)之上是一個服務,它定義了容器在生產環境中的表現行為,在下一篇文章中我們會進行探討。最後,在頂層是堆棧,定義了第5篇文章中介紹的所有服務的交互。
- 堆棧(第五篇文章介紹)
- 服務(第三篇文章介紹)
- 容器(這篇文章介紹,you are here)
你的新的開發環境
在過去,如果你寫一個pyhton的應用,你的第一步是在你的機器上安裝python的開發環境。但是需要你的機器上的運行環境與應用程序完美適合,並且也需要匹配生產環境。
利用docker,你能移植一個便捷的python的運行庫作為鏡像,無需安裝。然後,通過構建包含python運行環境和你的應用代碼一起的鏡像,能夠確保你的代碼和運行環境完美結合併運行。
這些便捷的鏡像通過被稱作DockeFile的文件定義。
通過Dockerfile定義一個鏡像
dockerfile定義了在容器內部跑什麼運行環境。訪問網路介面和磁碟驅動器等資源是在此環境中虛擬化的,與系統其餘部分隔離,因此你需要將埠映射到外部世界,並明確要將哪些文件「複製」到 運行的環境。 然而,在完成這些之後,你可以預期,在此Dockerfile中定義的應用程序的構建在運行時的行為完全相同。
Dockerfile
創建一個空的文件夾。通過cd命令進入到新創建的文件夾,創建一個文件取名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"]
這個Dockerfile關聯了2個我們還沒有創建的文件,,即app.py和requirements.txt。下面我們來創建。
應用程序部分
創建2個文件,requirements.txt和app.py,並且將它們放到和Dockerfile放進同一個文件夾中。這就完成了我們的應用,你可以發現用創建應用很簡單。當上面的Dockerfile構建成鏡像,app.py和requirements.txt通過Add命令加入到鏡像去了,Expose命令能夠暴露埠,可以通過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本身),所以我們應該期望在這裡嘗試使用它會失敗併產生錯誤消息。
那正是要點! 您的系統上不需要Python或任何requirements.txt文件,也不需要在您的系統上安裝或運行此映像。看起來你並沒有真正用Python和Flask建立一個環境,但是你已經擁有了。
構建應用
我們已經為構建應用做好了準備。確保你對新建的文件與最高的許可權。下面是通過ls命令,應該顯示以下內容:
$ ls
Dockerfile app.py requirements.txt
現在運行構建命令。創建一個Docker鏡像,通過-t標記,從而使鏡像有一個友好的名字。
docker build -t friendlyhello .
你構建的鏡像在哪裡?在你的機器的本地Docker鏡像註冊庫「
$ docker image ls
REPOSITORY TAG IMAGE ID
friendlyhello latest 326387cea398
運行應用
運行應用程序,使用-p將機器的埠4000映射到容器的已發布埠80:
docker run -p 4000:80 friendlyhello
你應該在http://0.0.0.0:80看到一條消息,Python正在為你的應用程序提供服務。 但是該消息來自容器內部,它不知道將該容器的埠80映射到4000,
在瀏覽器中http://localhost:4000 可以查看網頁上顯示的顯示內容。
![](http://i1.wp.com/pic3.zhimg.com/50/v2-7cd884c984f6dcd84efd891d8a455a86_720w.webp)
你也可以通過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中的EXPOSE與使用docker run -p發布的內容之間的區別。 在後面的步驟中,我們只需將主機上的埠80映射到容器中的埠80並使用http:// localhost。
按CTRL+C結束進程。
現在可以讓應用程序在後端進程中運行,用detached 模式。
docker run -d -p 4000:80 friendlyhello
你可以獲取應用的容器ID,通過容器ID將應用程序停止。 容器正在後台運行。 可以使用docker container ls命令查看縮寫的容器ID:
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED
1fa4ab2cf395 friendlyhello "python app.py" 28 seconds ago
現在用docker containner stop 命令結束進程,需要用到 container id,如下:
docker container stop 1fa4ab2cf395
分享你的鏡像:
為了演示我們剛才創建的容器具有可移植性,我們上傳我們構建的映像並可以在其他的任何地方運行。 畢竟,當你想要將容器部署到生產環境時,弄需要知道如何推送註冊倉庫。
註冊倉庫是存儲庫的集合,而存儲庫是圖像的集合 - 有點像GitHub存儲庫,但代碼已經創建。 註冊倉庫上的帳戶可以創建許多存儲庫。 docker CLI默認使用Docker的公共註冊庫。
登錄dokcer Id
如果你還沒有Docker帳戶,請在網站http://cloud.docker.com註冊一個帳戶。 記下你的用戶名。
登錄到本地計算機上的Docker公共註冊庫。
$ docker login
標記鏡像
將本地映像與註冊庫中的存儲庫相關聯的命令是username / repository:tag。 該標籤是可選的,但建議使用,因為它是註冊管理機構用於為Docker鏡像提供版本的機制。 為該上下文提供存儲庫並標記有意義的名稱,例如get-started:part2。 這將圖像放入啟動存儲庫並將其標記為part2。
現在,把它放在一起來標記圖像。使用你的用戶名,存儲庫和標籤名稱運行碼頭標籤圖像,以便將圖像上傳到您想要的目的地。 該命令的語法是:
docker tag image username/repository:tag
比如:
docker tag friendlyhello john/get-started:part2
運行 docker image ls 命令去查看你的新的標記的鏡像。
$ docker image ls
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)
無論docker run在哪裡執行,它都會將你的鏡像以及Python和requirements.txt中的所有依賴關係一起提取出來,並運行你的代碼。 它們都在一個整潔的小包中,並且您不需要在主機上安裝任何Docker。
總結
這就是這個頁面的內容。 在下一節中,我們將學習如何通過在服務中運行此容器來擴展我們的應用程序。
命令複習
這裡列出了這個頁面的基本Docker命令,以及一些相關的命令,如果你想在繼續之前探索一下。
ocker build -t friendlyhello . # Create image using this directorys Dockerfile
docker run -p 4000:80 friendlyhello # Run "friendlyname" mapping port 4000 to 80
docker run -d -p 4000:80 friendlyhello # Same thing, but in detached mode
docker container ls # List all running containers
docker container ls -a # List all containers, even those not running
docker container stop <hash> # Gracefully stop the specified container
docker container kill <hash> # Force shutdown of the specified container
docker container rm <hash> # Remove specified container from this machine
docker container rm $(docker container ls -a -q) # Remove all containers
docker image ls -a # List all images on this machine
docker image rm <image id> # Remove specified image from this machine
docker image rm $(docker image ls -a -q) # Remove all images from this machine
docker login # Log in this CLI session using your Docker credentials
docker tag <image> username/repository:tag # Tag <image> for upload to registry
docker push username/repository:tag # Upload tagged image to registry
docker run username/repository:tag
推薦閱讀:
TAG:Docker |