vmware-vra 2.7.2 → 3.0.0

data/lib/vra/catalog_source.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+#
+# Author:: Ashique Saidalavi (<ashique.saidalavi@progress.com>)
+# Copyright:: Copyright (c) 2022 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+require 'ffi_yajl' unless defined?(FFI_Yajl)
+
+module Vra
+  # Class that represents the Catalog Source
+  class CatalogSource < Vra::CatalogBase
+    INDEX_URL = '/catalog/api/admin/sources'
+
+    # @param client [Vra::Client] - a vra client object
+    # @param opts [Hash] - Contains the either id of the catalog or the data hash
+    # Either one of id or data hash is required, must not supply both
+    def initialize(client, opts)
+      super
+      validate!
+      fetch_data
+    end
+
+    def name
+      data['name']
+    end
+
+    def catalog_type_id
+      data['typeId']
+    end
+
+    def catalog_type
+      @catalog_type ||= Vra::CatalogType.new(client, id: catalog_type_id)
+    end
+
+    def config
+      data['config']
+    end
+
+    def global?
+      data['global'] == true
+    end
+
+    def project_id
+      config['sourceProjectId']
+    end
+
+    def entitle!(opts = {})
+      super(opts.merge(type: 'CatalogSourceIdentifier'))
+    end
+
+    class << self
+      # Method to create a catalog source
+      def create(client, opts)
+        validate_create!(opts)
+
+        response = client.http_post(
+          '/catalog/api/admin/sources',
+          FFI_Yajl::Encoder.encode(create_params(opts)),
+          opts[:skip_auth] || false
+        )
+
+        return false unless response.success?
+
+        new(client, data: FFI_Yajl::Parser.parse(response.body))
+      end
+
+      def entitle!(client, id)
+        new(client, id: id).entitle!
+      end
+
+      private
+
+      def validate_create!(opts)
+        %i[name catalog_type_id project_id].each do |arg|
+          raise ArgumentError, "#{arg} param is required to perform the create action" unless opts.key?(arg)
+        end
+      end
+
+      def create_params(opts)
+        {
+          'name': opts[:name],
+          'typeId': opts[:catalog_type_id],
+          'config': {
+            'sourceProjectId': opts[:project_id]
+          }
+        }
+      end
+    end
+
+    private
+
+    def fetch_data
+      fetch_catalog_data && return if data.nil?
+
+      @id = data['id']
+    end
+
+    def fetch_catalog_data
+      @data = client.get_parsed("/catalog/api/admin/sources/#{id}")
+    rescue Vra::Exception::HTTPNotFound
+      raise Vra::Exception::NotFound, "catalog source ID #{id} does not exist"
+    end
+  end
+end

data/lib/vra/catalog_type.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+#
+# Author:: Ashique Saidalavi (<ashique.saidalavi@progress.com>)
+# Copyright:: Copyright (c) 2022 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+module Vra
+  # Class that represents the Catalog Type
+  class CatalogType < Vra::CatalogBase
+    INDEX_URL = '/catalog/api/types'
+
+    def initialize(client, opts = {})
+      super
+      validate!
+      fetch_data
+    end
+
+    def name
+      data['name']
+    end
+
+    def base_url
+      data['baseUri']
+    end
+
+    def config_schema
+      data['configSchema']
+    end
+
+    def icon_id
+      data['iconId']
+    end
+
+    private
+
+    def fetch_data
+      @id = data['id'] and return unless data.nil?
+
+      @data = client.get_parsed("/catalog/api/types/#{id}")
+    rescue Vra::Exception::HTTPNotFound
+      raise Vra::Exception::NotFound, "catalog type ID #{id} does not exist"
+    end
+  end
+end

data/lib/vra/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 #
 # Author:: Chef Partner Engineering (<partnereng@chef.io>)
-# Copyright:: Copyright (c) 2015 Chef Software, Inc.
+# Copyright:: Copyright (c) 2022 Chef Software, Inc.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -17,22 +17,26 @@
 # limitations under the License.
 #
 
-require "ffi_yajl" unless defined?(FFI_Yajl)
-require "passwordmasker"
-require "vra/http"
+require 'ffi_yajl' unless defined?(FFI_Yajl)
+require 'passwordmasker'
+require 'vra/http'
 
 module Vra
   class Client
