azure 0.7.0.pre → 0.7.0.pre2

data/lib/azure/client.rb

@@ -0,0 +1,31 @@
+#-------------------------------------------------------------------------
+# # 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
+  class Client
+    include Azure::Configurable
+    include Azure::HttpClient
+    include Azure::ClientServices
+
+    def initialize(options = {})
+      reset!(options)
+    end
+
+    # Check if this client is configured with the same options
+    def same_options?(opts)
+      opts.hash == options.hash
+    end
+  end
+end

data/lib/azure/client_services.rb

@@ -0,0 +1,98 @@
+#-------------------------------------------------------------------------
+# # 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
+  # The Azure::Configurable module provides quick access to the Azure services and initializes the service to use
+  # the configuration of the class it's mixed into.
+  module ClientServices
+    # Azure Blob service configured for this Azure client instance
+    # @return [Azure::Blob::BlobService]
+    def blobs(options = {})
+      @blobs ||= Azure::Blob::BlobService.new(default_client(options))
+    end
+
+    # Azure Queue service configured for this Azure client instance
+    # @return [Azure::Queue::QueueService]
+    def queues(options = {})
+      @queues ||= Azure::Queue::QueueService.new(default_client(options))
+    end
+
+    # Azure Table service configured for this Azure client instance
+    # @return [Azure::Table::TableService]
+    def tables(options = {})
+      @tables ||= Azure::Table::TableService.new(default_client(options))
+    end
+
+    # Azure Service Bus service configured for this Azure client instance
+    # @return [Azure::ServiceBus::ServiceBusService]
+    def service_bus(options = {})
+      @sb ||= Azure::ServiceBus::ServiceBusService.new(service_bus_host, default_client(options))
+    end
+
+    # Azure Virtual Image management service configured for this Azure client instance
+    # @return [Azure::VirtualMachineImageManagement::VirtualMachineImageManagementService]
+    def vm_image_management(options = {})
+      @vm_image_mgmt ||= Azure::VirtualMachineImageManagement::VirtualMachineImageManagementService.new(default_client(options))
+    end
+
+    # Azure Virtual Machine disk management service configured for this Azure client instance
+    # @return [Azure::VirtualMachineImageManagement::VirtualMachineDiskManagementService]
+    def vm_disk_management(options = {})
+      @vm_disk_mgmt ||= Azure::VirtualMachineImageManagement::VirtualMachineDiskManagementService.new(default_client(options))
+    end
+
+    # Azure Virtual Machine management service configured for this Azure client instance
+    # @return [Azure::VirtualMachineManagement::VirtualMachineManagementService]
+    def vm_management(options = {})
+      @vm_mgmt ||= Azure::VirtualMachineManagement::VirtualMachineManagementService.new(default_client(options))
+    end
+
+    # Azure SQL Database management service configured for this Azure client instance
+    # @return [Azure::SqlDatabaseManagement::SqlDatabaseManagementService]
+    def sql_database_management(options = {})
+      @sql_mgmt ||= Azure::SqlDatabaseManagement::SqlDatabaseManagementService.new(default_client(options))
+    end
+
+    # Azure Network management service configured for this Azure client instance
+    # @return [Azure::VirtualNetworkManagement::VirtualNetworkManagementService]
+    def network_management(options = {})
+      @network_mgmt ||= Azure::VirtualNetworkManagement::VirtualNetworkManagementService.new(default_client(options))
+    end
+
+    # Azure Cloud Service management service configured for this Azure client instance
+    # @return [Azure::CloudServiceManagement::CloudServiceManagementService]
+    def cloud_service_management(options = {})
+      @cs_mgmt ||= Azure::CloudServiceManagement::CloudServiceManagementService.new(default_client(options))
+    end
+
+    # Azure Storage management service configured for this Azure client instance
+    # @return [Azure::StorageManagement::StorageManagementService]
+    def storage_management(options = {})
+      @store_mgmt ||= Azure::StorageManagement::StorageManagementService.new(default_client(options))
+    end
+
+    # Azure Generic management service configured for this Azure client instance
+    # @return [Azure::BaseManagement::BaseManagementService]
+    def base_management(options = {})
+      @base_mgmt ||= Azure::BaseManagement::BaseManagementService.new(default_client(options))
+    end
+
+    private
+
+    def default_client(opts)
+      {client: self}.merge(opts || {})
+    end
+  end
+end

