fog-azure-rm 0.2.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: abba2750995255a81a2edf8cb5d51bf41331f5b3
-  data.tar.gz: d883aa12233282ce91ce91ceb1ca895eb2ae2810
+  metadata.gz: 499bef52b07b1965693b2351d698143b41a8e63e
+  data.tar.gz: d609928c181f0d655a7b6c832a42f583f2a5c20e
 SHA512:
-  metadata.gz: c17370ff19fd0e568d8309ca054b957e6affee602909e7fc102640eeab68a218ff1f2b47438fc4e015392e9d7d77c9cd4ea7e855fe440dcb35eca441f1d79e32
-  data.tar.gz: 390a20c58f0321402dc6ebc7d6c789a7a5c8a484b76b14deec8ebf274a50cf09b908f4cfcc1efcc7c41041cdc4d88e734a788582d1afeade4cc49e1e4fda4f2c
+  metadata.gz: 55657900d7678d4fd9312f7a11ab4b5b486a674876d27742920b6cafd84879b4ace419fc55abb6d47af0d0dc791ebd80e85e947909a07e8cfd14c081b9b8bfd3
+  data.tar.gz: eb622b9ff7a636e64a5ee82ff6890f980be76a5553b00141211a972c2b609d0a06cf46047a3dd204b747a2fdce5e99230c5ba4725c42e4c2d4fb718672f9e280

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 0.3.0
+
+**Added**
+- Compute Service - Added support for Managed Disk
+- Compute Service - Added async method of creating server(virtual machine)
+
+**Changed:**
+- Compute Service - Changed create server method to take multiple NICs instead of one
+- Updated Azure SDK gems to v0.9.0
+
+**Fixed:**
+- Integration tests
+
 ## 0.2.7
 
 **Changed:**

data/fog-azure-rm.gemspec

@@ -25,14 +25,14 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'fog-core', '~> 1.43.0'
   spec.add_dependency 'fog-json', '~> 1.0'
   spec.add_dependency 'rest-client', '~> 2.0.0'
-  spec.add_dependency 'azure_mgmt_compute', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_resources', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_storage', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_network', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_dns', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_traffic_manager', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_sql', '~> 0.8.0'
-  spec.add_dependency 'azure_mgmt_key_vault', '~> 0.8.0'
+  spec.add_dependency 'azure_mgmt_compute', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_resources', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_storage', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_network', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_dns', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_traffic_manager', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_sql', '~> 0.9.0'
+  spec.add_dependency 'azure_mgmt_key_vault', '~> 0.9.0'
   spec.add_dependency 'azure-storage', '~> 0.11.5.preview'
   spec.add_dependency 'vhd', '0.0.4'
 end

data/lib/fog/azurerm.rb

@@ -68,6 +68,11 @@ module Fog
     autoload :AzureRM, File.expand_path('azurerm/key_vault', __dir__)
   end
 
+  # Autoload Module for Response::Asynchronous
+  module AzureRM
+    autoload :AsyncResponse, File.expand_path('azurerm/async_response', __dir__)
+  end
+
   # Main AzureRM fog Provider Module
   module AzureRM
     extend Fog::Provider

data/lib/fog/azurerm/async_response.rb

@@ -0,0 +1,36 @@
+module Fog
+  module AzureRM
+    # class for Async Response
+    class AsyncResponse
+      def initialize(model, promise)
+        @fog_model = model
+        @promise = promise
+      end
+
+      def value
+        response = @promise.value.body
+        @fog_model.merge_attributes(@fog_model.class.parse(response))
+      end
+
+      def state
+        @promise.state
+      end
+
+      def reason
+        @promise.reason
+      end
+
+      def pending?
+        @promise.pending?
+      end
+
+      def fulfilled?
+        @promise.fulfilled?
+      end
+
+      def rejected?
+        @promise.rejected?
+      end
+    end
+  end
+end

data/lib/fog/azurerm/compute.rb

@@ -33,6 +33,14 @@ module Fog
       request :delete_vm_extension
       request :get_vm_extension
       request :check_vm_extension_exists
+      request :create_or_update_managed_disk
+      request :delete_managed_disk
+      request :get_managed_disk
+      request :check_managed_disk_exists
+      request :list_managed_disks_by_rg
+      request :list_managed_disks_in_subscription
+      request :revoke_access_to_managed_disk
+      request :grant_access_to_managed_disk
 
       model_path 'fog/azurerm/models/compute'
       model :availability_set
@@ -41,6 +49,13 @@ module Fog
       collection :servers
       model :virtual_machine_extension
       collection :virtual_machine_extensions