+    ACCESS_TOKEN_URL = '/csp/gateway/am/api/login?access_token'
+    ROLES_URL = '/csp/gateway/am/api/loggedin/user/orgs'
+
     attr_accessor :page_size
 
     def initialize(opts)
-      @base_url     = opts[:base_url]
-      @username     = opts[:username]
-      @password     = PasswordMasker.new(opts[:password])
-      @tenant       = opts[:tenant]
-      @verify_ssl   = opts.fetch(:verify_ssl, true)
-      @bearer_token = PasswordMasker.new(nil)
-      @page_size    = opts.fetch(:page_size, 20)
+      @base_url      = opts[:base_url]
+      @username      = opts[:username]
+      @password      = PasswordMasker.new(opts[:password])
+      @tenant        = opts[:tenant]
+      @verify_ssl    = opts.fetch(:verify_ssl, true)
+      @refresh_token = PasswordMasker.new(nil)
+      @access_token  = PasswordMasker.new(nil)
+      @page_size     = opts.fetch(:page_size, 20)
 
       validate_client_options!
     end
@@ -43,15 +47,11 @@ module Vra
     #
 
     def catalog
-      Vra::Catalog.new(self)
-    end
-
-    def requests(*args)
-      Vra::Requests.new(self, *args)
+      @catalog ||= Vra::Catalog.new(self)
     end
 
-    def resources(*args)
-      Vra::Resources.new(self, *args)
+    def deployments
+      @deployments ||= Vra::Deployments.new(self)
     end
 
     #########################
@@ -59,55 +59,64 @@ module Vra
     # client methods
     #
 
-    def bearer_token
-      @bearer_token.value
+    def access_token
+      @access_token.value
+    end
+
+    def refresh_token
+      @refresh_token.value
+    end
+
+    def access_token=(value)
+      @access_token.value = value
     end
 
-    def bearer_token=(value)
-      @bearer_token.value = value
+    def refresh_token=(value)
+      @refresh_token.value = value
     end
 
-    def bearer_token_request_body
+    def token_params
       {
-        "username" => @username,
-        "password" => @password.value,
-        "tenant" => @tenant,
+        'username': @username,
+        'password': @password.value,
+        'tenant': @tenant
       }
     end
 
     def request_headers
-      headers = {}
-      headers["Accept"]        = "application/json"
-      headers["Content-Type"]  = "application/json"
-      headers["Authorization"] = "Bearer #{@bearer_token.value}" unless @bearer_token.value.nil?
+      headers                   = {}
+      headers['Accept']         = 'application/json'
+      headers['Content-Type']   = 'application/json'
+      headers['csp-auth-token'] = @access_token.value unless @access_token.value.nil?
+
       headers
     end
 
     def authorize!
-      generate_bearer_token unless authorized?
+      generate_access_token unless authorized?
 
-      raise Vra::Exception::Unauthorized, "Unable to authorize against vRA" unless authorized?
+      raise Vra::Exception::Unauthorized, 'Unable to authorize against vRA' unless authorized?
     end
 
     def authorized?
-      return false if @bearer_token.value.nil?
+      return false if @access_token.value.nil?
 
-      response = http_head("/identity/api/tokens/#{@bearer_token.value}", :skip_auth)
-      response.success_no_content?
+      response = http_head(ROLES_URL, :skip_auth)
+      response.success?
     end
 
-    def generate_bearer_token
-      @bearer_token.value = nil
+    def generate_access_token
+      @access_token.value = nil
       validate_client_options!
 
