Skip to main content

Client library for operating OpenStack clouds

Project description

Introduction

shade is a simple client library for operating OpenStack clouds. The key word here is simple. Clouds can do many many many things - but there are probably only about 10 of them that most people care about with any regularity. If you want to do complicated things, you should probably use the lower level client libraries - or even the REST API directly. However, if what you want is to be able to write an application that talks to clouds no matter what crazy choices the deployer has made in an attempt to be more hipster than their self-entitled narcissist peers, then shade is for you.

shade started its life as some code inside of ansible. ansible has a bunch of different OpenStack related modules, and there was a ton of duplicated code. Eventually, between refactoring that duplication into an internal library, and adding logic and features that the OpenStack Infra team had developed to run client applications at scale, it turned out that we’d written nine-tenths of what we’d need to have a standalone library.

Example

Sometimes an example is nice.

import shade

# Initialize and turn on debug logging
shade.simple_logging(debug=True)

# Initialize cloud
# Cloud configs are read with os-client-config
cloud = shade.openstack_cloud(cloud='mordred')

# Upload an image to the cloud
image = cloud.create_image(
    'ubuntu-trusty', filename='ubuntu-trusty.qcow2', wait=True)

# Find a flavor with at least 512M of RAM
flavor = cloud.get_flavor_by_ram(512)

# Boot a server, wait for it to boot, and then do whatever is needed
# to get a public ip for it.
cloud.create_server(
    'my-server', image=image, flavor=flavor, wait=True, auto_ip=True)

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

shade-1.4.0.tar.gz (133.0 kB view details)

Uploaded Source

Built Distribution

shade-1.4.0-py2-none-any.whl (169.1 kB view details)

Uploaded Python 2

File details

Details for the file shade-1.4.0.tar.gz.

File metadata

  • Download URL: shade-1.4.0.tar.gz
  • Upload date:
  • Size: 133.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for shade-1.4.0.tar.gz
Algorithm Hash digest
SHA256 ad94109d9f1379104cfeee9f7de0b16741b50f1d9c99fa662717861ca8ed1981
MD5 91c026a7c466d4ad0d4b0935378024e7
BLAKE2b-256 3e7e8b3773096dffdeffe1dea17f354488f0b3464bb133400d9cd150ee7699e7

See more details on using hashes here.

Provenance

File details

Details for the file shade-1.4.0-py2-none-any.whl.

File metadata

File hashes

Hashes for shade-1.4.0-py2-none-any.whl
Algorithm Hash digest
SHA256 8a7f1a38791bed6b7fb66e641c72ed54ee03c7b4bc9c4d6ab70b99130248205e
MD5 812b055f2275e4e24f8aa7c38c52c07a
BLAKE2b-256 d47c0a6ee074213f650b1c40cd721ed193bb77866cfe609b38231afe156481cf

See more details on using hashes here.

Provenance

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