+      model :managed_disk
+      collection :managed_disks
+      model :creation_data
+      model :disk_create_option
+      model :encryption_settings
+      model :image_disk_reference
+      model :operation_status_response
 
       # This class provides the mock implementation for unit tests.
       class Mock
@@ -65,7 +80,6 @@ module Fog
             raise e.message
           end
 
-
           options[:environment] = 'AzureCloud' if options[:environment].nil?
 
           telemetry = "fog-azure-rm/#{Fog::AzureRM::VERSION}"

data/lib/fog/azurerm/constants.rb

@@ -17,18 +17,24 @@ RESOURCE_PROVIDER_NAMESPACE = 6
 RESOURCE_TYPE = 7
 RESOURCE_NAME = 8
 ENDPOINT_PREFIX = 'Microsoft.Network/trafficManagerProfiles'.freeze
+DISK_PREFIX = 'Microsoft.Compute/disks'
 AZURE_ENDPOINTS = 'azureEndpoints'.freeze
 EXTERNAL_ENDPOINTS = 'externalEndpoints'.freeze
 NESTED_ENDPOINTS = 'nestedEndpoints'.freeze
 GLOBAL = 'global'.freeze
 UPLOAD_BLOB_WORKER_THREAD_COUNT = 8
 VM_NAME_POSITION = 8
+PRIMARY_NIC_INDEX = 0
 
 ENVIRONMENT_AZURE_CLOUD = 'AzureCloud'.freeze
 ENVIRONMENT_AZURE_CHINA_CLOUD = 'AzureChinaCloud'.freeze
 ENVIRONMENT_AZURE_US_GOVERNMENT = 'AzureUSGovernment'.freeze
 ENVIRONMENT_AZURE_GERMAN_CLOUD = 'AzureGermanCloud'.freeze
 
+# MsRestAzure::AzureOperationError class Error Codes
+ERROR_CODE_RESOURCE_NOT_FOUND = 'ResourceNotFound'.freeze
+ERROR_CODE_NOT_FOUND = 'NotFound'.freeze
+
 PLATFORM_LINUX = 'linux'.freeze
 
 # State of the copy operation

data/lib/fog/azurerm/docs/compute.md

@@ -35,6 +35,9 @@ azure_compute_service.servers.check_vm_exists(<Resource Group name>, <VM Name>)
 
 Create a new linux server
 
+**Info:**
+Attribute **network_interface_card_ids** is an array of NICs ids. The NIC id at index zero will become primary NIC of this server(virtual machine) by default.
+
 ```ruby
     azure_compute_service.servers.create(
         name: '<VM Name>',
@@ -45,7 +48,7 @@ Create a new linux server
         username: '<Username for VM>',
         password: '<Password for VM>',             # Optional, if 'platform' partameter is 'Linux'.
         disable_password_authentication: false,
-        network_interface_card_id: '/subscriptions/{Subscription-Id}/resourceGroups/{Resource-Group-Name}/providers/Microsoft.Network/networkInterfaces/{Network-Interface-Id}',
+        network_interface_card_ids: ['/subscriptions/{Subscription-Id}/resourceGroups/{Resource-Group-Name}/providers/Microsoft.Network/networkInterfaces/{Network-Interface-Id}'],
         publisher: 'Canonical',                    # Not required if custom image is being used 
         offer: 'UbuntuServer',                     # Not required if custom image is being used
         sku: '14.04.2-LTS',                        # Not required if custom image is being used
@@ -69,7 +72,7 @@ Create a new windows server
         username: '<Username for VM>',
         password: '<Password for VM>',
         disable_password_authentication: false,
-        network_interface_card_id: '/subscriptions/{Subscription-Id}/resourceGroups/{Resource-Group-Name}/providers/Microsoft.Network/networkInterfaces/{Network-Interface-Id}',
+        network_interface_card_ids: ['/subscriptions/{Subscription-Id}/resourceGroups/{Resource-Group-Name}/providers/Microsoft.Network/networkInterfaces/{Network-Interface-Id}'],
         publisher: 'MicrosoftWindowsServerEssentials',   # Not required if custom image is being used
         offer: 'WindowsServerEssentials',                # Not required if custom image is being used  
         sku: 'WindowsServerEssentials',                  # Not required if custom image is being used
@@ -79,6 +82,61 @@ Create a new windows server
         custom_data: 'echo customData'                   # Optional, if you want to add custom data in this VM.
     )
 ```