data/lib/azure/cloud_service_management/cloud_service_management_service.rb

@@ -19,10 +19,6 @@ module Azure
     class CloudServiceManagementService < BaseManagement::BaseManagementService
       include Azure::Core::Utility
 
-      def initialize
-        super()
-      end
-
       # Public: Creates a new cloud service in Microsoft Azure.
       #
       # ==== Attributes
@@ -56,7 +52,7 @@ module Azure
           Azure::Loggerx.info "Creating cloud service #{name}."
           request_path = '/services/hostedservices'
           body = Serialization.cloud_services_to_xml(name, options)
-          request = BaseManagement::ManagementHttpRequest.new(:post, request_path, body)
+          request = client.management_request(:post, request_path, body)
           request.call
         end
       end
@@ -66,7 +62,7 @@ module Azure
       # Returns an array of Azure::CloudServiceManagement::CloudService objects
       def list_cloud_services
         request_path = '/services/hostedservices'
-        request = BaseManagement::ManagementHttpRequest.new(:get, request_path, nil)
+        request = client.management_request(:get, request_path)
         response = request.call
         Serialization.cloud_services_from_xml(response)
       end
@@ -86,7 +82,7 @@ module Azure
 
       def get_cloud_service_properties(name)
         request_path = "/services/hostedservices/#{name}?embed-detail=true"
-        request = BaseManagement::ManagementHttpRequest.new(:get, request_path)
+        request = client.management_request(:get, request_path)
         response = request.call
         Serialization.cloud_services_from_xml(response).first
       end
@@ -100,7 +96,7 @@ module Azure
       # Returns:  None
       def delete_cloud_service(cloud_service_name)
         request_path= "/services/hostedservices/#{cloud_service_name}"
-        request = BaseManagement::ManagementHttpRequest.new(:delete, request_path)
+        request = client.management_request(:delete, request_path)
         Azure::Loggerx.info "Deleting cloud service #{cloud_service_name}. \n"
         request.call
       end
@@ -119,7 +115,7 @@ module Azure
       def delete_cloud_service_deployment(cloud_service_name, slot='production')
         slot = 'production' unless slot
         request_path= "/services/hostedservices/#{cloud_service_name}/deploymentslots/#{slot}"
-        request = BaseManagement::ManagementHttpRequest.new(:delete, request_path)
+        request = client.management_request(:delete, request_path)
         Azure::Loggerx.info "Deleting deployment of cloud service \"#{cloud_service_name}\" ..."
         request.call
       end
@@ -129,9 +125,11 @@ module Azure
         request_path= "/services/hostedservices/#{cloud_service_name}/certificates"
         body = Serialization.add_certificate_to_xml(data)
         Azure::Loggerx.info "Uploading certificate to cloud service #{cloud_service_name}..."
-        request = BaseManagement::ManagementHttpRequest.new(:post, request_path, body)
+        request = client.management_request(:post, request_path, body)
         request.call
       end
     end
   end
 end
+
+Azure::CloudServiceManagementService = Azure::CloudServiceManagement::CloudServiceManagementService

data/lib/azure/configurable.rb

