Skip to main content

UNKNOWN

Project description

This package provides Python bindings for [Orchard], letting you manage Docker hosts for a particular account and interact with an individual host using [docker-py].

Install

`bash $ pip install orchard `

Authenticating

The orchard package provides two methods for instantiating an API client:

`python >>> import orchard >>> orchard.with_token(my_token) <orchard.client.Client object at 0x101de0d10> >>> orchard.with_username_and_password(my_username, my_password) <orchard.client.Client object at 0x102244e10> `

Managing hosts

Once you’ve instaniated a Client object, the hosts property lets you list, create and delete hosts:

`python >>> client.hosts [<Host: default>, <Host: host2>] >>> client.hosts[0] <Host: default> >>> client.hosts["host2"] <Host: host2> >>> host3 = client.hosts.create({"name": "host3"}) >>> host3 <Host: host3> >>> host3.delete() `

Interacting with Docker

To get a [docker-py] instance for a host, call host.docker():

`python >>> docker = client.hosts["default"].docker() >>> docker.containers() [] >>> c = docker.create_container("ubuntu", "date") >>> docker.start(c['Id']) >>> docker.wait(c['Id']) 0 >>> docker.logs(c['Id']) 'Mon Oct 28 15:42:56 UTC 2013\n' >>> docker.remove_container(c['Id']) `

See the [docker-py] README for a full list of methods.

[Orchard]: https://www.orchardup.com [docker-py]: https://github.com/dotcloud/docker-py [CLI docs]: https://www.orchardup.com/docs/cli [Orchard API docs]: https://www.orchardup.com/docs/api

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

orchard-2.0.1.tar.gz (15.8 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for orchard-2.0.1.tar.gz
Algorithm Hash digest
SHA256 1878da3e1f189c4f2f2f179117008d8cecac155c164da4e6f9ba98cfe76b08de
MD5 d013a14255387800c776056e106089e7
BLAKE2b-256 0560014df76f670aab69728bdcccbd634ed46daca62fb937e349614d450c4cda

See more details on using hashes here.

Supported by

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