+
+## Create Server Asynchronously
+
+Create a new linux server asynchronously
+
+```ruby
+    async_response = azure_compute_service.servers.create_async(
+        name: '<VM Name>',
+        location: 'West US',
+        resource_group: '<Resource Group Name>',
+        vm_size: 'Basic_A0',
+        storage_account_name: '<Storage Account Name>',
+        username: '<Username for VM>',
+        password: '<Password for VM>',             # Optional, if 'platform' partameter is 'Linux'.
+        disable_password_authentication: false,
+        network_interface_card_ids: ['/subscriptions/{Subscription-Id}/resourceGroups/{Resource-Group-Name}/providers/Microsoft.Network/networkInterfaces/{Network-Interface-Id}'],
+        publisher: 'Canonical',                    # Not required if custom image is being used 
+        offer: 'UbuntuServer',                     # Not required if custom image is being used
+        sku: '14.04.2-LTS',                        # Not required if custom image is being used
+        version: 'latest',                         # Not required if custom image is being used
+        platform: 'Linux',
+        vhd_path: '<Path of VHD>',                 # Optional, if you want to create the VM from a custom image.
+        custom_data: 'echo customData',            # Optional, if you want to add custom data in this VM.
+        os_disk_caching: Fog::ARM::Compute::Models::CachingTypes::None # Optional, can be one of None, ReadOnly, ReadWrite
+    )
+```
+Following methods are available to handle async respoonse:
+- state
+- pending?
+- rejected?
+- reason
+- fulfilled?
+- value
+
+An example of handling async response is given below:
+
+```ruby
+while 1
+    puts async_response.state
+    
+    if async_response.pending?
+      sleep(2)
+    end
+
+    if async_response.fulfilled?
+      puts async_response.value.inspect
+      break
+    end
+
+    if async_response.rejected?
+      puts async_response.reason.inspect
+      break
+    end
+ end
+```
  
 For more information about custom_data; see link: https://msdn.microsoft.com/en-us/library/azure/mt163591.aspx
 