@@ -0,0 +1,290 @@
+#-------------------------------------------------------------------------
+# # 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
+  # The Azure::Configurable module provides basic configuration for Azure activities.
+  module Configurable
+
+    # @!attribute [w] storage_access_key
+    #   @return [String] Azure Storage access key.
+    # @!attribute storage_account_name
+    #   @return [String] Azure Storage account name
+    # @!attribute sb_access_key
+    #   @return [String] Azure Service Bus access key
+    # @!attribute sb_sas_key
+    #   @return [String] Azure Service Bus Shared Access Signature key
+    # @!attribute sb_sas_key_name
+    #   @return [String] Azure Service Bus Shared Access Signature key name
+    # @!attribute sb_namespace
+    #   @return [String] Azure Service Bus namespace
+    # @!attribute sb_issuer
+    #   @return [String] Azure Service Bus issuer
+    # @!attribute ca_file
+    #   @return [String] Location of the Certificate Authority bundle to be used for HTTPS
+    # @!attribute management_certificate
+    #   @return [String|File] Azure Service Management certificate (pfx or pem)
+    # @!attribute subscription_id
+    #   @return [String] Azure Subscription ID
+    # @!attribute http_private_key
+    #   @return [String] Private key used for HTTPS certificate based authentication (derived from the management cert)
+    # @!attribute http_certificate_key
+    #   @return [String] Public key used for HTTPS certificate based authentication (derived from the management cert)
+    # @!attribute sql_database_management_endpoint
+    #   @return [String] Azure SQL database management endpoint. default: https://management.core.windows.net:8443/
+    # @!attribute storage_blob_host
+    #   @return [String] Set the host for the Blob service. Only set this if you want
+    #     something custom (like, for example, to point this to a LocalStorage
+    #     emulator). This should be the complete host, including http:// at the
+    #     start. When using the emulator, make sure to include your account name at
+    #     the end.
+    # @!attribute storage_table_host
+    #   @return [String] Get the host for this service. If you set something using #storage_table_host=,
+    #     then we use that. Else we default to Azure's default hosts, based
+    #     on your account name.
+    # @!attribute storage_queue_host
+    #   @return [String] Set the host for the Queue service. Only set this if you want
+    #     something custom (like, for example, to point this to a LocalStorage
+    #     emulator). This should be the complete host, including http:// at the
+    #     start. When using the emulator, make sure to include your account name at
+    #     the end.
+    # @!attribute management_endpoint
+    #   @return [String] Azure Service Management Endpoint. default: https://management.core.windows.net
+
+    attr_accessor :storage_access_key,
+                  :storage_account_name,
+                  :sb_access_key,
+                  :sb_namespace,
+                  :sb_sas_key,
+                  :sb_sas_key_name,
+                  :sb_issuer,
+                  :ca_file,
+                  :subscription_id
+
+    attr_reader :http_private_key,
+                :http_certificate_key,
+                :acs_host,
+                :service_bus_host
+
+    attr_writer :storage_table_host,
+                :storage_blob_host,
+                :storage_queue_host,
+                :sql_database_management_endpoint,
+                :management_endpoint
+
+    class << self
+
+      # List of configurable keys for {Azure::Client}
+      # @return [Array] of option keys
+      def keys
+        @keys ||= [
+            :storage_access_key,
+            :storage_account_name,
+            :sb_access_key,
+            :sb_sas_key,
+            :sb_sas_key_name,
+            :ca_file,
+            :sb_namespace,
+            :management_certificate,
+            :subscription_id,
+            :sql_database_management_endpoint,
+            :sb_issuer,
+            :storage_table_host,
+            :storage_blob_host,
+            :storage_queue_host,
+            :management_endpoint
+        ]
+      end
+    end
+
+    # Set configuration options using a block
+    def configure
+      yield self
+    end
+
+    # Reset configuration options to default values
+    def reset!(options = {})
+      Azure::Configurable.keys.each do |key|
+        value = if self == Azure
+                  Azure::Default.options[key]
+                else
+                  Azure.send(key)
+                end
+
+        if key == :management_certificate
+          @certificate_key = nil
+          @private_key = nil
+          send(:"#{key.to_s + '='}", value)
+        else
+          instance_variable_set(:"@#{key}", options.fetch(key, value))
+        end
+      end
+      self.send(:reset_agents!) if self.respond_to?(:reset_agents!)
+      self
+    end
+
+    alias setup reset!
+
+    def management_certificate
+      @management_certificate
+    end
+
+    # Set the management certificate via string or file (populates #http_private_key and #http_certificate_key)
+    # @param  [String|File] the string or file representing the .pem or .pfx
+    def management_certificate=(cert_string_or_file)
+      self.send(:reset_agents!) if self.respond_to?(:reset_agents!)
+      if cert_string_or_file.nil?
+        @certificate_key = @private_key = @management_certificate = nil
+      else
+
+        # the pfx may have null chars which will raise an exception in File.file?
+        invalid_file_chars = cert_string_or_file.to_s =~ /\x00/
+
+        # validate only if input is file path
+        if !invalid_file_chars && File.file?(cert_string_or_file) && File.extname(cert_string_or_file).downcase =~ /(pem|pfx)$/
+          error_message = "Could not read from file '#{cert_string_or_file}'."
+          raise ArgumentError.new(error_message) unless test('r', cert_string_or_file)
+        end
+
+        # get the string representation of cert
+        cert_file = if !invalid_file_chars && File.file?(cert_string_or_file)
+                      read_cert_from_file(cert_string_or_file)
+                    else
+                      cert_string_or_file
+                    end
+
+        begin
+          if cert_file =~ /-----BEGIN CERTIFICATE-----/
+            # Parse pem content
+            @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
+          @management_certificate = cert_file
+        rescue OpenSSL::OpenSSLError => e
+          @certificate_key = nil
+          @private_key = nil
+          raise ArgumentError.new("Management certificate not valid. Error: #{e.message}")
+        end
+      end
+    end
+
+    # Private side of the management certificate
+    # @returns [OpenSSL::X509::Certificate]
+    def http_private_key
+      @private_key
+    end
+
+    # Public side of the management certificate
+    # @returns [OpenSSL::PKey::RSA]
+    def http_certificate_key
+      @certificate_key
+    end
+
+    def management_endpoint
+      normalize_endpoint do
+        if URI(@management_endpoint).scheme.nil?
+          "https://#{@management_endpoint}"
+        else
+          @management_endpoint
+        end
+      end
+    end
+
+    def sql_database_management_endpoint
+      normalize_endpoint do
+        if URI(@sql_database_management_endpoint).scheme.nil?
+          "https://#{@sql_database_management_endpoint}:8443"
+        else
+          @sql_database_management_endpoint
+        end
+      end
+    end
+
+    # Storage queue host
+    # @return [String]
+    def storage_queue_host
+      @storage_queue_host || default_host(:queue)
+    end
+
+    # Storage blob host
+    # @return [String]
+    def storage_blob_host
+      @storage_blob_host || default_host(:blob)
+    end
+
+    # Storage table host
+    # @return [String]
+    def storage_table_host
+      @storage_table_host || default_host(:table)
+    end
+
+    # Get the host for the ACS service.
+    # @return [String]
+    def acs_host
+      if sb_namespace.empty?
+        nil
+      else
+        "https://#{sb_namespace}-sb.accesscontrol.windows.net"
+      end
+    end
+
+    # Get the host for Service Bus based on the Service Bus Namespace.
+    # @return [String]
+    def service_bus_host
+      if sb_namespace.empty?
+        nil
+      else
+        "https://#{sb_namespace}.servicebus.windows.net"
+      end
+    end
+
+    def config
+      self
+    end
+
+    private
+
+    def default_host(service)
+      "https://#{storage_account_name}.#{service}.core.windows.net"
+    end
+
+    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 normalize_endpoint
+      if block_given?
+        File.join(yield, '')
+      else
+        nil
+      end
+    end
+
+    def options
+      Hash[Azure::Configurable.keys.map { |key| [key, instance_variable_get(:"@#{key}")] }]
+    end
+
+  end
+end