The HP Cloud uses OpenStack as the platform and you can connect and set up your HP Cloud using Ruby Fog. To begin, connect using the following instructions:
To connect to the HP Cloud, follow these steps:
Enter IRB
irb
Require the Fog library and Rubygems:
require 'rubygems' require 'fog'
Note: If the require 'rubygems'
command returns a value of false
, enter IRB with the following
command:
irb -r 'rubygems'
Establish a connection to the desired HP Cloud service
conn = Fog::<SERVICE-NAME>.new( :provider => "HP", :hp_access_key => "<your_ACCESS_KEY>", :hp_secret_key => "<your_SECRET_KEY>", :hp_auth_uri => "<IDENTITY_ENDPOINT_URL>", :hp_tenant_id => "<your_TENANT_ID>", :hp_avl_zone => "<your_AVAILABILITY_ZONE>", <other optional parameters> )
Where SERVICE-NAME
can be Compute,
Storage,
CDN
or other services. Please surf on over to the Block
Storage for the details on how to connect to that service.
Note: You must use the :hp_access_key
parameter rather than the now-deprecated :hp_account_id
parameter you might have used in previous versions of the HP Cloud Services Extensions to Ruby Fog.
You can find the values the access key, secret key, and other values by clicking the API Keys button in the Console Dashboard.
You cannot specify an availability zone if you have not activated it. To
activate an availability zone, go to the Management Console dashboard and
click the **Activate
** button. You are required to set an
availability zone to establish a connection; there is no default
availability zone value.
The current usable availability zones for the compute service:
az-1.region-a.geo-1
az-2.region-a.geo-1
az-3.region-a.geo-1
The current usable availability zones for the storage service:
region-a.geo-1
region-b.geo-1
The current usable availability zones for the CDN:
region-a.geo-1
region-b.geo-1
The current usable availability zones for the block storage service:
az-1.region-a.geo-1
az-2.region-a.geo-1
az-3.region-a.geo-1
This section describes the optional parameters that you can use when connecting to any of the HP Cloud services. The examples below show the Compute service, but these optional parameters work with all of the HP Cloud services.
The user_agent
parameter allows you to specify a string to
pass as a user_agent
header for the connection. You can use
this to track the caller of the operations. You can set the
user_agent
parameter as follows:
conn = Fog::Compute.new( ... ... :user_agent => "MyApp/x.x.x")
This inserts a user_agent
string such as hpfog/x.x.x
(MyApp/x.x.x)
into the header.
In addition to the user_agent
parameter, there are several
additional parameters you can set using the connection_options
parameter. These options are provided by the Excon library and allow you to modify the
underlying connection to a service. These options are Instrumentation, Timeouts, Proxy, and HTTPS/SSL.
Use this parameter for debugging purposes. When you use the default
instrumentor Excon::StandardInstrumentor
, all events are
output to stderr
. You can also designate your own
instrumentor. You can set the default instrumentor as follows:
conn = Fog::Compute.new( ... ... :connection_options => {:instrumentor => Excon::StandardInstrumentor})
For convenience of debugging HTTP requests, we have created a custom
instrumentor Excon::SimpleHttpInstrumentor
. This instrumentor
shows the HTTP calls in afashion which is similar to a curl
output. You can set the custom SimpleHttpInstrumentor
as
follows:
conn = Fog::Compute.new( ... ... :connection_options => {:instrumentor => Excon::SimpleHttpInstrumentor, :instrumentor_name => 'SimpleHttp'})
Use this parameter to set different timeout values. You can set the timeouts parameter as follows:
conn = Fog::Compute.new( ... ... :connection_options => { :connect_timeout => <time_in_secs>, :read_timeout => <time_in_secs>, :write_timeout => <time_in_secs>})
Use this parameter to specify a proxy URL for both HTTP and HTTPS connections. You can set the proxy parameter as follows:
conn = Fog::Compute.new( ... ... :connection_options => {:proxy => 'http://myproxyurl:4444'})
By default, peer certificates are verified when you use secure socket layer (SSL) for HTTPS. Sometimes this does not work due to configurations in different operating systems, causing connection errors. To help avoid this, you can set HTTPS/SSL parameters. To set the path to the certificates:
conn = Fog::Compute.new( ... ... :connection_options => {:ssl_ca_path => "/path/to/certs"})
To set the path to a certificate file:
conn = Fog::Compute.new( ... ... :connection_options => {:ssl_ca_file => "/path/to/certificate_file"})
To set turn off peer verification:
conn = Fog::Compute.new( ... ... :connection_options => {:ssl_verify_peer => false})
Note: This makes your connection less secure.
For further information on these options, please see the Excon documentation.
——— Documentation Home | Examples