foreman_hyperv 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cf1610103bdfad147e262399c3c50667bf4450831ebb8e9a4f20211307a3d18
-  data.tar.gz: a4623968a974d9de60af94cd0dfaa9957a89354f640897e8138c6c0b32f95b9a
+  metadata.gz: 156c82d3cc4630c1d222fc97370cef6b5f3128da1d97732dcef072f8b4adbbe3
+  data.tar.gz: d812c0f6a6785879bbe4cacff1f943237b24951ea8b5b5f2e2add668d2480b58
 SHA512:
-  metadata.gz: a1007568c30b112299208b00a5df11c8d88c0b0e390365ede46efc67900489b7cdb40b6ca83a318505e6ff6f3fc167c6bb2239c18e910710a45572e161213852
-  data.tar.gz: 51d064f97547b16ec490a6c9d9436c87efbed149957a6f66b6fef85d652ff0c91201e44c13a039ed53871db51b26487181ee11410bb45f45663ce6b6068ec1d3
+  metadata.gz: 89a21ca4968ec5adbc536b7cffde5e2619f4e54f704a259e52ec812ccb25271be31674c5bd0f6f154752c1a80d8b2eef836f497fe838781bd6f923ce1e8aa242
+  data.tar.gz: 16c7a09381db0854437d1620d708eabd7415459fc644577e508b45e94cd51e3c5b8bcd722eafeb049140615f15ea54fedbbf80e2a604dab17ecf82c4ea9395e2

data/app/assets/javascripts/foreman_hyperv/compute_resource_base.js

