kotovalexarian-likes-github/fog--fog
1
0
Fork 0
mirror of https://github.com/fog/fog.git synced 2022-11-09 13:51:43 -05:00
Code Releases Activity
fog--fog/lib/fog/rackspace/docs/getting_started.md
Kyle Rames e7e34cf764 Finished initial draft of Cloud Server docs
2013-01-21 15:10:43 -06:00

3.2 KiB
Raw Blame History

Getting Started with Fog and the Rackspace Open Cloud

This document will explain how to get started using Fog with the Rackspace Open Cloud.

Requirements

Fog is officially supports Ruby 1.9.3, 1.9.2, and 1.8.7 (Also known as Matz Ruby Interpreter or MRI). While not officially supported, fog has been known to work with Rubinus and JRuby.

Ruby 1.9.3 is suggested for new projects. For information on installing Ruby please refer to the Ruby download page.

Credentials

To obtain credentials for the US Rackspace Open Cloud, please sign up for an account at US Rackspace Open Cloud. Once an account is created, you can login to the Cloud Control Panel (US) and find your credentials by clicking on your username in the top right corner and then selecting API keys.

Likewise, you can create an account on our UK Rackspace Open Cloud by going to UK Rackspace Open Cloud and login into Cloud Control Panel (UK).

Installation

To install Fog via RubyGems run the following command:

$ gem install fog

To install Fog via Bundler add gem 'fog' to your Gemfile. This is a sample Gemfile to install Fog:

source :rubygems

gem 'fog'

After creating your Gemfile execute the following command to install the libraries:

bundle install

Bundler is the suggested method for new projects. For more information about bundler, please refer to the bundler documentation. For information on installing rubygems, please refer to rubygems download page.

Next Steps

Now that you have installed Fog and obtained your credentials, you are ready to begin exploring the capabilities of the Rackspace Open Cloud and Fog using irb.

Start by executing the following command:

irb

Once irb has launched you will need to require the Fog library.

If using Ruby 1.8.x execute the following command:

require 'rubygems'
require 'fog'

If using Ruby 1.9.x execute the following command:

require 'fog'

You should now be able to execute the following command to see a list of services Fog provides for the Rackspace Open Cloud:

Fog::Rackspace.services

These services can be explored in further depth in the following documents:

  • Next Gen Cloud Servers™ (compute_v2)
  • Cloud Files™ (storage)
  • Cloud Block Storage (block_storage)

Note: The compute service provides an interface to the First Gen Cloud Servers™ (compute). This service is deprecated. Users are encouraged to use Next Gen Cloud Servers™ (compute_v2).

Additional Resources

Support and Feedback

Your feedback is appreciated! If you have specific issues with the fog SDK, developers should file an issue via Github.

For general feedback and support requests, send an email to: sdk-support@rackspace.com.