bookofnova 0.007

Access Openstack Nova Compute via Python

General Overview

This is a VERY Simple library which I have found useful in projects where I needed access to the Openstack NOVA Compute API and I did not want to bother with novaclient.

NOTICE:

If you had installed a previous version of “the book of nova” then you will need to retool the application when it comes to authentication and logging. By Default the application now uses the standard Python Logging Module, and will print out all of the logging information to the console as you access the library. If you want to log to a file simply change the “log_file” variable when you load in “computelib.NovaCommands” class. The “log_file” variable will attempt to place the log file in “/var/log” if you are running with elevated privileges, otherwise the log file will be in the users working directory. You may also change the log level for more/less output by changing the “log_level” variable. Lastly, if you have a log handler setup you can override the default logger entirely by simple using the “output” variable. To use the output variable you will need to pre-set the some logging facility which supports [error, info, debug].

Functions of the Library :

• Do Openstack Nova Things
• Presently only supports Openstack Nova Compute, but does so for both Vanilla Openstack and the Rackspace Open Cloud
• Not all of the functions are built-in however the library is extendable and I would be happy to add things in as needed / requested.

Prerequisites :

• Python => 2.6 but < 3.0

Installation is simple :

git clone git://github.com/cloudnull/bookofnova.git
cd bookofnova
python setup.py install

Now in your application Import bookofnova and go forth and Access Openstack Nova.

Application Usage

Here is some Basic Usage :

# Everything in this dictionary is a string, fill in the needed values.
m_args = {"os_user": 'YOURUSERNAME',
          "os_apikey": 'RANDOMNUMBERSANDTHINGS',
          "os_auth_url": None,
          "os_rax_auth": 'ALOCATION',
          "os_verbose": None,
          "os_password": None,
          "os_tenant": None,
          "os_region": None,
          "os_version": 'v2.0'}

from bookofnova import computelib, connections
# Tell the book of Nova that you are ready
nova = computelib.NovaCommands(m_args=m_args,
                               log_file=None,
                               log_level='info',
                               output=None)

# Authenticate Against the Nova API
nova.auth()

# Using Nova to show a list of all Instances
servers = nova.server_list()
print(servers)

# now everything that you ever wanted to know from a Openstack Nova
# query can be found in your dictionary under the key 'nova_resp'

Get Social

• Downloadable on PyPi
• Downloadable on GitHub
• See My GitHub Issues Page for any and all Issues or Feature requests

See https://github.com/cloudnull/bookofnova/issues for Issues or Feature requests

License

Copyright [2013] [Kevin Carter]

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.