@@ -1,20 +1,3 @@
-$(document).on('ContentLoad', function() { tfm.numFields.initAll(); });
-
-function hypervGenerationChange(item) {
-  var toIter = ['#host_compute_attributes_secure_boot_enabled', '#compute_attribute_vm_attrs_secure_boot_enabled'];
-  gen = $(item).val();
-
-  if (gen == 'BIOS') {
-    for (var i = 0; i < toIter.length; ++i) {
-      $(toIter[i]).attr('disabled', true);
-    }
-  } else {
-    for (var i = 0; i < toIter.length; ++i) {
-      $(toIter[i]).removeAttr('disabled');
-    }
-  }
-}
-
 function hypervDynamicMemoryChange(item) {
   var toIter = [
     '#host_compute_attributes_memory_maximum',

data/app/helpers/foreman_hyperv/compute_resources_vms_helper.rb

@@ -8,6 +8,20 @@ module ForemanHyperv
       end
     end
 
+    def hyperv_boot_devices
+      devices = Fog::Hyperv::BOOT_DEVICE_ENUM_VALUES.dup
+      # devices.delete :Floppy if generation == :UEFI
+      devices.delete :IDE
+      devices.delete :LegacyNetworkAdapter
+      devices.map do |dev|
+        name = dev.to_s
+        name = 'Network Adapter' if dev == :NetworkAdapter
+        name = 'DVD' if dev == :CD
+        name = 'Floppy (Only for BIOS)' if dev == :Floppy
+        [dev, name]
+      end
+    end
+
     def hyperv_generations
       Fog::Hyperv::Compute::Server::VM_GENERATION_VALUES.map { |gen, num| [gen, "Generation #{num} (#{gen})"] }
     end

data/app/models/concerns/fog_extensions/hyperv/network_adapter.rb

@@ -41,7 +41,7 @@ module FogExtensions
       end
 
       def access_vlan_id
-        return nil if vlan_setting.access_vlan_id.zero?
+        return nil if (vlan_setting.access_vlan_id || 0).zero?
 
         vlan_setting.access_vlan_id
       end
@@ -49,7 +49,7 @@ module FogExtensions
       delegate :access_vlan_id=, to: :vlan_setting
 
       def native_vlan_id
-        return nil if vlan_setting.native_vlan_id.zero?
+        return nil if (vlan_setting.native_vlan_id || 0).zero?
 
         vlan_setting.native_vlan_id
       end
@@ -68,7 +68,7 @@ module FogExtensions
       end
 
       def primary_vlan_id
-        return nil if vlan_setting.primary_vlan_id.zero?
+        return nil if (vlan_setting.primary_vlan_id || 0).zero?
 
         vlan_setting.primary_vlan_id
       end
@@ -76,7 +76,7 @@ module FogExtensions
       delegate :primary_vlan_id=, to: :vlan_setting
 
       def secondary_vlan_id
-        return nil if vlan_setting.secondary_vlan_id.zero?
+        return nil if (vlan_setting.secondary_vlan_id || 0).zero?
 
         vlan_setting.secondary_vlan_id
       end

data/app/models/concerns/fog_extensions/hyperv/server.rb

@@ -43,6 +43,20 @@ module FogExtensions
         @cluster = service.clusters.get(name)
       end
 
+      def boot_device
+        :NetworkAdapter
+      end
+
+      def foreman_firmware_type
+        return 'bios' if generation_num == 1
+
+        secure_boot_enabled ? 'uefi_secure_boot' : 'uefi'
+      end
+
+      def foreman_firmware
+        generation_num == 1 ? 'bios' : 'efi'
+      end
+
       def vlan
         nic = network_adapters.first
 
@@ -69,16 +83,15 @@ module FogExtensions
 
       def secure_boot_enabled=(enabled)
         return if generation != :UEFI
-
-        @secure_boot = enabled
         return unless persisted?
 
         firmware.secure_boot = enabled ? :On : :Off
+        firmware.save
       end
 
       def secure_boot_enabled
         return false if generation != :UEFI
-        return @secure_boot unless persisted?
+        return unless persisted?
 
         firmware.secure_boot == :On
       end

data/app/models/foreman_hyperv/hyperv.rb

@@ -108,6 +108,10 @@ module ForemanHyperv
       )
     end
 
+    def associated_host(vm)
+      associate_by("mac", vm.network_adapters.map(&:mac))
+    end
+
     delegate :servers, to: :client
 
     def switches(host)
@@ -120,7 +124,11 @@ module ForemanHyperv
     end
 
     def new_vm(attr = {})
+      firmware_type = attr.delete(:firmware_type).to_s
+      attr.merge!(process_firmware_attributes(attr[:foreman_firmware], firmware_type)) #, attr[:provision_method]))
       attr.delete :id
+
+      # logger.debug "New VM with arguments;\n#{attr}"
       vm = super
       iface_nested_attrs = nested_attributes_for :interfaces, attr[:interfaces_attributes]
       vm.network_adapters = iface_nested_attrs.map do |attr|
@@ -149,13 +157,17 @@ module ForemanHyperv
       attr.delete :computer_name if attr[:computer_name].blank?
       attr.delete :start
 
+      firmware_type = attr.delete(:firmware_type).to_s
+      attr.merge!(process_firmware_attributes(attr[:foreman_firmware], firmware_type)) #, attr[:provision_method]))
+
       validate_vm(attr, new: true)
       validate_interfaces(attr)
       validate_volumes(attr)
 
+      # logger.debug "Creating VM with arguments; #{attr}"
       vm = client.servers.new(
         name: attr[:name],
-        computer_name: attr[:computer_name],
+        computer_name: attr[:computer_name].presence || hypervisor.name,
         generation: attr[:generation],
         dynamic_memory_enabled: Foreman::Cast.to_bool(attr[:dynamic_memory_enabled]),
         memory_startup: attr[:memory_startup].to_i,
@@ -164,13 +176,20 @@ module ForemanHyperv
         processor_count: attr[:processor_count].to_i,
         notes: attr[:notes]
       )
-      # TODO: Allow configuring boot device?
-      vm.create boot_device: :NetworkAdapter
+      vm.create(
+        # TODO: should be :VHD if image build - when image build support exists
+        boot_device: attr[:boot_device].present? ? attr[:boot_device].to_sym : :NetworkAdapter,
+        path: hypervisor.virtual_machine_path
+      )
 
-      if vm.generation == :UEFI && attr[:secure_boot_enabled].present?
-        f = vm.firmware
-        f.secure_boot = Foreman::Cast.to_bool(attr[:secure_boot_enabled]) ? :On : :Off
-        f.save if f.dirty?
+      if vm.generation == :UEFI
+        vm.secure_boot_enabled = attr[:secure_boot_enabled]
+        if attr[:tpm_enabled] == '1'
+          security = vm.security
+          security.change_key_protector :new
+          security.tpm_enabled = true
+          security.save
+        end
       end
 
       create_interfaces(vm, attr)
@@ -178,27 +197,26 @@ module ForemanHyperv
 
       vm.start if attr[:start] == '1'
       vm
-    rescue StandardError => e
-      if vm
+    rescue StandardError
+      if vm&.persisted?
         vm.stop
         vm.hard_drives.each { |hdd| hdd.destroy(underlying: true) }
-        vm.destroy
+        vm.destroy(vm.path.end_with?(vm.name))
       end
 
-      raise e
+      raise
     end
 
     def save_vm(uuid, web_attr)
       attr = web_attr.deep_symbolize_keys
+      attr.delete :start
 
       validate_vm(attr)
       validate_interfaces(attr)
       validate_volumes(attr)
 
-      attr.delete :start
-
       vm = find_vm_by_uuid(uuid)
-      logger.debug "Updating VM #{vm} with arguments; #{attr}"
+      # logger.debug "Updating VM #{vm} with arguments; #{attr}"
 
       vm.processor_count = attr[:processor_count].to_i
       vm.notes = attr[:notes].presence
@@ -207,10 +225,19 @@ module ForemanHyperv
         vm.memory_minimum = attr[:memory_minimum].to_i
         vm.memory_maximum = attr[:memory_maximum].to_i
       end
-      if vm.generation == :UEFI && attr[:secure_boot_enabled].present?
-        f = vm.firmware
-        f.secure_boot = Foreman::Cast.to_bool(attr[:secure_boot_enabled]) ? :On : :Off
-        f.save if f.dirty?
+      if vm.generation == :UEFI && attr[:tpm_enabled].present?
+        security = vm.security
+        security.tpm_enabled = attr[:tpm_enabled] == '1'
+        if security.tpm_enabled && security.key_protector.nil?
+          security.change_key_protector :new
+        end
+        security.save
+      end
+      if attr[:foreman_firmware].present?
+        firmware_type = attr.delete(:firmware_type).to_s
+        attr.merge!(process_firmware_attributes(attr[:foreman_firmware], firmware_type)) #, attr[:provision_method]))
+
+        vm.secure_boot_enabled = attr[:secure_boot_enabled]
       end
 
       update_interfaces(vm, attr)
@@ -225,7 +252,7 @@ module ForemanHyperv
       vm.stop turn_off: true
       vm.hard_drives.each { |hdd| hdd.destroy(underlying: true) }
       # TODO: Remove the empty VM folder
-      vm.destroy
+      vm.destroy(vm.path.end_with?(vm.name))
     rescue ActiveRecord::RecordNotFound, Fog::Errors::NotFound
       # if the VM does not exists, we don't really care.
       true
@@ -251,8 +278,9 @@ module ForemanHyperv
         end
       end
 
-      deep_update_required = proc do |old, new|
+      deep_update_required = proc do |path, old, new|
         old.merge(new) do |k, old_v, new_v|
+          k_path = path + [k]
           if %i[allowed_vlan_ids secondary_vlan_ids].include?(k)
             tmp = Fog::Hyperv::Compute::NetworkAdapter.new
 
@@ -261,17 +289,17 @@ module ForemanHyperv
           end
 
           if old_v.is_a?(Hash) && new_v.is_a?(Hash)
-            deep_update_required.call(old_v, new_v)
+            deep_update_required.call(k_path, old_v, new_v)
           elsif old_v.to_s != new_v.to_s
             Rails.logger.debug do
-              "Scheduling compute instance update because #{k} changed it's value from '#{old_v}' (#{old_v.class}) to '#{new_v}' (#{new_v.class})"
+              "Scheduling compute instance update because #{k_path.join('.')} changed it's value from '#{old_v}' (#{old_v.class}) to '#{new_v}' (#{new_v.class})"
             end
             return true
           end
           new_v
         end
       end
-      deep_update_required.call(old_attrs.deep_symbolize_keys, new_attrs.deep_symbolize_keys)
+      deep_update_required.call([], old_attrs.deep_symbolize_keys, new_attrs.deep_symbolize_keys)
 
       false
     end
@@ -310,6 +338,19 @@ module ForemanHyperv
       )
     end
 
