用Python和Conu測試容器
越來越多的開發(fā)人員使用容器開發(fā)和部署他們的應(yīng)用。這意味著可以輕松地測試容器也變得很重要。Conu (container utilities 的簡寫) 是一個 Python 庫,讓你編寫容器測試變得簡單。本文向你介紹如何使用它測試容器。
開始吧
首先,你需要一個容器程序來測試。為此,以下命令創(chuàng)建一個包含一個容器的 Dockerfile 和一個被容器伺服的 Flask 應(yīng)用程序的文件夾。
$ mkdir container_test
$ cd container_test
$ touch Dockerfile
$ touch app.py
將以下代碼復(fù)制到 app.py
文件中。這是慣常的基本 Flask 應(yīng)用,它返回字符串 “Hello Container World!”。
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'Hello Container World!'
if __name__ == '__main__':
app.run(debug=True,host='0.0.0.0')
創(chuàng)建和構(gòu)建測試容器
為了構(gòu)建測試容器,將以下指令添加到 Dockerfile。
FROM registry.fedoraproject.org/fedora-minimal:latest
RUN microdnf -y install python3-flask && microdnf clean all
ADD ./app.py /srv
CMD ["python3", "/srv/app.py"]
然后使用 Docker CLI 工具構(gòu)建容器。
$ sudo dnf -y install docker
$ sudo systemctl start docker
$ sudo docker build . -t flaskapp_container
提示:只有在系統(tǒng)上未安裝 Docker 時才需要前兩個命令。
構(gòu)建之后使用以下命令運行容器。
$ sudo docker run -p 5000:5000 --rm flaskapp_container
* Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 473-505-51
***,使用 curl
檢查 Flask 應(yīng)用程序是否在容器內(nèi)正確運行:
$ curl http://127.0.0.1:5000
Hello Container World!
現(xiàn)在,flaskapp_container 正在運行并準(zhǔn)備好進(jìn)行測試,你可以使用 Ctrl+C
將其停止。
創(chuàng)建測試腳本
在編寫測試腳本之前,必須安裝 conu
。在先前創(chuàng)建的 container_test
目錄中,運行以下命令。
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv)$ pip install --upgrade pip
(.venv)$ pip install conu
$ touch test_container.py
然后將以下腳本復(fù)制并保存在 test_container.py
文件中。
import conu
PORT = 5000
with conu.DockerBackend() as backend:
image = backend.ImageClass("flaskapp_container")
options = ["-p", "5000:5000"]
container = image.run_via_binary(additional_opts=options)
try:
# Check that the container is running and wait for the flask application to start.
assert container.is_running()
container.wait_for_port(PORT)
# Run a GET request on / port 5000.
http_response = container.http_request(path="/", port=PORT)
# Check the response status code is 200
assert http_response.ok
# Get the response content
response_content = http_response.content.decode("utf-8")
# Check that the "Hello Container World!" string is served.
assert "Hello Container World!" in response_content
# Get the logs from the container
logs = [line for line in container.logs()]
# Check the the Flask application saw the GET request.
assert b'"GET / HTTP/1.1" 200 -' in logs[-1]
finally:
container.stop()
container.delete()
測試設(shè)置
這個腳本首先設(shè)置 conu
使用 Docker 作為后端來運行容器。然后它設(shè)置容器鏡像以使用你在本教程***部分中構(gòu)建的 flaskapp_container。
下一步是配置運行容器所需的選項。在此示例中,F(xiàn)lask 應(yīng)用在端口5000上提供內(nèi)容。于是你需要暴露此端口并將其映射到主機(jī)上的同一端口。
***,用這個腳本啟動容器,現(xiàn)在可以測試了。
測試方法
在測試容器之前,檢查容器是否正在運行并準(zhǔn)備就緒。示范腳本使用 container.is_running
和 container.wait_for_port
。這些方法可確保容器正在運行,并且服務(wù)在預(yù)設(shè)端口上可用。
container.http_request
是 request 庫的包裝器,可以方便地在測試期間發(fā)送 HTTP 請求。這個方法返回requests.Responseobject,因此可以輕松地訪問響應(yīng)的內(nèi)容以進(jìn)行測試。
conu
還可以訪問容器日志。又一次,這在測試期間非常有用。在上面的示例中,container.logs
方法返回容器日志。你可以使用它們斷言打印了特定日志,或者,例如在測試期間沒有異常被引發(fā)。
conu
提供了許多與容器接合的有用方法。文檔中提供了完整的 API 列表。你還可以參考 GitHub 上提供的示例。
運行本教程所需的所有代碼和文件也可以在 GitHub 上獲得。 對于想要進(jìn)一步采用這個例子的讀者,你可以看看使用 pytest 來運行測試并構(gòu)建一個容器測試套件。