萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 與 IPython 操作 Docker 實戰:docker-py 客戶端庫完整指南

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 啟動與連接 Docker

$ 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-py (v4+) API 變更

新版 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、ContainerError
  • TLS 認證:tls_config=docker.tls.TLSConfig(...) 連接遠端 Docker Daemon
  • 非同步:搭配 aiohttp 或 docker.aio 實現非阻塞操作
copyright © 萬盛學電腦網 all rights reserved