+    def vm_compute_attributes(vm)
+      attr = super.slice(
+        :computer_name, :name, :generation,
+        :dynamic_memory_enabled,
+        :memory_maximum, :memory_minimum, :memory_startup,
+        :notes, :processor_count
+      )
+      attr[:foreman_firmware] = vm.foreman_firmware_type
+      attr[:tpm_enabled] = vm.tpm_enabled
+
+      attr
+    end
+
     def set_vm_volumes_attributes(vm, vm_attrs)
       volumes = vm.hard_drives || []
       vm_attrs[:volumes_attributes] = volumes.each_with_index.to_h do |volume, index|
@@ -362,6 +403,14 @@ module ForemanHyperv
       raise Foreman::Exception, 'VM lacks memory maximum' unless attr[:memory_maximum].to_i.positive?
     end
 
+    def generate_secure_boot_settings(firmware)
+      return {} unless firmware.to_s.include?('efi')
+
+      {
+        secure_boot_enabled: firmware.to_s.end_with?('secure_boot')
+      }
+    end
+
     def validate_interfaces(attr)
       interfaces = nested_attributes_for :interfaces, attr[:interfaces_attributes]
       interfaces.reject! { |iface| iface[:_destroy] == '1' }

data/app/views/compute_resources_vms/form/hyperv/_base.html.erb

