Github: https://github.com/docker/docker-py
Docker SDK for Python
Docker Engine API用のPythonライブラリ。 これは、 docker
コマンドが行うことができますが、Pythonアプリケーション内から行うことができます – コンテナの実行、コンテナの管理、Swarmsの管理など
インストール
最新の安定バージョンはPyPI上で利用可能です 。 requirements.txt
ファイルにdocker
を追加するか、pipでインストールしてください:
pip install docker
TLS経由でドッカーホストに接続する場合は、必要に応じてdocker[tls]
を追加するか、pipでインストールしてください。
pip install docker[tls]
使用法
既定のソケットまたは環境内の構成を使用してDockerに接続します。
import docker
client = docker.from_env()
コンテナを実行できます:
>>> client.containers.run("ubuntu:latest", "echo hello world")
'hello world\n'
バックグラウンドでコンテナを実行できます:
>>> client.containers.run("bfirsh/reticulate-splines", detach=True)
<Container '45e6d2de7c54'>
コンテナを管理することができます:
>>> client.containers.list()
[<Container '45e6d2de7c54'>, <Container 'db18e4f20eaa'>, ...]
>>> container = client.containers.get('45e6d2de7c54')
>>> container.attrs['Config']['Image']
"bfirsh/reticulate-splines"
>>> container.logs()
"Reticulating spline 1...\n"
>>> container.stop()
あなたはログを流すことができます:
>>> for line in container.logs(stream=True):
... print line.strip()
Reticulating spline 2...
Reticulating spline 3...
...
画像を管理することができます:
>>> client.images.pull('nginx')
<Image 'nginx'>
>>> client.images.list()
[<Image 'ubuntu'>, <Image 'nginx'>, ...]