@@ -247,5 +305,90 @@ Destroy the given extension from the virtual machine
     vm_extension.destroy
 ```
 
+
+## Create Managed Disk
+
+Create a new Managed Disk
+
+```ruby
+    azure_compute_service.managed_disks.create(
+        name: 'disk_name',
+        location: 'east us',
+        resource_group_name: 'resource_group_name',
+        account_type: 'Premium_LRS',
+        disk_size_gb: 1023,
+        creation_data: {
+          create_option: 'Empty'
+        }
+    )
+```
+
+## List Managed Disks in a Resource Group
+
+List managed disks in a resource group
+
+```ruby
+    managed_disks  = azure_compute_service.managed_disks(resource_group: '<Resource Group name>')
+    mnaged_disks.each do |disk|
+        puts "#{disk.name}"
+        puts "#{disk.location}"
+    end
+```
+
+## List Managed Disks in a Subscription
+
+List managed disks in a subscription
+
+```ruby
+    azure_compute_service.managed_disks.each do |disk|
+        puts "#{disk.name}"
+        puts "#{disk.location}"
+    end
+```
+
+## Grant Access to a Managed Disk
+
+Grant access to a managed disk
+
+```ruby
+    access_sas = azure_compute_service.managed_disks.grant_access('<resource_group_name>', '<disk_name>', 'Read', 1000)
+    puts "Access SAS: #{access_sas}"
+```
+
+## Revoke Access from a Managed Disk
+
+Revoke access from a managed disk
+
+```ruby
+    response = azure_compute_service.managed_disks.revoke_access('<resource_group_name>', '<disk_name>')
+    puts "Revoke Access response status: #{response.status}"
+```
+
+## Check Managed Disk Existence
+
+```ruby
+    azure_compute_service.managed_disks.check_managed_disk_exists(<Resource Group name>, <Disk name>)
+```
+
+## Retrieve a single Managed Disk
+
+Get a single record of managed disks
+
+```ruby
+      managed_disk = azure_compute_service
+                          .managed_disks
+                          .get('<Resource Group name>','<Disk name>')
+      puts "#{managed_disk.name}"
+```
+
+## Destroy a single Managed Disk
+
+Get an managed disk object from the get method and then destroy that managed disk.
+
+```ruby
+      managed_disk.destroy
+```
+
+
 ## Support and Feedback
 Your feedback is appreciated! If you have specific issues with the fog ARM, you should file an issue via Github.

data/lib/fog/azurerm/models/compute/creation_data.rb

@@ -0,0 +1,21 @@
+module Fog
+  module Compute
+    class AzureRM
+      # CreationData model for Compute Service
+      class CreationData < Fog::Model
+        attribute :create_option
+        attribute :storage_account_id
+        attribute :source_uri
+        attribute :source_resource_id
+        attribute :image_reference
+
+        def self.parse(creation_data)
+          data = get_hash_from_object(creation_data)
+          image_reference = Fog::Compute::AzureRM::ImageDiskReference.new
+          data['image_reference'] = image_reference.merge_attributes(Fog::Compute::AzureRM::ImageDiskReference.parse(creation_data.image_reference))
+          data
+        end
+      end
+    end
+  end
+end

data/lib/fog/azurerm/models/compute/disk_create_option.rb

@@ -0,0 +1,16 @@
+module Fog
+  module ARM
+    module Compute
+      module Models
+        module DiskCreateOption
+          FromImage = 'fromImage'.freeze
+          Empty = 'empty'.freeze
+          Attach = 'attach'.freeze
+          Import = 'Import'.freeze
+          Copy = 'Copy'.freeze
+          Restore = 'Restore'.freeze
+        end
+      end
+    end
+  end
+end

data/lib/fog/azurerm/models/compute/encryption_settings.rb

@@ -0,0 +1,29 @@
+module Fog
+  module Compute
+    class AzureRM
+      # EncryptionSettings model for Compute Service
+      class EncryptionSettings < Fog::Model
+        attribute :key_url
+        attribute :secret_url
+        attribute :enabled
+        attribute :key_source_vault_id
+        attribute :disk_source_vault_id
+
+        def self.parse(encryption_settings)
+          settings = {}
+          settings['enabled'] = encryption_settings.enabled
+
+          if encryption_settings.disk_encryption_key
+            settings['secret_url'] = encryption_settings.disk_encryption_key.secret_url
+            settings['disk_source_vault_id'] = encryption_settings.disk_encryption_key.source_vault.id
+          end
+          if encryption_settings.key_encryption_key
+            settings['key_url'] = encryption_settings.key_encryption_key.key_url
+            settings['key_source_vault_id'] = encryption_settings.key_encryption_key.source_vault.id
+          end
+          settings
+        end
+      end
+    end
+  end
+end

data/lib/fog/azurerm/models/compute/image_disk_reference.rb

@@ -0,0 +1,15 @@
+module Fog
+  module Compute
+    class AzureRM
+      # ImageReference model for Compute Service
+      class ImageDiskReference < Fog::Model
+        attribute :id
+        attribute :lun
+
+        def self.parse(image_reference)
+          get_hash_from_object(image_reference)
+        end
+      end
+    end
+  end
+end

data/lib/fog/azurerm/models/compute/managed_disk.rb

@@ -0,0 +1,77 @@
+module Fog
+  module Compute
+    class AzureRM
+      # This class is giving implementation of create/save and
+      # delete/destroy for Managed Disk.
+      class ManagedDisk < Fog::Model
+        attribute :id
+        identity  :name
+        attribute :resource_group_name
+        attribute :type
+        attribute :location
+        attribute :account_type
+        attribute :time_created
+        attribute :os_type
+        attribute :disk_size_gb
+        attribute :owner_id
+        attribute :provisioning_state
+        attribute :tags
+        attribute :creation_data
+        attribute :encryption_settings
+
+        def self.parse(managed_disk)
+          disk = get_hash_from_object(managed_disk)
+
+          unless managed_disk.creation_data.nil?
+            creation_data = Fog::Compute::AzureRM::CreationData.new
+            disk['creation_data'] = creation_data.merge_attributes(Fog::Compute::AzureRM::CreationData.parse(managed_disk.creation_data))
+          end
+
+          unless managed_disk.encryption_settings.nil?
+            encryption_settings = Fog::Compute::AzureRM::EncryptionSettings.new
+            disk['encryption_settings'] = encryption_settings.merge_attributes(Fog::Compute::AzureRM::EncryptionSettings.parse(managed_disk.encryption_settings))
+          end
+
+          disk['resource_group_name'] = get_resource_group_from_id(managed_disk.id)
+
+          disk
+        end
+
+        def save
+          requires :name, :location, :resource_group_name, :creation_data
+          requires :disk_size_gb if creation_data[:create_option] == 'Empty'
+          validate_creation_data_params(creation_data)
+
+          disk = service.create_or_update_managed_disk(managed_disk_params)
+          merge_attributes(Fog::Compute::AzureRM::ManagedDisk.parse(disk))
+        end
+
+        def destroy
+          service.delete_managed_disk(resource_group_name, name)
+        end
+
+        private
+
+        def validate_creation_data_params(creation_data)
+          unless creation_data.key?(:create_option)
+            raise(ArgumentError, ':create_option is required for this operation')
+          end
+        end
+
+        def managed_disk_params
+          {
+            name: name,
+            location: location,
+            resource_group_name: resource_group_name,
+            account_type: account_type,
+            os_type: os_type,
+            disk_size_gb: disk_size_gb,
+            tags: tags,
+            creation_data: creation_data,
+            encryption_settings: encryption_settings
+          }
+        end
+      end
+    end
+  end
+end