@@ -14,34 +14,12 @@
     cluster_errors << ex
   end
 -%>
-<% if clusters.any? %>
+<% if clusters.any? -%>
   <%= select_f f, :cluster_name, clusters, :to_s, :to_s, { include_blank: true }, label: _('Cluster'), disabled: !new_host %>
-  <% if computers.count > 1 %>
+  <% if computers.count > 1 -%>
     <%= select_f f, :computer_name, computers, :name, :name, {}, label: _('Computer Name'), disabled: !new_host, onload: 'hypervHostChange(this);', onchange: 'hypervHostChange(this);' %>
   <% end -%>
-<% end %>
-<div class="clearfix">
-  <div class="form-group">
-    <label class="col-md-2 control-label">Available resources</label>
-    <div class="col-md-4 help-block" id="hypervComputerInformation">
-<% computers.each do |host| -%>
-      <table class="hyperv-host-info" style="<%= (host.name == f.object.computer_name) ? '' : 'display: none' %>" data-host="<%= host.name %>">
-        <tbody>
-          <tr>
-            <td>CPU:</td>
-            <td style="padding-left:0.5em;"><%= host.logical_processor_count %></td>
-          </tr>
-          <tr>
-            <td>Memory:</td>
-            <td style="padding-left:0.5em;"><%= number_to_human_size(host.memory_capacity) %></td>
-          </tr>
-        </tbody>
-      </table>
 <% end -%>
