| Summary: | New package python-cloudservers in CloudForms 1.0 | ||
|---|---|---|---|
| Product: | [Retired] CloudForms Cloud Engine | Reporter: | John Eckersberg <jeckersb> |
| Component: | python-cloudservers | Assignee: | John Eckersberg <jeckersb> |
| Status: | CLOSED ERRATA | QA Contact: | Martin Kočí <mkoci> |
| Severity: | medium | Docs Contact: | |
| Priority: | medium | ||
| Version: | 1.0.0 | CC: | redakkan |
| Target Milestone: | rc | ||
| Target Release: | --- | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2012-05-15 19:10:54 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
|
Description
John Eckersberg
2012-03-07 14:21:20 UTC
yum info python-cloudservers Loaded plugins: product-id, security, subscription-manager Updating certificate-based repositories. Installed Packages Name : python-cloudservers Arch : noarch Version : 1.2 Release : 2.el6 Size : 119 k Repo : installed From repo : aeolus-brew-nightly Summary : Client library for Rackspace's Cloud Servers API URL : http://packages.python.org/python-cloudservers License : BSD Description : Python bindings to the Rackspace Cloud Servers API : ================================================== : : This is a client for Rackspace's Cloud Servers API. There's a Python API (the ``cloudservers`` module), and a command-line script (``cloudservers``).Each implements 100% of the Rackspace API. : : `Full documentation is available`__. : : __ http://packages.python.org/python-cloudservers/ : : You'll also probably want to read `Rackspace's API guide`__ (PDF) -- the first bit, at least -- to get an idea of the concepts. Rackspace is doing the cloud hosting thing a bit differently from Amazon, and if you get the concepts this library should make more sense. : : __ http://docs.rackspacecloud.com/servers/api/cs-devguide- latest.pdf : : Development takes place on GitHub__. Bug reports andpatches may be filed there. : : __ http://github.com/jacobian/python-cloudservers : : .. contents:: Contents: : :local: : : Command-line API : ---------------- : : Installing this package gets you a shell command, ``cloudservers``, that you : can use to interact with Rackspace. : : You'll need to provide your Rackspace username and API key. You can do this with the ``--username`` and ``--apikey`` params, but it's easier to just set them as environment variables:: : : export CLOUD_SERVERS_USERNAME=jacobian : export CLOUD_SERVERS_API_KEY=yadayada : : You'll find complete documentation on the shell by running : ``cloudservers help``:: : : usage: cloudservers [--username USERNAME] [--apikey APIKEY] <subcommand> ... : : Command-line interface to the Cloud Servers API. : : Positional arguments: : <subcommand> : backup-schedule Show or edit the backup schedule for a server. : backup-schedule-delete : Delete the backup schedule for a server. : boot Boot a new server. : delete Immediately shut down and delete a server. : flavor-list Print a list of available 'flavors' (sizes of servers). : help Display help about this program or one of its subcommands. : image-create Create a new image by taking a snapshot of a running server. : image-delete Delete an image. : image-list Print a list of available images to boot from. : ip-share Share an IP address from the given IP group onto a server. : ip-unshare Stop sharing an given address with a server. : ipgroup-create Create a new IP group. : ipgroup-delete Delete an IP group. : ipgroup-list Show IP groups. : ipgroup-show Show details about a particular IP group. : list List active servers. : reboot Reboot a server. : rebuild Shutdown, re-image, and re-boot a server. : rename Rename a server. : resize Resize a server. : resize-confirm Confirm a previous resize. : resize-revert Revert a previous resize (and return to the previous VM). : root-password Change the root password for a server. : show Show details about the given server. : : Optional arguments: : --username USERNAME Defaults to env[CLOUD_SERVERS_USERNAME]. : --apikey APIKEY Defaults to env[CLOUD_SERVERS_API_KEY]. : : See "cloudservers help COMMAND" for help on a specific command. : : Python API : ---------- : : There's also a `complete Python API`__. : : __ http://packages.python.org/python-cloudservers/ : : By way of a quick-start:: : : >>> import cloudservers : >>> cs = cloudservers.CloudServers(USERNAME, API_KEY) : >>> cs.flavors.list() : [...] : >>> cs.servers.list() : [...] : >>> s = cs.servers.create(image=2, flavor=1, name='myserver') : : ... time passes ... : : >>> s.reboot() : : ... time passes ... : : >>> s.delete() : : FAQ : --- : : What's wrong with libcloud? : : Nothing! However, as a cross-service binding it's by definition lowest common denominator; I needed access to the Rackspace-specific APIs (shared IP groups, image snapshots, resizing, etc.). I also wanted a command-line utility. : : What's new? : ----------- : : New in ``python-cloudservers`` 1.2 : ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ : : * Support for Python 2.4 - 2.7. : * Improved output of ``ipgroup-list``. : * Made ``boot --ipgroup <name>`` work (as well as ``--ipgroup <id>``). : : New in ``python-cloudservers`` 1.1 : ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ : : * Added support for uploading files to the shell ``boot`` command (via the``--files`` flag). : * Added a shortcut ``--key`` for quickly adding an SSH key on boot. : * Changed the default server image for the ``boot`` shell command to Ubuntu 10.04. ======================================================== Repo Used : http://download.lab.bos.redhat.com/rel-eng/CloudForms/1.0/2012-03-12.1/el6-ce/ =================================================================== rpm -qa|grep aeolus aeolus-conductor-doc-0.8.0-41.el6.noarch rubygem-aeolus-cli-0.3.0-13.el6.noarch aeolus-all-0.8.0-41.el6.noarch aeolus-conductor-0.8.0-41.el6.noarch rubygem-aeolus-image-0.3.0-12.el6.noarch aeolus-configure-2.5.0-18.el6.noarch aeolus-conductor-daemons-0.8.0-41.el6.noarch rpm -qa| grep python-cloudservers python-cloudservers-1.2-2.el6.noarch Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHEA-2012-0652.html |