azure-armrest 0.0.1

data/lib/azure/armrest/virtual_machine_manager.rb

@@ -0,0 +1,359 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Base class for managing virtual machines
+    class VirtualMachineManager < ArmrestManager
+
+      # The provider used in requests when gathering VM information.
+      attr_reader :provider
+
+      # Create and return a new VirtualMachineManager (VMM) instance. Most
+      # methods for a VMM instance will return one or more VirtualMachine
+      # instances.
+      #
+      # This subclass accepts the additional :provider option as well. The
+      # default is 'Microsoft.ClassicCompute'. You may need to set this to
+      # 'Microsoft.Compute' for your purposes.
+      #
+      def initialize(options = {})
+        super
+
+        @provider = options[:provider] || 'Microsoft.Compute'
+
+        # Typically only empty in testing.
+        unless @@providers.empty?
+          @api_version = @@providers[@provider]['virtualMachines']['api_version']
+        end
+      end
+
+      # Set a new provider to use the default for other methods. This may alter
+      # the api_version used for future requests. In practice, only
+      # 'Microsoft.Compute' or 'Microsoft.ClassicCompute' should be used.
+      #
+      def provider=(name)
+        @api_version = @@providers[name]['virtualMachines']['api_version']
+        @provider = name
+      end
+
+      # Return a list of available VM series (aka sizes, flavors, etc), such
+      # as "Basic_A1", though information is included as well.
+      #
+      def series(location)
+        unless @@providers[@provider] && @@providers[@provider]['locations/vmSizes']
+          raise ArgumentError, "Invalid provider '#{provider}'"
+        end
+
+        version = @@providers[@provider]['locations/vmSizes']['api_version']
+
+        url = url_with_api_version(
+          version, @base_url, 'subscriptions', subscription_id, 'providers',
+          provider, 'locations', location, 'vmSizes'
+        )
+
+        JSON.parse(rest_get(url))['value']
+      end
+
+      alias sizes series
+
+      # Returns a list of available virtual machines for the given subscription
+      # for the provided +group+, or all resource groups if none is provided.
+      #
+      # Examples:
+      #
+      #   # Get VM's for all resource groups
+      #   vmm.list
+      #
+      #   # Get VM's only for a specific group
+      #   vmm.list('some_group')
+      #--
+      # The specific hashes we can grab are:
+      # p JSON.parse(resp.body)["value"][0]["properties"]["instanceView"]
+      # p JSON.parse(resp.body)["value"][0]["properties"]["hardwareProfile"]
+      # p JSON.parse(resp.body)["value"][0]["properties"]["storageProfile"]
+      #
+      def list(group = nil)
+        array = []
+        if group
+          url = build_url(group)
+          array << JSON.parse(rest_get(url))['value']
+        else
+          threads = []
+          mutex = Mutex.new
+
+          resource_groups.each do |group|
+            url = build_url(group['name'])
+
+            threads << Thread.new(url) do |thread_url|
+              response = rest_get(thread_url)
+              result = JSON.parse(response)['value']
+              mutex.synchronize{ array << result if result }
+            end
+          end
+
+          threads.each(&:join)
+
+          array = array.flatten
+        end
+
+        add_network_profile(array)
+      end
+
+      alias get_vms list
+
+      def add_network_profile(vms)
+        vms.each { |vm|
+          vm['properties']['networkProfile']['networkInterfaces'].each { |net|
+            get_nic_profile(net)
+          }
+        }
+      end
+
+      def get_nic_profile(nic)
+        url = File.join(
+          Azure::Armrest::RESOURCE,
+          nic['id'],
+          "?api-version=#{api_version}"
+        )
+
+        nic['properties'] = JSON.parse(rest_get(url))['properties']['ipConfigurations']
+        nic['properties'].each do |n|
+          next if n['properties']['publicIPAddress'].nil?
+
+          # public IP is a URI so we need to make another rest call to get it.
+          url = File.join(
+            Azure::Armrest::RESOURCE,
+            n['properties']['publicIPAddress']['id'],
+            "?api-version=#{api_version}"
+          )
+
+          public_ip = JSON.parse(rest_get(url))['properties']['ipAddress']
+          n['properties']['publicIPAddress'] = public_ip
+        end
+      end
+
+      # Captures the +vmname+ and associated disks into a reusable CSM template.
+      #--
+      # POST
+      def capture(vmname, action = 'capture')
+        uri = @uri + "/#{vmname}/#{action}?api-version=#{api_version}"
+        uri
+      end
+
+      # Creates a new virtual machine (or updates an existing one). Pass a hash
+      # of options to configure the VM as you see fit. Some options are
+      # mandatory. The following are a list of possible options:
+      #
+      # - :name
+      #   Required. The name of the virtual machine. The name must be unique
+      #   within the availability set that it belongs to.
+      #
+      # - :location
+      #   Required. The location where the VM should be created, e.g. "West US".
+      #
+      # - :tags
+      #   Optional. Specifies an identifier for the availability set.
+      #
+      # - :hardwareprofile
+      #   Required. Contains a collection of hardware settings for the VM.
+      #
+      #   - :vmsize
+      #     Required. Specifies the size of the virtual machine. Possible
+      #     sizes are Standard_A0..Standard_A4.
+      #
+      # - :osprofile
+      #   Required. Contains a collection of settings for the OS configuration
+      #   which must contain all of the following:
+      #
+      #   - :computername
+      #   - :adminusername
+      #   - :adminpassword
+      #   - :username
+      #   - :password
+      #
+      # - :storageprofile
+      #   Required. Contains a collection of settings for storage and disk
+      #   settings for the VM. You must specify an :osdisk and :name. The
+      #   :datadisks setting is optional.
+      #
+      #   - :osdisk
+      #     Required. Contains a collection of settings for the operating
+      #     system disk.
+      #
+      #     - :name
+      #     - :ostype
+      #     - :caching
+      #     - :image
+      #     - :vhd
+      #
+      #   - :datadisks
+      #     Optional. Contains a collection of settings for data disks.
+      #
+      #     - :name
+      #     - :image
+      #     - :vhd
+      #     - :lun
+      #     - :caching
+      #
+      #   - :name
+      #     Required. Specifies the name of the disk.
+      #
+      # For clarity, we recommend using the update method for existing VM's.
+      #
+      # Example:
+      #
+      #   vmm = VirtualMachineManager.new(x, y, z)
+      #
+      #   vm = vmm.create(
+      #     :name            => 'test1',
+      #     :location        => 'West US',
+      #     :hardwareprofile => {:vmsize => 'Standard_A0'},
+      #     :osprofile       => {
+      #       :computername  => 'some_name',
+      #       :adminusername => 'admin_user',
+      #       :adminpassword => 'adminxxxxxx',
+      #       :username      => 'some_user',
+      #       :password      => 'userpassxxxxxx',
+      #     },
+      #     :storageprofile  => {
+      #       :osdisk => {
+      #         :ostype  => 'Windows',
+      #         :caching => 'Read'
+      #       }
+      #     }
+      #   )
+      #--
+      # PUT operation
+      #
+      def create(options = {})
+        #name = options.fetch(:name)
+        #location = options.fetch(:location)
+        #tags = option[:tags]
+        vmsize = options.fetch(:vmsize)
+
+        unless VALID_VM_SIZES.include?(vmsize)
+          raise ArgumentError, "Invalid vmsize '#{vmsize}'"
+        end
+      end
+
+      alias update create
+
+      # Stop the VM +vmname+ in +group+ and deallocate the tenant in Fabric.
+      #
+      def deallocate(vmname, group = vmname)
+        url = build_url(group, vmname, 'deallocate')
+        response = rest_post(url)
+        response.return!
+      end
+
+      # Deletes the +vmname+ in +group+ that you specify. Note that associated
+      # disks are not deleted.
+      #
+      def delete(vmname, group = vmname)
+        url = build_url(group, vmname)
+        response = rest_delete(url)
+        response.return!
+      end
+
+      # Sets the OSState for the +vmname+ in +group+ to 'Generalized'.
+      #
+      def generalize(vmname, group = vmname)
+        url = build_url(group, vmname, 'generalize')
+        response = rest_post(url)
+        response.return!
+      end
+
+      # Retrieves the settings of the VM named +vmname+ in resource group
+      # +group+, which will default to the same as the name of the VM.
+      #
+      # By default this method will retrieve the model view. If the +model_view+
+      # parameter is false, it will retrieve an instance view. The difference is
+      # in the details of the information retrieved.
+      #
+      def get(vmname, group = vmname, model_view = true)
+        if model_view
+          url = build_url(group, vmname)
+        else
+          url = build_url(group, vmname, 'instanceView')
+        end
+
+        JSON.parse(rest_get(url))
+      end
+
+      # Convenient wrapper around the get method that retrieves the model view
+      # for +vmname+ in resource_group +group+.
+      #
+      def get_model_view(vmname, group = vmname)
+        get(vmname, group, true)
+      end
+
+      # Convenient wrapper around the get method that retrieves the instance view
+      # for +vmname+ in resource_group +group+.
+      #
+      def get_instance_view(vmname, group = vmname)
+        get(vmname, group, false)
+      end
+
+      # Restart the VM +vmname+ for the given +group+, which will default
+      # to the same as the vmname.
+      #
+      # This is an asynchronous operation that returns a response object
+      # which you can inspect, such as response.code or response.headers.
+      #
+      def restart(vmname, group = vmname)
+        url = build_url(group, vmname, 'restart')
+        response = rest_post(url)
+        response.return!
+      end
+
+      # Start the VM +vmname+ for the given +group+, which will default
+      # to the same as the vmname.
+      #
+      # This is an asynchronous operation that returns a response object
+      # which you can inspect, such as response.code or response.headers.
+      #
+      def start(vmname, group = vmname)
+        url = build_url(group, vmname, 'start')
+        response = rest_post(url)
+        response.return!
+      end
+
+      # Stop the VM +vmname+ for the given +group+ gracefully. However,
+      # a forced shutdown will occur after 15 minutes.
+      #
+      # This is an asynchronous operation that returns a response object
+      # which you can inspect, such as response.code or response.headers.
+      #
+      def stop(vmname, group = vmname)
+        url = build_url(group, vmname, 'powerOff')
+        response = rest_post(url)
+        response.return!
+      end
+
+      private
+
+      # If no default subscription is set, then use the first one found.
+      def set_default_subscription
+        @subscription_id ||= subscriptions.first['subscriptionId']
+      end
+
+      # Builds a URL based on subscription_id an resource_group and any other
+      # arguments provided, and appends it with the api_version.
+      #
+      def build_url(resource_group, *args)
+        url = File.join(
+          Azure::Armrest::COMMON_URI,
+          subscription_id,
+          'resourceGroups',
+          resource_group,
+          'providers',
+          @provider,
+          'virtualMachines',
+        )
+
+        url = File.join(url, *args) unless args.empty?
+        url << "?api-version=#{api_version}"
+      end
+    end
+  end
+end

