docker (original) (raw)

Project description

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. Install with pip:

pip install docker

Older 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.

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) <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.

Download files

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

Source Distribution

Built Distribution

File details

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

File metadata

File hashes

Hashes for docker-7.1.0.tar.gz | Algorithm | Hash digest | | | ----------- | ---------------------------------------------------------------- | | | SHA256 | ad8c70e6e3f8926cb8a92619b832b4ea5299e2831c14284663184e200546fa6c | | | MD5 | 04e92a7b6dc8b88dde3c7cca6850b277 | | | BLAKE2b-256 | 919b4a2ea29aeba62471211598dac5d96825bb49348fa07e906ea930394a83ce | |

See more details on using hashes here.

File details

Details for the file docker-7.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for docker-7.1.0-py3-none-any.whl | Algorithm | Hash digest | | | ----------- | ---------------------------------------------------------------- | | | SHA256 | c96b93b7f0a746f9e77d325bcfb87422a3d8bd4f03136ae8a85b37f1898d5fc0 | | | MD5 | f3c0c7aafc62932ceaab8e697f3ac4f1 | | | BLAKE2b-256 | e32657c6fb270950d476074c087527a558ccb6f4436657314bfb6cdf484114c4 | |

See more details on using hashes here.