azurex 0.6.5

data/Rakefile

@@ -0,0 +1,125 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# 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 "rake/testtask"
+require "rubygems/package_task"
+
+gem_spec = eval(File.read("./azurex.gemspec"))
+Gem::PackageTask.new(gem_spec) do |pkg|
+  pkg.need_zip = false
+  pkg.need_tar = false
+end
+
+namespace :test do
+  task :require_environment do
+    unset_environment = [
+      ENV.fetch("AZURE_STORAGE_ACCOUNT",  nil),
+      ENV.fetch("AZURE_STORAGE_ACCESS_KEY",    nil),
+      ENV.fetch("AZURE_SERVICEBUS_NAMESPACE", nil),
+      ENV.fetch("AZURE_SERVICEBUS_ACCESS_KEY", nil),
+      ENV.fetch('AZURE_MANAGEMENT_CERTIFICATE', nil),
+      ENV.fetch('AZURE_SUBSCRIPTION_ID', nil)
+    ].include?(nil)
+
+    #abort "[ABORTING] Configure your environment to run the integration tests" if unset_environment
+  end
+
+  Rake::TestTask.new :unit do |t|
+    t.pattern = "test/unit/**/*_test.rb"
+    t.verbose = true
+    t.libs = ["lib", "test"]
+  end
+
+  namespace :unit do
+    def component_task(component)
+      Rake::TestTask.new component do |t|
+        t.pattern = "test/unit/#{component}/**/*_test.rb"
+        t.verbose = true
+        t.libs = ["lib", "test"]
+      end
+
+      task component => "test:require_environment"
+    end
+
+    component_task :affinity_group
+    component_task :base_management
+    component_task :blob
+    component_task :cloud_service_management
+    component_task :core
+    component_task :database
+    component_task :service
+    component_task :storage_management
+    component_task :table
+    component_task :virtual_machine_image_management
+    component_task :virtual_machine_management
+    component_task :vnet
+  end
+
+  Rake::TestTask.new :integration do |t|
+    t.pattern = "test/integration/**/*_test.rb"
+    t.verbose = true
+    t.libs = ["lib", "test"]
+  end
+
+  task :integration => :require_environment
+
+  namespace :integration do
+    def component_task(component)
+      Rake::TestTask.new component do |t|
+        t.pattern = "test/integration/#{component}/**/*_test.rb"
+        t.verbose = true
+        t.libs = ["lib", "test"]
+      end
+
+      task component => "test:require_environment"
+    end
+
+    component_task :affinity_group
+    component_task :blob
+    component_task :database
+    component_task :location
+    component_task :queue
+    component_task :service_bus
+    component_task :storage_management
+    component_task :table
+    component_task :vm
+    component_task :vm_image
+    component_task :vnet
+  end
+
+  task :cleanup => :require_environment do
+    $:.unshift "lib"
+    require 'azure'
+
+    Azure.configure do |config|
+      config.access_key     = ENV.fetch("AZURE_STORAGE_ACCESS_KEY")
+      config.account_name   = ENV.fetch("AZURE_STORAGE_ACCOUNT")
+      # config.table_host     = ENV.fetch("AZURE_STORAGE_TABLE_HOST")
+      # config.blob_host      = ENV.fetch("AZURE_STORAGE_BLOB_HOST")
+      # config.queue_host     = ENV.fetch("AZURE_STORAGE_QUEUE_HOST")
+
+      config.acs_namespace  = ENV.fetch("AZURE_SERVICEBUS_NAMESPACE")
+      config.sb_access_key  = ENV.fetch("AZURE_SERVICEBUS_ACCESS_KEY")
+      # config.sb_issuer      = ENV.fetch("AZURE_SERVICEBUS_ISSUER")
+      config.management_certificate  = ENV.fetch('AZURE_MANAGEMENT_CERTIFICATE')
+      config.management_endpoint  = ENV.fetch("AZURE_MANAGEMENT_ENDPOINT")
+      config.sql_database_management_endpoint = ENV.fetch("AZURE_SQL_DATABASE_MANAGEMENT_ENDPOINT")
+      config.subscription_id  = ENV.fetch("AZURE_SUBSCRIPTION_ID")
+    end
+  end
+end
+
+task :test => ["test:unit", "test:integration"]
+
+task :default => :test