data/lib/azure/armrest/virtual_network_manager.rb

@@ -0,0 +1,62 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Base class for managing virtual networks
+    class VirtualNetworkManager < ArmrestManager
+
+      # Create and return a new VirtualNetworkManager instance. Most
+      # methods for a VirtualNetworkManager instance will return one or
+      # more VirtualNetwork instances.
+      #
+      def initialize(options = {})
+        super
+
+        @base_url += "resourceGroups/#{@resource_group}/"
+        @base_url += "providers/Microsoft.Network/virtualNetworks"
+      end
+
+      # Creates a new virtual network using the given +options+. The possible
+      # options are:
+      #
+      #   :name
+      #   :id
+      #   :location
+      #   :tags
+      #   :etag
+      #   :properties
+      #     :address_space
+      #       :address_prefixes
+      #     :dhcp_options
+      #       :dns_servers
+      #     :subnets
+      #       :name
+      #       :id
+      #       :etag
+      #       :provisioning_state
+      #       :address_prefix
+      #       :dhcp_options
+      #       :ip_configurations
+      #         :id
+      #--
+      def create(network_name, options = {})
+        @uri += "/#{network_name}?api-version=#{api_version}"
+      end
+
+      # Deletes the +network_name+ availability set.
+      def delete(network_name)
+        @uri += "/#{network_name}?api-version=#{api_version}"
+      end
+
+      # Retrieves the options of an availability set.
+      def get(network_name)
+        @uri += "/#{network_name}?api-version=#{api_version}"
+      end
+
+      # List availability sets.
+      def list
+        @uri += "?api-version=#{api_version}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: azure-armrest
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Daniel J. Berger
+- Bronagh Sorota
+- Greg Blomquist
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-08-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  This is a Ruby interface for Azure using the newer REST API. This is
+  different than the current azure gem, which uses the older (XML) interface
+  behind the scenes.
+email:
+- dberger@redhat.com
+- bsorota@redhat.com
+- gblomqui@redhat.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGES
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- azure-armrest.gemspec
+- lib/azure-armrest.rb
+- lib/azure/armrest.rb
+- lib/azure/armrest/armrest_manager.rb
+- lib/azure/armrest/availability_set_manager.rb
+- lib/azure/armrest/event_manager.rb
+- lib/azure/armrest/storage_account_manager.rb
+- lib/azure/armrest/subnet_manager.rb
+- lib/azure/armrest/version.rb
+- lib/azure/armrest/virtual_machine_extension_manager.rb
+- lib/azure/armrest/virtual_machine_image_manager.rb
+- lib/azure/armrest/virtual_machine_manager.rb
+- lib/azure/armrest/virtual_network_manager.rb
+homepage: http://github.com/ManageIQ/azure-armrest
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: An interface for ARM/JSON Azure REST API
+test_files: []
+has_rdoc: