Basic OpenStack client library using asyncio
Project description
AsyncOpenStackClient
Introduction
The AsyncOpenStackClient is a rest wrapper for the OpenStack API. It provides very raw functionality; however, it has a nice abstraction for authentication. For method specification, see the official OpenStack documentation: https://docs.openstack.org/queens/api/.
Installation
Use pip:
pip install AsyncOpenStackClient
Usage
As mentioned above, this is a “raw” library, so you must handle params and/or body and the response.
from asyncopenstackclient import NovaClient, GlanceClient, AuthPassword
# you can either pass credentials explicitly (as shown below)
# or use enviormental variables from OpenStack RC file
# https://docs.openstack.org/mitaka/cli-reference/common/cli_set_environment_variables_using_openstack_rc.html
auth = AuthPassword(
auth_url='https://keystone:5999/v3'
username='USER', password='PASS',
project_name='my-project',
user_domain_name='default',
project_domain_name='foo.bar'
)
nova = NovaClient(session=auth)
glance = GlanceClient(session=auth)
# api url for each service will be taken from catalog,
# but you may pass `api_url` param to force custom url eg.
# nova = NovaClient(session=auth, api_url='http://my-local-nova:9876/v2/')
await nova.init_api()
await glance.init_api()
servers = await nova.api.servers.list(params={'name': 'testvm'})
vm = await nova.api.servers.get(id)
body = {
"server": {
"name": 'some_name',
"flavorRef": 'flavor_id',
"imageRef": 'image_id',
"security_groups": [{'name': 'group1'}, {'name': 'group2'}]
"user_data": base64.b64encode(userdata).decode('utf-8')
}
}
response = await nova.api.servers.create(body=body)
print(response.body)
Available functions
Nova (https://developer.openstack.org/api-ref/compute)
servers.list(params) # params optional
servers.get(id)
servers.create(body)
servers.force_delete(id)
flavors.list()
metadata.get(server_id)
metadata.set(server_id)
metadata.get_item(server_id, item_name)
metadata.set_item(server_id, item_name)
Glance (https://developer.openstack.org/api-ref/image/v2/index.html)
images.list()
License
Changelog
0.5.1 (2018-04-29)
Bugfix: update README with metadata entry and envs notice
0.5.0 (2018-04-25)
Feature: partial support for server metadata usage
0.4.1 (2018-04-25)
Bugifx: invalid concat auth_url with urljoin
0.4.0 (2018-04-16)
Feature: use OS_ variables if present
0.3.0 (2018-04-13)
Feature: accept to pass api_url
Feature: determine api url if catalog provide incomplete one (eg. without version)
0.2.3 (2018-04-05)
Bugfix: do_not_await_sync_method
0.2.2 (2018-04-02)
Update simple-rest-client (fixed logging)
0.2.1 (2018-03-28)
fix tests, cov report, MANIFEST.in
0.1.1 (2018-03-02)
Update MANIFEST.in
0.1.0 (2018-02-15)
First approach to build async openstack client library for Python3
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file AsyncOpenStackClient-0.5.1.tar.gz
.
File metadata
- Download URL: AsyncOpenStackClient-0.5.1.tar.gz
- Upload date:
- Size: 19.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d63f84beffa66a6536910b6b718b1018f1877e18f3e1dae12628d3482ff51248 |
|
MD5 | 5a25e33425c078d7892d78646aca891d |
|
BLAKE2b-256 | ef0c27019e788c5f131d742d05082d6864111080140c534ea79d88c4bfcdd959 |