data/azurex.gemspec

@@ -0,0 +1,47 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# 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 "date"
+
+require File.expand_path('../lib/azure/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name    = "azurex"
+  s.version = Azure::Version
+
+  s.authors     = ["Microsoft Corporation", "various individuals"]
+  s.email       = "timothy@mukaibo.com"
+  s.description = "Microsoft Azure Client Library for Ruby"
+  s.summary     = "Non-Official ruby client library to consume Windows Azure services. 
+    As of June 2014, the official gem witten by Microsoft(0.6.4) only covers a few methods 
+    from the vast Azure REST API. This gem has a number of enhancements over the under-developed
+    official project. Contributions are welcome! See the readme for details.
+    This project is a fork of https://github.com/azure/azure-sdk-for-ruby.git"
+  s.homepage    = "https://github.com/mukaibot/azure-sdk-for-ruby.git"
+  s.license     = 'Apache License, Version 2.0'
+  s.files       = `git ls-files`.split("\n")
+
+  s.required_ruby_version = '>= 2.0.0'
+
+  s.add_runtime_dependency('nokogiri',   "~> 1.5")
+  s.add_runtime_dependency("mime-types", "~> 1.0")
+  s.add_runtime_dependency('json', '~> 1.8')
+  s.add_runtime_dependency('uuid', '~> 2.0')
+  s.add_runtime_dependency('systemu', '~> 2.6')
+
+  s.add_development_dependency("rake", '~> 10.0')
+  s.add_development_dependency("minitest", "~> 3.0")
+  s.add_development_dependency('mocha', '~> 1.0')
+  s.add_development_dependency('turn', '~> 0.9')
+end

data/lib/azure.rb

@@ -0,0 +1,52 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# 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 Azure; end
+
+require 'azure/core'
+require 'azure/blob/blob_service'
+require 'azure/queue/queue_service'
+require 'azure/service_bus/service_bus_service'
+require 'azure/service_bus/empty_rule_action'
+require 'azure/service_bus/sql_rule_action'
+require 'azure/service_bus/sql_filter'
+require 'azure/service_bus/true_filter'
+require 'azure/service_bus/correlation_filter'
+require 'azure/table/table_service'
+require 'azure/table/batch'
+require 'azure/table/query'
+require 'azure/core/utility'
+require 'azure/base_management/management_http_request'
+require 'azure/base_management/sql_management_http_request'
+require 'azure/base_management/base_management_service'
+require 'azure/virtual_machine_image_management/virtual_machine_image_management_service'
+require 'azure/virtual_machine_management/virtual_machine_management_service'
+require 'azure/storage_management/storage_management_service'
+require 'azure/cloud_service_management/cloud_service_management_service'
+require 'azure/base_management/location'
+require 'azure/sql_database_management/sql_database_management_service'
+require 'azure/virtual_network_management/virtual_network_management_service'
+
+# add some aliases for convenience
+Azure::BlobService = Azure::Blob::BlobService
+Azure::QueueService = Azure::Queue::QueueService
+Azure::TableService = Azure::Table::TableService
+Azure::ServiceBusService = Azure::ServiceBus::ServiceBusService
+Azure::VirtualMachineImageManagementService = Azure::VirtualMachineImageManagement::VirtualMachineImageManagementService
+Azure::BaseManagementService = Azure::BaseManagement::BaseManagementService
+Azure::CloudServiceManagementService = Azure::CloudServiceManagement::CloudServiceManagementService
+Azure::StorageManagementService = Azure::StorageManagement::StorageManagementService
+Azure::VirtualMachineManagementService = Azure::VirtualMachineManagement::VirtualMachineManagementService
+Azure::SqlDatabaseManagementService = Azure::SqlDatabaseManagement::SqlDatabaseManagementService
+Azure::VirtualNetworkManagementService = Azure::VirtualNetworkManagement::VirtualNetworkManagementService

data/lib/azure/base_management/affinity_group.rb

@@ -0,0 +1,32 @@
+#-------------------------------------------------------------------------
+# Copyright 2013 Microsoft Open Technologies, Inc.
+#
+# 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 Azure
+  module BaseManagement
+    # Represents an AffinityGroup
+    class AffinityGroup
+      def initialize
+        yield self if block_given?
+      end
+
+      attr_accessor :name
+      attr_accessor :label
+      attr_accessor :description
+      attr_accessor :location
+      attr_accessor :hosted_services
+      attr_accessor :storage_services
+      attr_accessor :capability
+    end
+  end
+end

data/lib/azure/base_management/base_management_service.rb

@@ -0,0 +1,238 @@
+#-------------------------------------------------------------------------
+# Copyright 2013 Microsoft Open Technologies, Inc.
+#
+# 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 'rubygems'
+require 'nokogiri'
+require 'base64'
+require 'openssl'
+require 'uri'
+require 'rexml/document'
+require 'azure/base_management/serialization'
+require 'azure/base_management/location'
+require 'azure/base_management/affinity_group'
+
+include Azure::BaseManagement
+include Azure::Core::Utility
+Loggerx = Azure::Core::Logger
+
+module Azure
+  module BaseManagement
+    class BaseManagementService
+      def initialize
+        validate_configuration
+        cert_file = nil
+        begin
+          if Azure.config.management_certificate =~ /(pem)$/
+            cert_file = File.read(Azure.config.management_certificate)
+            certificate_key = OpenSSL::X509::Certificate.new(cert_file)
+            private_key = OpenSSL::PKey::RSA.new(cert_file)
+          else
+            # Parse pfx content
+            File.open(Azure.config.management_certificate, "rb") do |f|
+                cert_file = f.read
+            end
+            cert_content = OpenSSL::PKCS12.new(cert_file)
+            certificate_key = OpenSSL::X509::Certificate.new(
+              cert_content.certificate.to_pem
+            )
+            private_key = OpenSSL::PKey::RSA.new(cert_content.key.to_pem)
+          end
+        rescue Exception => e
+          raise "Management certificate not valid. Error: #{e.message}"
+        end
+
+        Azure.configure do |config|
+          config.http_certificate_key = certificate_key
+          config.http_private_key = private_key
+        end
+      end
+
+      def validate_configuration
+        subs_id = Azure.config.subscription_id
+        error_message = 'Subscription ID not valid.'
+        raise error_message if subs_id.nil? || subs_id.empty?
+
+        m_ep = Azure.config.management_endpoint
+        error_message = 'Management endpoint not valid.'
+        raise error_message if m_ep.nil? || m_ep.empty?
+
+        m_cert = Azure.config.management_certificate
+        error_message = "Could not read from file '#{m_cert}'."
+        raise error_message unless test('r', m_cert)
+
+        m_cert = Azure.config.management_certificate
+        error_message = 'Management certificate expects a .pem or .pfx file.'
+        raise error_message unless m_cert =~ /(pem|pfx)$/
+      end
+
+      # Public: Gets a list of regional data center locations from the server
+      #
+      # Returns an array of Azure::BaseManagement::Location objects
+      def list_locations
+        request = ManagementHttpRequest.new(:get, '/locations')
+        response = request.call
+        Serialization.locations_from_xml(response)
+      end
+
+      # Public: Gets a lists the affinity groups associated with
+      # the specified subscription.
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/ee460797.aspx
+      #
+      # Returns an array of Azure::BaseManagement::AffinityGroup objects
+      def list_affinity_groups
+        request_path = '/affinitygroups'
+        request = ManagementHttpRequest.new(:get, request_path, nil)
+        response = request.call
+        Serialization.affinity_groups_from_xml(response)
+      end
+
+      # Public: Creates a new affinity group for the specified subscription.
+      #
+      # ==== Attributes
+      #
+      # * +name+           - String. Affinity Group name.
+      # * +location+       - String. The location where the affinity group will
+      # be created.
+      # * +label+         - String. Name for the affinity specified as a
+      # base-64 encoded string.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs are:
+      # * +:description+   - String. A description for the affinity group.
+      # (optional)
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/gg715317.aspx
+      #
+      # Returns:  None
+      def create_affinity_group(name, location, label, options = {})
+        if name.nil? || name.strip.empty?
+          raise 'Affinity Group name cannot be empty'
+        elsif list_affinity_groups.map(&:name).include?(name)
+          raise Azure::Error::Error.new(
+            'ConflictError',
+            409,
+            "An affinity group #{name}"\
+            " already exists in the current subscription."
+          )
+        else
+          validate_location(location)
+          body = Serialization.affinity_group_to_xml(name,
+                                                     location,
+                                                     label,
+                                                     options)
+          request_path = '/affinitygroups'
+          request = ManagementHttpRequest.new(:post, request_path, body)
+          request.call
+          Loggerx.info "Affinity Group #{name} is created."
+        end
+      end
+
+      # Public: updates the label and/or the description for an affinity group
+      # for the specified subscription.
+      #
+      # ==== Attributes
+      #
+      # * +name+          - String. Affinity Group name.
+      # * +label+         - String. Name for the affinity specified as a
+      # base-64 encoded string.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs are:
+      # * +:description+   - String. A description for the affinity group.
+      # (optional)
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/gg715316.aspx
+      #
+      # Returns:  None
+      def update_affinity_group(name, label, options = {})
+        raise 'Label name cannot be empty' if label.nil? || label.empty?
+        if affinity_group(name)
+          body = Serialization.resource_to_xml(label, options)
+          request_path = "/affinitygroups/#{name}"
+          request = ManagementHttpRequest.new(:put, request_path, body)
+          request.call
+          Loggerx.info "Affinity Group #{name} is updated."
+        end
+      end
+
+      # Public: Deletes an affinity group in the specified subscription
+      #
+      # ==== Attributes
+      #
+      # * +name+       - String. Affinity Group name.
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/gg715314.aspx
+      #
+      # Returns:  None
+      def delete_affinity_group(name)
+        if affinity_group(name)
+          request_path = "/affinitygroups/#{name}"
+          request = ManagementHttpRequest.new(:delete, request_path)
+          request.call
+          Loggerx.info "Deleted affinity group #{name}."
+        end
+      end
+
+      # Public: returns the system properties associated with the specified
+      # affinity group.
+      #
+      # ==== Attributes
+      #
+      # * +name+       - String. Affinity Group name.
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/ee460789.aspx
+      #
+      # Returns:  Azure::BaseManagement::AffinityGroup object
+      def get_affinity_group(name)
+        if affinity_group(name)
+          request_path = "/affinitygroups/#{name}"
+          request = ManagementHttpRequest.new(:get, request_path)
+          response = request.call
+          Serialization.affinity_group_from_xml(response)
+        end
+      end
+
+      private
+
+      def affinity_group(affinity_group_name)
+        if affinity_group_name.nil? ||\
+           affinity_group_name.empty? ||\
+           !list_affinity_groups.map { |x| x.name.downcase }.include?(
+            affinity_group_name.downcase
+           )
+          error = Azure::Error::Error.new('AffinityGroupNotFound',
+                                          404,
+                                          'The affinity group does not exist.')
+          raise error
+        else
+          true
+        end
+      end
+
+      def validate_location(location_name)
+        base_mgmt_service = Azure::BaseManagementService.new
+        locations = base_mgmt_service.list_locations.map(&:name)
+        unless locations.map(&:downcase).include?(location_name.downcase)
+          error = "Value '#{location_name}' specified for parameter"\
+                  " 'location' is invalid."\
+                  " Allowed values are #{locations.join(',')}"
+          raise error
+        end
+      end
+    end
+  end
+end