PythonSDK for Docker¶
一个Docker引擎API的Python库。它可以让你做任何事情docker
命令可以,但可以从Python应用程序内部-运行容器、管理容器、管理群集等。
有关引擎API的详细信息,请参见请参阅其文档.
快速入门¶
要与Docker守护进程对话,您首先需要实例化一个客户端。您可以使用from_env()
要使用环境中的默认套接字或配置进行连接,请执行以下操作:
import docker
client = docker.from_env()
现在您可以运行容器:
>>> client.containers.run("ubuntu", "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'>, ...]
这只是您使用PythonSDK for PythonSDK可以做的事情的初步体验。如需更多信息,请看一下参考资料.