-    </div>
-  </div>
-</div>
-
 <% cluster_errors.each do |err| -%>
 <div class="alert alert-warning alert-dismissable">
   <button type="button" class="close" data-dismiss="alert" aria-hidden="true">×</button>
@@ -49,10 +27,22 @@
 </div>
 <% end -%>
 
-<%= select_f f, :generation, hyperv_generations, :first, :last, {}, label: 'Firmware', disabled: !new_host, onchange: 'hypervGenerationChange(this);' %>
-<% if new_host || f.object.generation == :UEFI -%>
-<%= checkbox_f f, :secure_boot_enabled, { label: _('Enable Secure Boot'), disabled: f.object.generation == :BIOS }, 'true', 'false' %>
-<% end -%>
+<%
+  firmware_type = compute_resource.firmware_type(f.object.foreman_firmware, f.object.secure_boot_enabled)
+-%>
+<%= field(f, :foreman_firmware, :label => _('Firmware'), :label_help => _("Choose 'Automatic' to set the firmware based on the PXE loader of the host. If no PXE loader is selected, firmware defaults to BIOS."), :label_size => "col-md-2") do
+  compute_resource.firmware_types.collect do |type, name|
+    enabled = new_vm
+    enabled ||= firmware_type != :bios && type.to_s.start_with?('uefi')
+
+    radio_button_f f, :foreman_firmware, { :checked => (firmware_type == type), :disabled => !enabled, :value => type, :text => _(name) }
+  end.join(' ').html_safe
+end %>
+<%= checkbox_f f, :tpm_enabled, { help_inline: _('Add Virtual TPM module to the VM.'),
+                                  label: _('Virtual TPM'),
+                                  label_help: _('Only compatible with UEFI firmware.'),
+                                  label_size: 'col-md-2' } %>
+<%= select_f f, :boot_device, hyperv_boot_devices, :first, :last, {}, label: _('Boot device'), label_help: _('Has effect only for network based provisioning'), class: 'col-md-2' if new_vm %>
 
 <%= counter_f f, :processor_count, label: _('CPUs'), label_size: 'col-md-2' %>
 <%= byte_size_f f, :memory_startup, label: _('Memory (Startup)'), label_size: 'col-md-2' %>
@@ -61,7 +51,7 @@
 <%= byte_size_f f, :memory_maximum, class: 'col-md-2', label: _('Memory Maximum'), disabled: !f.object.dynamic_memory_enabled %>
 <%= byte_size_f f, :memory_minimum, class: 'col-md-2', label: _('Memory Minimum'), disabled: !f.object.dynamic_memory_enabled %>
 
-<% checked = params[:host] && params[:host][:compute_attributes] && params[:host][:compute_attributes][:start] || '1' %>
+<% checked = params[:host] && params[:host][:compute_attributes] && params[:host][:compute_attributes][:start] || '1' -%>
 <%= checkbox_f f, :start, { checked: (checked == '1'), help_inline: _("Power ON this machine"), label: _('Start'), label_size: "col-md-2"} if new_host && controller_name != "compute_attributes" %>
 
 <%= textarea_f f, :notes, rows: '3', label: _('Notes') %>

data/app/views/compute_resources_vms/form/hyperv/_network.html.erb

@@ -9,26 +9,26 @@
 
 <%# If Access mode %>
 <div data-hyperv-vlan-mode="access" class="<%= 'hide' unless f.object.vlan_operation_mode.to_s == 'Access' %>">
-<%= number_f f, :access_vlan_id, label: _('Access VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Access') %>
+  <%= number_f f, :access_vlan_id, label: _('Access VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Access') %>
 </div>
 <%# If Trunk mode %>
 <div data-hyperv-vlan-mode="trunk" class="<%= 'hide' unless f.object.vlan_operation_mode.to_s == 'Trunk' %>">
