class Fog::Orchestration::OpenStack::Real
Attributes
Public Class Methods
# File lib/fog/openstack/orchestration.rb, line 130 def initialize(options={}) @openstack_auth_token = options[:openstack_auth_token] @auth_token = options[:openstack_auth_token] @openstack_identity_public_endpoint = options[:openstack_identity_endpoint] unless @auth_token missing_credentials = Array.new @openstack_api_key = options[:openstack_api_key] @openstack_username = options[:openstack_username] missing_credentials << :openstack_api_key unless @openstack_api_key missing_credentials << :openstack_username unless @openstack_username raise ArgumentError, "Missing required arguments: #{missing_credentials.join(', ')}" unless missing_credentials.empty? end @openstack_tenant = options[:openstack_tenant] @openstack_auth_uri = URI.parse(options[:openstack_auth_url]) @openstack_management_url = options[:openstack_management_url] @openstack_must_reauthenticate = false @openstack_service_type = options[:openstack_service_type] || ['orchestration'] @openstack_service_name = options[:openstack_service_name] @openstack_identity_service_type = options[:openstack_identity_service_type] || 'identity' @openstack_endpoint_type = options[:openstack_endpoint_type] || 'publicURL' @openstack_region = options[:openstack_region] @connection_options = options[:connection_options] || {} @current_user = options[:current_user] @current_tenant = options[:current_tenant] authenticate @persistent = options[:persistent] || false @connection = Fog::Core::Connection.new("#{@scheme}://#{@host}:#{@port}", @persistent, @connection_options) end
Public Instance Methods
# File lib/fog/openstack/requests/orchestration/abandon_stack.rb, line 5 def abandon_stack(stack) request( :expects => [200], :method => 'DELETE', :path => "stacks/#{stack.stack_name}/#{stack.id}/abandon" ) end
# File lib/fog/openstack/requests/orchestration/build_info.rb, line 5 def build_info request( :expects => [200], :method => 'GET', :path => 'build_info' ) end
Create a stack.
-
options [Hash]:
-
:stack_name [String] Name of the stack to create.
-
:template [String] Structure containing the template body.
or (one of the two Template parameters is required)
-
:template_url [String] URL of file containing the template body.
-
:disable_rollback [Boolean] Controls rollback on stack creation failure, defaults to false.
-
:parameters [Hash] Hash of providers to supply to template
-
:timeout_mins [Integer] Minutes to wait before status is set to CREATE_FAILED
-
@see developer.openstack.org/api-ref-orchestration-v1.html
# File lib/fog/openstack/requests/orchestration/create_stack.rb, line 19 def create_stack(arg1, arg2 = nil) if arg1.is_a?(Hash) # Normal use: create_stack(options) options = arg1 else # Deprecated: create_stack(stack_name, options = {}) Fog::Logger.deprecation("#create_stack(stack_name, options) is deprecated, use #create_stack(options) instead [light_black](#{caller.first})[/]") options = { :stack_name => arg1 }.merge(arg2.nil? ? {} : arg2) end request( :expects => 201, :path => 'stacks', :method => 'POST', :body => Fog::JSON.encode(options) ) end
# File lib/fog/openstack/orchestration.rb, line 166 def credentials { :provider => 'openstack', :openstack_auth_url => @openstack_auth_uri.to_s, :openstack_auth_token => @auth_token, :openstack_management_url => @openstack_management_url, :openstack_identity_endpoint => @openstack_identity_public_endpoint, :openstack_region => @openstack_region, :current_user => @current_user, :current_tenant => @current_tenant } end
Delete a stack.
@param [Stack] Stack to be deleted
@return [Excon::Response]
@see developer.openstack.org/api-ref-orchestration-v1.html
# File lib/fog/openstack/requests/orchestration/delete_stack.rb, line 13 def delete_stack(arg1, arg2 = nil) if arg1.is_a?(Stack) # Normal use: delete_stack(stack) stack = arg1 stack_name = stack.stack_name stack_id = stack.id else # Deprecated: delete_stack(stack_name, stack_id) Fog::Logger.deprecation("#delete_stack(stack_name, stack_id) is deprecated, use #delete_stack(stack) instead [light_black](#{caller.first})[/]") stack_name = arg1 stack_id = arg2 end request( :expects => 204, :path => "stacks/#{stack_name}/#{stack_id}", :method => 'DELETE' ) end
# File lib/fog/openstack/requests/orchestration/get_stack_template.rb, line 5 def get_stack_template(stack) request( :method => 'GET', :path => "stacks/#{stack.stack_name}/#{stack.id}/template", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/list_resource_events.rb, line 5 def list_resource_events(stack, resource, options={}) uri = "stacks/#{stack.stack_name}/#{stack.id}/resources/#{resource.resource_name}/events" request(:method => 'GET', :path => uri, :expects => 200, :query => options) end
# File lib/fog/openstack/requests/orchestration/list_resource_types.rb, line 5 def list_resource_types request( :method => 'GET', :path => "resource_types", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/list_resources.rb, line 5 def list_resources(stack, options={}) uri = "stacks/#{stack.stack_name}/#{stack.id}/resources" request(:method => 'GET', :path => uri, :expects => 200, :query => options) end
# File lib/fog/openstack/requests/orchestration/list_stack_data.rb, line 5 def list_stack_data(options={}) request( :method => 'GET', :path => 'stacks', :expects => 200, :query => options ) end
# File lib/fog/openstack/requests/orchestration/list_stack_events.rb, line 5 def list_stack_events(stack, options={}) uri = "stacks/#{stack.stack_name}/#{stack.id}/events" request(:method => 'GET', :path => uri, :expects => 200, :query => options ) end
# File lib/fog/openstack/requests/orchestration/preview_stack.rb, line 5 def preview_stack(options = {}) request( :body => Fog::JSON.encode(options), :expects => [200], :method => 'POST', :path => 'stacks/preview' ) end
# File lib/fog/openstack/orchestration.rb, line 177 def reload @connection.reset end
# File lib/fog/openstack/orchestration.rb, line 181 def request(params) begin response = @connection.request(params.merge({ :headers => { 'Content-Type' => 'application/json', 'Accept' => 'application/json', 'X-Auth-Token' => @auth_token, 'X-Auth-User' => @openstack_username, 'X-Auth-Key' => @openstack_api_key }.merge!(params[:headers] || {}), :path => "#{@path}/#{@tenant_id}/#{params[:path]}", :query => params[:query] })) rescue Excon::Errors::Unauthorized => error if error.response.body != 'Bad username or password' # token expiration @openstack_must_reauthenticate = true authenticate retry else # Bad Credentials raise error end rescue Excon::Errors::HTTPStatusError => error raise case error when Excon::Errors::NotFound Fog::Compute::OpenStack::NotFound.slurp(error) else error end end if !response.body.empty? and response.get_header('Content-Type') =~ /application\/json/ then response.body = Fog::JSON.decode(response.body) end response end
# File lib/fog/openstack/requests/orchestration/show_event_details.rb, line 5 def show_event_details(stack, resource, event_id) request( :method => 'GET', :path => "stacks/#{stack.stack_name}/#{stack.id}/resources/#{resource.resource_name}/events/#{event_id}", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/show_resource_data.rb, line 5 def show_resource_data(stack_name, stack_id, resource_name) request( :method => 'GET', :path => "stacks/#{stack_name}/#{stack_id}/resources/#{resource_name}", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/show_resource_metadata.rb, line 5 def show_resource_metadata(stack, resource_name) request( :method => 'GET', :path => "stacks/#{stack.stack_name}/#{stack.id}/resources/#{resource_name}/metadata", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/show_resource_schema.rb, line 5 def show_resource_schema(name) request( :method => 'GET', :path => "resource_types/#{name}", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/show_resource_template.rb, line 5 def show_resource_template(name) request( :method => 'GET', :path => "resource_types/#{name}/template", :expects => 200 ) end
# File lib/fog/openstack/requests/orchestration/show_stack_details.rb, line 5 def show_stack_details(name, id) request( :method => 'GET', :path => "stacks/#{name}/#{id}", :expects => 200 ) end
Update a stack.
@param [Fog::Orchestration::OpenStack::Stack] the stack to update. @param [Hash] options
* :template [String] Structure containing the template body. or (one of the two Template parameters is required) * :template_url [String] URL of file containing the template body. * :parameters [Hash] Hash of providers to supply to template.
# File lib/fog/openstack/requests/orchestration/update_stack.rb, line 14 def update_stack(arg1, arg2 = nil, arg3 = nil) if arg1.is_a?(Stack) # Normal use, update_stack(stack, options = {}) stack = arg1 stack_name = stack.stack_name stack_id = stack.id params = arg2.nil? ? {} : arg2 else # Deprecated, update_stack(stack_id, stack_name, options = {}) Fog::Logger.deprecation("#update_stack(stack_id, stack_name, options) is deprecated, use #update_stack(stack, options) instead [light_black](#{caller.first})[/]") stack_id = arg1 stack_name = arg2 params = { :stack_name => stack_name }.merge(arg3.nil? ? {} : arg3) end request( :expects => 202, :path => "stacks/#{stack_name}/#{stack_id}", :method => 'PUT', :body => Fog::JSON.encode(params) ) end
# File lib/fog/openstack/requests/orchestration/validate_template.rb, line 5 def validate_template(options = {}) request( :body => Fog::JSON.encode(options), :expects => [200], :method => 'POST', :path => 'validate' ) end
Private Instance Methods
# File lib/fog/openstack/orchestration.rb, line 220 def authenticate if !@openstack_management_url || @openstack_must_reauthenticate options = { :openstack_api_key => @openstack_api_key, :openstack_username => @openstack_username, :openstack_auth_token => @openstack_must_reauthenticate ? nil : @auth_token, :openstack_auth_uri => @openstack_auth_uri, :openstack_region => @openstack_region, :openstack_tenant => @openstack_tenant, :openstack_service_type => @openstack_service_type, :openstack_service_name => @openstack_service_name, :openstack_identity_service_type => @openstack_identity_service_type, :openstack_endpoint_type => @openstack_endpoint_type } if @openstack_auth_uri.path =~ /\/v2.0\// credentials = Fog::OpenStack.authenticate_v2(options, @connection_options) else credentials = Fog::OpenStack.authenticate_v1(options, @connection_options) end @current_user = credentials[:user] @current_tenant = credentials[:tenant] @openstack_must_reauthenticate = false @auth_token = credentials[:token] @auth_token_expiration = credentials[:expires] @openstack_management_url = credentials[:server_management_url] @openstack_identity_public_endpoint = credentials[:identity_public_endpoint] end uri = URI.parse(@openstack_management_url) @host = uri.host @path, @tenant_id = uri.path.scan(/(\/.*)\/(.*)/).flatten @path.sub!(/\/$/, '') @port = uri.port @scheme = uri.scheme # Not all implementations have identity service in the catalog if @openstack_identity_public_endpoint || @openstack_management_url @identity_connection = Fog::Core::Connection.new( @openstack_identity_public_endpoint || @openstack_management_url, false, @connection_options) end true end