2011-08-29 19:01:48 +00:00
|
|
|
= HP Cloud Extensions to Ruby Fog Library
|
|
|
|
|
|
2012-04-16 21:17:52 +00:00
|
|
|
HP contributed to the native Ruby library Fog, through an HP Cloud developed extension to Fog via
|
|
|
|
|
the Object Storage, Compute and CDN providers. By using the HP Cloud Extensions to Fog, developers
|
|
|
|
|
can write applications using Ruby that interacts with the HP Cloud Services without having to deal
|
|
|
|
|
with the underlying REST API or JSON/XML document formats.
|
2011-08-29 19:01:48 +00:00
|
|
|
|
|
|
|
|
== Background
|
|
|
|
|
|
2011-12-15 17:53:38 +00:00
|
|
|
This library is an extension of Fog[https://github.com/fog/fog], a Ruby open-source cloud
|
2012-04-16 21:17:52 +00:00
|
|
|
computing library. The code in this library, contains all HP-specific support and is being
|
|
|
|
|
contributed back to the primary open-source library.
|
2011-08-29 19:01:48 +00:00
|
|
|
|
2012-04-16 21:17:52 +00:00
|
|
|
The HP Cloud Ruby library currently supports HP Cloud Object Storage, Compute, CDN, and
|
2011-08-29 19:01:48 +00:00
|
|
|
support for other services will be added as available.
|
|
|
|
|
|
|
|
|
|
== Installation
|
|
|
|
|
|
2012-04-16 21:17:52 +00:00
|
|
|
sudo gem install fog
|
2011-08-29 19:01:48 +00:00
|
|
|
|
|
|
|
|
That's it! Try out the usage examples explained below to confirm your installation.
|
|
|
|
|
|
|
|
|
|
If you should ever need to remove the library:
|
|
|
|
|
|
2012-04-16 21:17:52 +00:00
|
|
|
sudo gem uninstall fog
|
2011-08-29 19:01:48 +00:00
|
|
|
|
|
|
|
|
== Usage
|
|
|
|
|
|
2012-04-16 21:17:52 +00:00
|
|
|
The Ruby Fog library is well documented on the community web site at {fog.io}[http://fog.io], but for specific examples
|
2011-08-29 19:01:48 +00:00
|
|
|
using HP's extensions, see:
|
|
|
|
|
|
2013-01-18 20:06:41 +00:00
|
|
|
* {HP Cloud Fog library - Object Storage Examples}[https://docs.hpcloud.com/bindings/fog/object-storage]
|
|
|
|
|
* {HP Cloud Fog library - Compute Examples}[https://docs.hpcloud.com/bindings/fog/compute]
|
|
|
|
|
* {HP Cloud Fog library - CDN Examples}[https://docs.hpcloud.com/bindings/fog/cdn]
|
|
|
|
|
* {HP Cloud Fog library - Block Storage Examples}[https://docs.hpcloud.com/bindings/fog/block-storage]
|
|
|
|
|
|
|
|
|
|
Having trouble? Get help over at the {Forums}[https://community.hpcloud.com/forum] or
|
|
|
|
|
at the {Knowledge Base}[https://community.hpcloud.com/knowledge-base] areas.
|
2012-04-16 21:17:52 +00:00
|
|
|
|
2011-08-29 19:01:48 +00:00
|
|
|
|
2012-04-16 21:17:52 +00:00
|
|
|
== Notice
|
2012-02-03 18:16:07 +00:00
|
|
|
|
|
|
|
|
The following notice applies to files included in the /lib/fog/hp directory and its sub-directories.
|
2012-02-02 16:49:28 +00:00
|
|
|
|
|
|
|
|
Copyright (c) 2011 Hewlett-Packard Development Company, L.P.
|
|
|
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software
|
|
|
|
|
and associated documentation files (the "Software"), to deal in the Software without restriction,
|
|
|
|
|
including without limitation the rights to use, copy, modify, merge, publish, distribute,
|
|
|
|
|
sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
|
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in all copies or
|
|
|
|
|
substantial portions of the Software.
|
2011-08-29 19:01:48 +00:00
|
|
|
|
2012-02-02 16:49:28 +00:00
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
|
|
|
|
|
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
|
|
|
|
|
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
|
|
|
|
|
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
|
|
|
|
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
2011-06-15 06:10:54 +00:00
|
|
|
DEALINGS IN THE SOFTWARE.
|
