juliusl-azure-sdk-for-ruby 0.7.0

data/Rakefile

@@ -0,0 +1,121 @@
+#-------------------------------------------------------------------------
+# # 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'
+require 'dotenv/tasks'
+
+gem_spec = eval(File.read('./azure.gemspec'))
+Gem::PackageTask.new(gem_spec) do |pkg|
+  pkg.need_zip = false
+  pkg.need_tar = false
+end
+
+namespace :test do
+  task :require_environment => :dotenv 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 = %w(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 = %w(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 = %w(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 = %w(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.acs_namespace  = ENV.fetch('AZURE_SERVICEBUS_NAMESPACE')
+      config.sb_access_key  = ENV.fetch('AZURE_SERVICEBUS_ACCESS_KEY')
+      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 => %w(test:unit test:integration)
+
+task :default => :test

data/azure.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    = 'juliusl-azure-sdk-for-ruby'
+  s.version = '0.7.0'
+  s.authors     = ['Microsoft Corporation', 'AppFog']
+  s.email       = 'juliusl@microsoft.com'
+  s.description = 'Windows Azure Client Library for Ruby'
+  s.summary     = 'Juliusl fork. Unofficial ruby client library to consume Windows Azure services.'
+  s.homepage    = 'http://github.com/juliusl/azure-sdk-for-ruby'
+  s.license     = 'Apache License, Version 2.0'
+  s.files       = `git ls-files`.split("\n")
+  s.bindir      = 'bin'
+  s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+
+  s.required_ruby_version = '>= 1.9.3'
+
+  s.add_runtime_dependency('nokogiri', '~> 1.6')
+  s.add_runtime_dependency('mime-types', '~> 2.0')
+  s.add_runtime_dependency('json', '~> 1.8')
+  s.add_runtime_dependency('uuid', '~> 2.0')
+  s.add_runtime_dependency('systemu', '~> 2.6')
+  s.add_runtime_dependency('thor', '~> 0.19')
+
+  s.add_development_dependency('rake', '~> 10.0')
+  s.add_development_dependency('minitest', '~> 5')
+  s.add_development_dependency('minitest-reporters', '~> 1')
+  s.add_development_dependency('mocha', '~> 1.0')
+  s.add_development_dependency('timecop', '~> 0.7')
+  s.add_development_dependency('dotenv', '~> 2.0' )
+end

data/bin/pfxer

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby -U
+
+require 'azure'
+require 'thor'
+require 'fileutils'
+
+module Azure
+  class Pfxer < Thor
+    desc 'transform', 'Transforms a publish settings file from Azure into a .pfx'
+
+    long_desc <<-TRANSFORM
+
+    `transform` will create a .pfx file from an Azure publish settings file. The publish settings file contains a
+    pfx, but the pfx is base64 encode within the publish settings xml structure. This is here to make that a little
+    easier.
+
+    TRANSFORM
+
+    option :in, required: true, desc: 'Path to publish settings file'
+    option :out, desc: 'Path to where you want your .pfx'
+    def transform
+      path = File.expand_path(options[:in])
+      if File.exists?(path)
+        pub_settings_xml = Nokogiri::XML(File.read(path))
+        b64_pfx = pub_settings_xml.css('PublishData PublishProfile Subscription')[0]['ManagementCertificate']
+        pfx = Base64.decode64(b64_pfx)
+        file_name = File.basename(path, '.publishsettings').downcase.gsub(' ', '_')
+        out_path = options[:out] || File.join(File.dirname(path), file_name + '.pfx')
+        File.binwrite(File.expand_path(out_path), pfx)
+      end
+    end
+  end
+end
+
+Azure::Pfxer.start(ARGV)

data/lib/azure.rb

@@ -0,0 +1,60 @@
+#-------------------------------------------------------------------------
+# # 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 'rubygems'
+require 'nokogiri'
+require 'base64'
+require 'openssl'
+require 'uri'
+require 'rexml/document'
+
+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
+Azure::Loggerx = Azure::Core::Logger

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,245 @@
+#-------------------------------------------------------------------------
+# 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 'azure/base_management/serialization'
+require 'azure/base_management/location'
+require 'azure/base_management/affinity_group'
+
+module Azure
+  module BaseManagement
+    class BaseManagementService
+      def initialize
+        validate_configuration
+        cert_file = Azure.config.management_certificate
+        cert_file = read_cert_from_file(cert_file) if File.file?(cert_file)
+
+        begin
+          if cert_file =~ /-----BEGIN CERTIFICATE-----/
+            certificate_key = OpenSSL::X509::Certificate.new(cert_file)
+            private_key = OpenSSL::PKey::RSA.new(cert_file)
+          else
+          # Parse pfx content
+            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 OpenSSL::OpenSSLError => 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
+        if File.file?(m_cert) && File.extname(m_cert).downcase =~ /(pem|pfx)$/ # validate only if input is file path
+          error_message = "Could not read from file '#{m_cert}'."
+          raise error_message unless test('r', m_cert)
+        end
+      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 = Azure::BaseManagement::ManagementHttpRequest.new(:get, '/locations')
+        response = request.call
+        Serialization.locations_from_xml(response)
+      end
+
+      # Public: Gets a list of role sizes associated with the
+      # specified subscription.
+      #
+      # Returns an array of String values for role sizes
+      def list_role_sizes
+        role_sizes = []
+        locations = list_locations
+        locations.each do | location |
+         role_sizes << location.role_sizes
+        end
+        role_sizes.flatten.uniq.compact.sort
+      end
+
+      # Public: Gets a lists the affinity groups associated with
+      # the specified subscription.
+      #
+      # See http://msdn.microsoft.com/en-us/library/azure/ee460797.aspx
+      #
+      # Returns an array of Azure::BaseManagement::AffinityGroup objects
+      def list_affinity_groups
+        request_path = '/affinitygroups'
+        request = Azure::BaseManagement::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/azure/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 = Azure::BaseManagement::ManagementHttpRequest.new(:post, request_path, body)
+          request.call
+          Azure::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/azure/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 = Azure::BaseManagement::ManagementHttpRequest.new(:put, request_path, body)
+          request.call
+          Azure::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/azure/gg715314.aspx
+      #
+      # Returns:  None
+      def delete_affinity_group(name)
+        if affinity_group(name)
+          request_path = "/affinitygroups/#{name}"
+          request = Azure::BaseManagement::ManagementHttpRequest.new(:delete, request_path)
+          request.call
+          Azure::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/azure/ee460789.aspx
+      #
+      # Returns:  Azure::BaseManagement::AffinityGroup object
+      def get_affinity_group(name)
+        if affinity_group(name)
+          request_path = "/affinitygroups/#{name}"
+          request = Azure::BaseManagement::ManagementHttpRequest.new(:get, request_path)
+          response = request.call
+          Serialization.affinity_group_from_xml(response)
+        end
+      end
+
+      private
+      def read_cert_from_file(cert_file_path)
+        if File.extname(cert_file_path).downcase == '.pem'
+          File.read(cert_file_path)
+        else
+          File.binread(cert_file_path)
+        end
+      end
+
+      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