docker-py

by docker

docker / docker-py

A Python library for the Docker Engine API

5.0K Stars 1.4K Forks Last release: 2 months ago (4.3.1) Apache License 2.0 3.1K Commits 107 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Docker SDK for Python

Build Status

A Python library for the Docker Engine API. It lets you do anything the

docker
command does, but from within Python apps – run containers, manage containers, manage Swarms, etc.

Installation

The latest stable version is available on PyPI. Either add

docker
to your
requirements.txt
file or install with pip:
pip install docker

If you are intending to connect to a docker host via TLS, add

docker[tls]
to your requirements instead, or install with pip:
pip install docker[tls]

Usage

Connect to Docker using the default socket or the configuration in your environment:

import docker
client = 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)

You can manage containers:

>>> client.containers.list()
[, , ...]

>>> container = client.containers.get('45e6d2de7c54')

>>> container.attrs['Config']['Image'] "bfirsh/reticulate-splines"

>>> container.logs() "Reticulating spline 1...\n"

>>> container.stop()

You can stream logs:

>>> for line in container.logs(stream=True):
...   print line.strip()
Reticulating spline 2...
Reticulating spline 3...
...

You can manage images:

>>> client.images.pull('nginx')


>>> client.images.list() [, , ...]

Read the full documentation to see everything you can do.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.