-<%= number_f f, :native_vlan_id, label: _('Native VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Trunk') %>
-<%= text_f f, :allowed_vlan_ids, placeholder: '10,20-40,50', label: _('Allowed VLANs'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Trunk') %>
+  <%= number_f f, :native_vlan_id, label: _('Native VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Trunk') %>
+  <%= text_f f, :allowed_vlan_ids, placeholder: '10,20-40,50', label: _('Allowed VLANs'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Trunk') %>
 </div>
 <%# If Private mode %>
 <div data-hyperv-vlan-mode="private" class="<%= 'hide' unless f.object.vlan_operation_mode.to_s == 'Private' %>">
-<%= select_f f, :vlan_private_mode, hyperv_private_vlan_modes, :first, :last, {},
-  label: _('VLAN private mode'), label_size: 'col-md-3', size: 'col-md-8',
-  onchange: 'hypervVLANPrivateModeChange(this);',
-  disabled: (f.object.vlan_operation_mode.to_s != 'Private') %>
-<%= number_f f, :primary_vlan_id, label: _('Primary VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Private') %>
-<%# If Isolated or Community private mode %>
-<div data-hyperv-vlan-private-mode="singular" class="<%= 'hide' if f.object.vlan_private_mode.to_s == 'Promiscuous' %>">
-<%= number_f f, :secondary_vlan_id, label: _('Secondary VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Private' || f.object.vlan_private_mode.to_s == 'Promiscuous') %>
-</div>
-<%# If Promiscuous private mode %>
-<div data-hyperv-vlan-private-mode="plural" class="<%= 'hide' unless f.object.vlan_private_mode.to_s == 'Promiscuous' %>">
-<%= text_f f, :secondary_vlan_ids, placeholder: '10,20-40,50', label: _('Secondary VLANs'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Private' || f.object.vlan_private_mode.to_s != 'Promiscuous') %>
-</div>
+  <%= select_f f, :vlan_private_mode, hyperv_private_vlan_modes, :first, :last, {},
+    label: _('VLAN private mode'), label_size: 'col-md-3', size: 'col-md-8',
+    onchange: 'hypervVLANPrivateModeChange(this);',
+    disabled: (f.object.vlan_operation_mode.to_s != 'Private') %>
+  <%= number_f f, :primary_vlan_id, label: _('Primary VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Private') %>
+  <%# If Isolated or Community private mode %>
+  <div data-hyperv-vlan-private-mode="singular" class="<%= 'hide' if f.object.vlan_private_mode.to_s == 'Promiscuous' %>">
+    <%= number_f f, :secondary_vlan_id, label: _('Secondary VLAN'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Private' || f.object.vlan_private_mode.to_s == 'Promiscuous') %>
+  </div>
+  <%# If Promiscuous private mode %>
+  <div data-hyperv-vlan-private-mode="plural" class="<%= 'hide' unless f.object.vlan_private_mode.to_s == 'Promiscuous' %>">
+    <%= text_f f, :secondary_vlan_ids, placeholder: '10,20-40,50', label: _('Secondary VLANs'), label_size: 'col-md-3', size: 'col-md-8', required: true, disabled: (f.object.vlan_operation_mode.to_s != 'Private' || f.object.vlan_private_mode.to_s != 'Promiscuous') %>
+  </div>
 </div>

data/app/views/compute_resources_vms/form/hyperv/_volume.html.erb

@@ -4,5 +4,5 @@
 <%= f.hidden_field :id %>
 <%= f.hidden_field :basename %>
 <% end -%>
-<%= text_f f, :basename, label: _('Name'), help_inline: _('This is the VHD filename on disk, without extension'), required: true, disabled: f.object.persisted? %>
+<%= text_f f, :basename, label: _('Name'), label_help: _('This is the VHD filename on disk, without extension'), required: true, disabled: f.object.persisted? %>
 <%= byte_size_f f, :size_bytes, label: _('Size') %>

data/lib/foreman_hyperv/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ForemanHyperv
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foreman_hyperv
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexander Olofsson
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement