Docker 程式化控制是雲原生開發核心技能。本文以 docker-py 官方客戶端庫為核心,在 IPython 互動環境中完整示範:鏡像管理、容器生命週期、日誌查看、網路/卷操作、事件監聽,並解析 docker.Client 核心 API 結構。
$ pip install docker-py # 注意:套件名為 docker-py,import 為 docker
$ sudo apt-get install ipython
$ sudo apt-get install docker.io
$ alias docker='docker.io'
$ docker pull busybox
$ ipython
In [1]: import docker
In [2]: c = docker.Client(base_url='unix://var/run/docker.sock', version='1.9', timeout=10)
IPython 技巧:輸入 c. 按 Tab 列出所有方法;c.images? 看文檔。
# 列出鏡像
In [6]: c.images(name="busybox")
Out[6]: [
{'Created': 1401402591, 'Id': '71e18d715071...', 'RepoTags': ['busybox:buildroot-2013.08.1'], 'VirtualSize': 2489301},
{'Created': 1401402590, 'Id': '1277aa3f93b3...', 'RepoTags': ['busybox:ubuntu-14.04'], 'VirtualSize': 5609404},
...
]
# 搜尋鏡像
c.search('ubuntu')
# 拉取鏡像
c.pull('ubuntu:14.04')
# 匯出/匯入
c.export(container_id)
c.import_image(open('image.tar'))
# 建立容器(指定啟動命令)
In [8]: c.create_container(image="busybox", command="env")
Out[8]: {'Id': '584459a09e6d...', 'Warnings': None}
# 啟動容器
In [9]: c.start(container="584459a09e6d...")
# 查看日誌
In [11]: c.logs(container="584459a09e6d...")
Out[11]: 'HOME=/\nPATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\nHOSTNAME=584459a09e6d\n'
# 停止/重啟/移除
c.stop(container=id)
c.restart(container=id)
c.remove_container(container=id)
# 等待結束並取得退出碼
c.wait(container=id)
# 詳細資訊
c.inspect_container(container_id)
# 進程列表
c.top(container_id)
# 執行額外命令(exec)
c.exec_create(container_id, ['ls', '/'])
exec_id = _['Id']
c.exec_start(exec_id)
# 即時事件流
for event in c.events():
print(event)
# 從 Dockerfile 建構
for chunk in c.build(path='.', tag='myapp:latest', rm=True):
print(chunk)
# 從容器提交新鏡像
c.commit(container='id', repository='myimage', tag='v1')
新版 docker 套件(pip install docker)採用 DockerClient:
import docker
client = docker.from_env() # 自動偵測環境變數
# 高階物件導向 API
container = client.containers.run('busybox', 'env', detach=True)
print(container.logs())
container.stop()
container.remove()
# 鏡像操作
client.images.pull('ubuntu:20.04')
for img in client.images.list():
print(img.tags)
docker.APIClient 底層使用 requests.adapters.HTTPAdapter 連線池docker.errors.APIError、NotFound、ContainerErrortls_config=docker.tls.TLSConfig(...) 連接遠端 Docker Daemonaiohttp 或 docker.aio 實現非阻塞操作