Skip to main content

A Python library for the Docker Engine API.

Project description

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

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", "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:

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

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

docker-2.0.1.tar.gz (134.9 kB view details)

Uploaded Source

Built Distribution

docker-2.0.1-py2.py3-none-any.whl (95.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file docker-2.0.1.tar.gz.

File metadata

  • Download URL: docker-2.0.1.tar.gz
  • Upload date:
  • Size: 134.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for docker-2.0.1.tar.gz
Algorithm Hash digest
SHA256 0ef2cc73737bbfbc0d0f6434f4fc997475f25482749d36f91376caf459aeb557
MD5 4704026587f938bb4c11ed339d2b78a3
BLAKE2b-256 e908db81eb2529621af1007d5ac9edd7739c29b3508e06efaf6e75a3297c4d7f

See more details on using hashes here.

File details

Details for the file docker-2.0.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for docker-2.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 808c5adc29a1e92dd21583936cf72d72ecaab2a6b801a6a987884c86bd6ac412
MD5 7b4ebf453645d27e4b6db221e9dbee23
BLAKE2b-256 8e4c4a706d1e4ea09874cf226d6d8d2aea3c1e2570da08ee9de99b207b6df733

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page