-      response = http_post("/identity/api/tokens",
-                           FFI_Yajl::Encoder.encode(bearer_token_request_body),
+      response = http_post(ACCESS_TOKEN_URL,
+                           FFI_Yajl::Encoder.encode(token_params),
                            :skip_auth)
-      unless response.success_ok?
-        raise Vra::Exception::Unauthorized, "Unable to get bearer token: #{response.body}"
-      end
+      raise Vra::Exception::Unauthorized, "Unable to get the access token: #{response.body}" unless response.success_ok?
 
-      @bearer_token.value = FFI_Yajl::Parser.parse(response.body)["id"]
+      response_body = FFI_Yajl::Parser.parse(response.body)
+      @access_token.value = response_body['access_token']
+      @refresh_token.value = response_body['refresh_token']
     end
 
     def full_url(path)
@@ -140,22 +149,26 @@ module Vra
       response.body
     end
 
+    def http_delete(path, skip_auth = nil)
+      http_fetch(:delete, path, skip_auth)
+    end
+
     def get_parsed(path)
       FFI_Yajl::Parser.parse(http_get!(path))
     end
 
-    def http_get_paginated_array!(path)
+    def http_get_paginated_array!(path, filter = nil)
       items = []
-      page = 1
-      base_path = path + "?limit=#{page_size}"
+      page = 0
+      base_path = path + "?$top=#{page_size}"
+      base_path += "&#{filter}" if filter
 
       loop do
-        response = get_parsed("#{base_path}&page=#{page}")
+        response = get_parsed("#{base_path}&$skip=#{page * page_size}")
         items += response["content"]
 
-        break if page >= response["metadata"]["totalPages"]
-
         page += 1
+        break if page >= response["totalPages"]
       end
 
       if items.uniq!
@@ -219,10 +232,5 @@ module Vra
     rescue URI::InvalidURIError
       false
     end
-
-    def fetch_subtenant_items(tenant, subtenant_name)
-      http_get("/identity/api/tenants/#{tenant}/subtenants?%24filter=name+eq+'#{subtenant_name}'")
-    end
-
   end
 end

data/lib/vra/deployment.rb

@@ -0,0 +1,155 @@
+# frozen_string_literal: true
+#
+# Author:: Ashique Saidalavi (<ashique.saidalavi@progress.com>)
+# Copyright:: Copyright (c) 2022 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require "ffi_yajl" unless defined?(FFI_Yajl)
+
+module Vra
+  # Class that represents the Deployment Object
+  class Deployment
+    INDEX_URL = '/deployment/api/deployments'
+
+    attr_reader :id
+
+    def initialize(client, opts = {})
+      @client = client
+      @id     = opts[:id]
+      @data   = opts[:data]
+      validate!
+
+      if @data.nil?
+        refresh
+      elsif @id.nil?
+        @id = @data['id']
+      end
+    end
+
+    def name
+      @data['name']
+    end
+
+    def description
+      @data['description']
+    end
+
+    def org_id
+      @data['orgId']
+    end
+
+    def blueprint_id
+      @data['blueprintId']
+    end
+
+    def owner
+      @data['ownedBy']
+    end
+
+    def status
+      @data['status']
+    end
+
+    def successful?
+      status == 'CREATE_SUCCESSFUL'
+    end
+
+    def failed?
+      status == 'CREATE_FAILED'
+    end
+
+    def completed?
+      successful? || failed?
+    end
+
+    def actions
+      @actions = client.get_parsed("/deployment/api/deployments/#{id}/actions")
+    end
+
+    def action_id_by_name(action_name)
+      action = actions.find { |x| x['name'] == action_name}
+      return if action.nil?
+
+      action['id']
+    end
+
+    def resources
+      response = client.get_parsed("/deployment/api/deployments/#{id}/resources")
+
+      response['content'].map! { |x| Vra::Resource.new(client, id, data: x) }
+    end
+
+    def resource_by_id(res_id)
+      Vra::Resource.new(client, id, id: res_id)
+    end
+
+    def requests
+      response = client.get_parsed("/deployment/api/deployments/#{id}/requests")
+
+      response['content'].map! { |x| Vra::Request.new(client, id, id: x['id'], data: x) }
+    end
+
+    def refresh
+      @data = client.get_parsed("/deployment/api/deployments/#{id}")
+    rescue Vra::Exception::HTTPNotFound
+      raise Vra::Exception::NotFound, "deployment with ID #{id} does not exist"
+    end
+
+    def destroy(reason = '')
+      action_id = action_id_by_name('Delete')
+      raise Vra::Exception::NotFound, "No destroy action found for resource #{@id}" if action_id.nil?
+
+      submit_action_request(action_id, reason)
+    end
+
+    def power_off(reason = '')
+      action_id = action_id_by_name('PowerOff')
+      raise Vra::Exception::NotFound, "No power-off action found for resource #{@id}" if action_id.nil?
+
+      submit_action_request(action_id, reason)
+    end
+
+    def power_on(reason = nil)
+      action_id = action_id_by_name('PowerOn')
+      raise Vra::Exception::NotFound, "No power-on action found for resource #{@id}" if action_id.nil?
+
+      submit_action_request(action_id, reason)
+    end
+
+    private
+
+    attr_reader :client, :data
+
+    def validate!
+      raise ArgumentError, 'must supply id or data hash' if @id.nil? && @data.nil?
+    end
+
+    def submit_action_request(action_id, reason)
+      response = client.http_post!("/deployment/api/deployments/#{id}/requests",
+                                   FFI_Yajl::Encoder.encode(submit_action_payload(action_id, reason)))
+
+      Vra::Request.new(client, id, data: FFI_Yajl::Parser.parse(response))
+    end
+
+    def submit_action_payload(action_id, reason)
+      {
+        "actionId": action_id,
+        "inputs": {},
+        "reason": reason
+      }
+    end
+  end
+end

data/lib/vra/deployment_request.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+#
+# Author:: Ashique Saidalavi (<ashique.saidalavi@progress.com>)
+# Copyright:: Copyright (c) 2022 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+require 'ffi_yajl' unless defined?(FFI_Yajl)
+
+# Overriding the hash object to add the deep_merge method
+class ::Hash
+  def deep_merge(second)
+    merger = proc { |_key, v1, v2| Hash === v1 && Hash === v2 ? v1.merge(v2, &merger) : v2 }
+    merge(second, &merger)
+  end
+end
+
+module Vra
+  # class that handles the deployment request with catalog
+  class DeploymentRequest
+    attr_reader :catalog_id
+    attr_accessor :image_mapping, :name, :flavor_mapping,
+                  :project_id, :version, :count
+
+    def initialize(client, catalog_id, opts = {})
+      @client            = client
+      @catalog_id        = catalog_id
+      @image_mapping     = opts[:image_mapping]
+      @name              = opts[:name]
+      @flavor_mapping    = opts[:flavor_mapping]
+      @project_id        = opts[:project_id]
+      @version           = opts[:version]
+      @count             = opts[:count] || 1
+      @additional_params = opts[:additional_params] || Vra::RequestParameters.new
+    end
+
+    def submit
+      validate!
+      begin
+        response = send_request!
+      rescue Vra::Exception::HTTPError => e
+        raise Vra::Exception::RequestError, "Unable to submit request: #{e.message}, trace: #{e.errors.join(', ')}"
+      rescue StandardError => e
+        raise e, e.message
+      end
+
+      request_id = FFI_Yajl::Parser.parse(response)[0]['deploymentId']
+      Vra::Deployment.new(client, id: request_id)
+    end
+
+    def set_parameter(key, type, value)
+      @additional_params.set(key, type, value)
+    end
+
+    def set_parameters(key, value_data)
+      @additional_params.set_parameters(key, value_data)
+    end
+
+    def delete_parameter(key)
+      @additional_params.delete(key)
+    end
+
+    def parameters
+      @additional_params.to_vra
+    end
+
+    def hash_parameters
+      @additional_params.to_h
+    end
+
+    private
+
+    attr_reader :client
+
+    def validate!
+      missing_params = []
+      %i[image_mapping flavor_mapping name project_id version].each do |arg|
+        missing_params << arg if send(arg).nil?
+      end
+
+      return if missing_params.empty?
+
+      raise ArgumentError, "Unable to submit request, required param(s) missing => #{missing_params.join(', ')}"
+    end
+
+    def send_request!
+      client.http_post!(
+        "/catalog/api/items/#{catalog_id}/request",
+        FFI_Yajl::Encoder.encode(request_payload)
+      )
+    end
+
+    def request_payload
+      {
+        'deploymentName': name,
+        'projectId': project_id,
+        'version': version,
+        'inputs': {
+          'count': count,
+          'image': image_mapping,
+          'flavor': flavor_mapping
+        }
+      }.deep_merge(parameters)
+    end
+  end
+end