- Notifications
You must be signed in to change notification settings - Fork1.7k
A Python library for the Docker Engine API
License
docker/docker-py
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
A Python library for the Docker Engine API. It lets you do anything thedocker command does, but from within Python apps – run containers, manage containers, manage Swarms, etc.
The latest stable versionis available on PyPI. Install with pip:
pip install dockerOlder versions (< 6.0) required installing
docker[tls]for SSL/TLS support.This is no longer necessary and is a no-op, but is supported for backwards compatibility.
Connect to Docker using the default socket or the configuration in your environment:
importdockerclient=docker.from_env()
You can run containers:
>>>client.containers.run("ubuntu:latest","echo hello world")'hello world\n'
You can run containers in the background:
>>>client.containers.run("bfirsh/reticulate-splines",detach=True)<Container'45e6d2de7c54'>
You can manage containers:
>>>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()
You can stream logs:
>>>forlineincontainer.logs(stream=True):...print(line.strip())Reticulatingspline2...Reticulatingspline3......
You can manage images:
>>>client.images.pull('nginx')<Image'nginx'>>>>client.images.list()[<Image'ubuntu'>,<Image'nginx'>, ...]
Read the full documentation to see everything you can do.
About
A Python library for the Docker Engine API
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.