app/models/host/managed.rb
class Host::Managed < Host::Base
# audit the changes to this model
audited :except => [:last_report, :last_compile, :lookup_value_matcher, :global_status]
has_associated_audits
# redefine audits relation because of the type change (by default the relation will look for auditable_type = 'Host::Managed')
has_many :audits, -> { where(:auditable_type => 'Host::Base') }, :foreign_key => :auditable_id,
:class_name => 'Audited::Audit'
apipie :class do
name 'Host Managed'
sections only: %w[all additional]
refs 'Host::Managed'
end
include Hostext::PowerInterface
include Hostext::Search
include Hostext::SmartProxy
include Hostext::Token
include Hostext::OperatingSystem
include Hostext::PuppetCA
include SelectiveClone
include HostInfoExtensions
include HostParams
include Facets::ManagedHostExtensions
include ::ForemanRegister::HostExtensions
has_many :reports, :foreign_key => :host_id, :class_name => 'ConfigReport'
has_one :last_report_object, -> { order("#{Report.table_name}.id DESC") }, :foreign_key => :host_id, :class_name => 'ConfigReport'
has_many :all_reports, :foreign_key => :host_id
belongs_to :image
has_many :host_statuses, -> { where.not(type: nil) }, :class_name => 'HostStatus::Status', :foreign_key => 'host_id', :inverse_of => :host, :dependent => :destroy
has_one :configuration_status_object, :class_name => 'HostStatus::ConfigurationStatus', :foreign_key => 'host_id'
has_one :build_status_object, :class_name => 'HostStatus::BuildStatus', :foreign_key => 'host_id'
before_destroy :remove_reports
def self.complete_for(query, opts = {})
matcher = /(\s*(?:(?:user\.[a-z]+)|owner)\s*[=~])\s*(\S*)\s*\z/
matches = matcher.match(query)
output = super(query, opts)
if matches.present? && 'current_user'.start_with?(matches[2])
current_user_result = query.sub(matcher, '\1 current_user')
output = [current_user_result] + output
end
output
end
set_hook :host_created, on: :create
set_hook :host_destroyed, on: :destroy
set_hook :host_updated, on: :update, unless: -> { anonymous_admin_context? }
set_hook :build_entered, if: -> { saved_change_to_build? && build? } do |h|
{ id: h.id, hostname: h.hostname }
end
set_hook :build_exited, if: -> { saved_change_to_build? && !build? } do |h|
{ id: h.id, hostname: h.hostname }
end
set_hook :status_changed, if: -> { saved_change_to_global_status? } do |h|
{ id: h.id, hostname: h.hostname, global_status: { from: h.previous_changes[:global_status][0], to: h.previous_changes[:global_status][1] } }
end
# Define custom hook that can be called in model by magic methods (before, after, around)
define_model_callbacks :build, :only => :after
define_model_callbacks :provision, :only => :before
prepend Hostext::UINotifications
before_validation :refresh_build_status, :if => :build_changed?
# Custom hooks will be executed after_commit
after_commit :build_hooks
before_save :clear_data_on_build
include PxeLoaderValidator
def initialize(attributes = nil, &block)
super(apply_inherited_attributes(attributes, false), &block)
end
def build_hooks
return if previous_changes['build'].nil?
if build?
run_callbacks :build do
logger.debug "custom hook after_build on #{name} will be executed if defined."
true
end
else
run_callbacks :provision do
logger.debug "custom hook before_provision on #{name} will be executed if defined."
true
end
end
end
include HostCommon
smart_proxy_reference :subnet => [:dns_id, :dhcp_id, :tftp_id]
smart_proxy_reference :subnet6 => [:dns_id, :dhcp_id, :tftp_id]
smart_proxy_reference :domain => [:dns_id]
smart_proxy_reference :realm => [:realm_proxy_id]
smart_proxy_reference :self => [:puppet_proxy_id, :puppet_ca_proxy_id]
smart_proxy_reference :infrastructure_facet => [:smart_proxy_id]
graphql_type '::Types::Host'
apipie :class, 'A class representing managed Host object' do
prop_group :basic_model_props, ApplicationRecord, meta: { friendly_name: 'host', name_desc: 'Host FQDN, e.g. my-host.example.com' }
property :architecture, 'Architecture', desc: 'Returns architecture assigned to the host or nil if no architecture is assigned (unmanaged host)'
property :build?, one_of: [true, false], desc: 'Returns true if the host is pending for build, false otherwise'
property :certname, String, desc: 'Returns a name used in puppet certificate, this is usually either equal to FQDN or random UUID if `use_uuid_for_certificates` setting is enabled'
property :compute_resource, 'ComputeResource', desc: 'Returns a compute resource object the host exists in, nil if no compute resource is assigned (e.g. baremetal host)'
property :domain, 'Domain', desc: 'Returns a domain object the host primary interface belongs to, nil if no domain is assigned (unmanaged host)'
property :hostgroup, 'Hostgroup', desc: 'Returns a host group object the host is assigned to, nil if no host group is assigned'
property :interfaces, array_of: ['Nic::Managed'], desc: 'Returns an array of all host interfaces objects'
property :ip, String, desc: 'Returns an IPv4 address of the host primary interface, e.g. "192.168.0.1"'
property :ip6, String, desc: 'Returns an IPv6 address of the host primary interface, e.g. "fe80::200:11ff:fe22:1122"'
property :mac, String, desc: 'Returns a MAC address of the host primary interface, e.g. "52:54:00:bc:c9:ca"'
property :location, 'Location', desc: 'Returns a location object of the host, returns nil if is assigned'
property :model, 'Model', desc: 'Returns a hardware model object of the host'
property :operatingsystem, 'Operatingsystem', desc: "alias of os property"
property :organization, 'Organization', desc: 'Returns an organization object of the host, returns nil if is assigned'
property :os, 'Operatingsystem', desc: 'Return an operating system object assigned to the host, nil if no OS is assigned'
property :otp, String, desc: 'One time password obtained from IPA, used for realm enrollment during provisioning'
property :provision_method, String, desc: 'Returns a provisioning method used for this host, one of "build", "image". Plugins can add additional methods.'
property :ptable, 'Ptable', desc: 'Returns a partition table object assigned to the host, returns nil if none is found'
property :puppet_ca_server, String, desc: 'FQDN of the Puppet CA server used by this host, typically FQDN of the host\'s puppet CA proxy'
property :puppet_server, String, desc: 'FQDN of the Puppet master/server used by this host, typically FQDN of the host\'s puppet proxy'
property :realm, 'Realm', desc: 'Returns a realm object assigned to the host primary interface, returns nil if none is found'
property :shortname, String, desc: 'Host shortname, usually a hostname without the domain part, e.g. my-host'
property :subnet, 'Subnet', desc: 'Returns an IPv4 subnet object assigned to the host primary interface, returns nil if none is found'
property :subnet6, 'Subnet', desc: 'Returns an IPv6 subnet object assigned to the host primary interface, returns nil if none is found'
property :token, String, desc: 'Returns a token used for phone home calls authentication during provisioning'
property :root_pass, String, desc: "Returns host's encrypted password hash"
property :use_image, one_of: [true, false], desc: 'Returns whether provisioning is image based'
property :sp_name, String, desc: "Returns BMC's NIC name"
property :sp_ip, String, desc: 'Returns BMC\'s NIC IP'
property :sp_mac, String, desc: 'Returns BMC\'s NIC MAC'
property :sp_subnet, String, desc: "Returns BMC's NIC subnet"
property :jumpstart_path, String, desc: 'Calculates the jumpstart\'s path in relation to the domain and convert host to an IP'
property :install_path, String, desc: 'Calculates the media\'s path in relation to the domain and convert host to an IP'
property :image_build?, one_of: [true, false], desc: 'Returns true if this host provision method is image, meaning image based provisioning, false otherwise'
property :medium, 'Medium', desc: 'Returns installation medium associated with the host'
property :bmc_nic, 'Nic::BMC', desc: 'Returns BMC interface'
property :templates_used, Array, desc: 'Returns an array with available templates for associated OS'
property :owner, one_of: ['User', 'Usergroup'], desc: 'Returns host\'s owner'
property :owner_type, String, desc: 'Returns host owner\'s type'
property :ssh_authorized_keys, array_of: String, desc: 'Returns an array of host owner\'s SSH authorized keys'
property :pxe_loader, String, desc: 'Returns name of PXE loader, e.g. PXELinux BIOS'
property :pxe_build?, one_of: [true, false], desc: 'Returns true if this host provision method is build, meaning network based provisioning, false otherwise'
property :global_status, Integer, desc: 'Returns numerical representation of the host status'
property :multiboot, String, desc: 'Returns path to multiboot loader'
property :miniroot, String, desc: 'Returns path to the initial RAM disk for this host'
property :puppetca_token, 'Token::PuppetCA', desc: 'Returns Puppet CA token for this host'
property :last_report, 'ActiveSupport::TimeWithZone', desc: 'Returns date object representing time when the last report was made by this host'
property :smart_proxies, array_of: ['SmartProxy'], desc: 'Returns Smart Proxies attached to the host'
property :virtual, one_of: [true, false], desc: 'Returns true if the host is virtual, false otherwise'
property :ram, Integer, desc: 'Returns RAM size of the host in MB'
property :sockets, Integer, desc: 'Returns number of the host\'s sockets'
property :cores, Integer, desc: 'Returns number of the host\'s cores'
property :params, Hash, desc: 'Returns name=value object with host\'s parameters'
property :pxe_loader_efi?, one_of: [true, false], desc: 'Returns true if PXE Loader uses EFI, false otherwise'
property :created_at, 'ActiveSupport::TimeWithZone', desc: 'The time when the host was created'
property :comment, String, desc: 'Returns comment/description of this host'
end
class Jail < ::Safemode::Jail
allow :id, :name, :created_at, :diskLayout, :puppet_server, :puppet_ca_server, :operatingsystem, :os, :ptable, :hostgroup,
:url_for_boot, :hostgroup, :compute_resource, :domain, :ip, :ip6, :mac, :shortname, :architecture,
:model, :certname, :capabilities, :provider, :subnet, :subnet6, :token, :location, :organization, :provision_method,
:image_build?, :pxe_build?, :otp, :realm, :nil?, :indent, :primary_interface,
:provision_interface, :interfaces, :bond_interfaces, :bridge_interfaces, :interfaces_with_identifier,
:managed_interfaces, :facts, :facts_hash, :root_pass, :sp_name, :sp_ip, :sp_mac, :sp_subnet, :use_image,
:multiboot, :jumpstart_path, :install_path, :miniroot, :medium, :bmc_nic, :templates_used, :owner, :owner_type,
:ssh_authorized_keys, :pxe_loader, :global_status, :global_status_label, :get_status, :puppetca_token, :last_report, :build?, :smart_proxies, :host_param,
:virtual, :ram, :sockets, :cores, :params, :pxe_loader_efi?, :comment
end
scope :recent, lambda { |interval = Setting[:outofsync_interval]|
with_last_report_within(interval.to_i.minutes)
}
scope :out_of_sync, lambda { |interval = Setting[:outofsync_interval]|
not_disabled.with_last_report_exceeded(interval.to_i.minutes)
}
scope :out_of_sync_for, lambda { |report_origin|
interval = SettingRegistry.instance.find(:"#{report_origin.downcase}_interval")&.value || Setting[:outofsync_interval]
with_last_report_exceeded(interval.to_i.minutes)
.not_disabled
.with_last_report_origin(report_origin)
}
scope :not_disabled, lambda {
where.not(enabled: false)
}
scope :with_last_report_within, lambda { |minutes|
where(["#{Host.table_name}.last_report > ?", minutes.ago])
}
scope :with_last_report_exceeded, lambda { |minutes|
where(["#{Host.table_name}.last_report < ?", minutes.ago])
}
scope :with_last_report_origin, lambda { |origin|
includes(:last_report_object).where(reports: { origin: origin })
}
scope :with_status, lambda { |status_type|
eager_load(:host_statuses).where(host_status: {type: status_type})
}
scope :with_config_status, lambda {
with_status('HostStatus::ConfigurationStatus')
}
# search for a metric - e.g.:
# Host::Managed.with("failed") --> all reports which have a failed counter > 0
# Host::Managed.with("failed",20) --> all reports which have a failed counter > 20
scope :with, lambda { |*arg|
cond = "(host_status.status >> #{HostStatus::ConfigurationStatus.bit_mask(arg[0].to_s)}) > #{arg[1] || 0}"
with_config_status.where(sanitize_sql(cond))
}
scope :with_error, lambda {
cond = "(host_status.status > 0) and (
#{HostStatus::ConfigurationStatus.is('failed')} or
#{HostStatus::ConfigurationStatus.is('failed_restarts')}
)"
with_config_status.where(sanitize_sql(cond))
}
scope :without_error, lambda {
cond = "#{HostStatus::ConfigurationStatus.is_not('failed')} and
#{HostStatus::ConfigurationStatus.is_not('failed_restarts')}"
with_config_status.where(sanitize_sql(cond))
}
scope :with_changes, lambda {
cond = "(host_status.status > 0) and (
#{HostStatus::ConfigurationStatus.is('applied')} or
#{HostStatus::ConfigurationStatus.is('restarted')})"
with_config_status.where(sanitize_sql(cond))
}
scope :without_changes, lambda {
cond = "#{HostStatus::ConfigurationStatus.is_not('applied')} and
#{HostStatus::ConfigurationStatus.is_not('restarted')}"
with_config_status.where(sanitize_sql(cond))
}
scope :with_pending_changes, lambda {
cond = "(host_status.status > 0) AND (#{HostStatus::ConfigurationStatus.is('pending')})"
with_config_status.where(sanitize_sql(cond))
}
scope :without_pending_changes, lambda {
with_config_status.where(sanitize_sql(HostStatus::ConfigurationStatus.is_not('pending').to_s))
}
scope :successful, -> { without_changes.without_error.without_pending_changes }
scope :alerts_disabled, -> { where(:enabled => false) }
scope :alerts_enabled, -> { where(:enabled => true) }
scope :run_distribution, lambda { |fromtime, totime|
if fromtime.nil? || totime.nil?
raise ::Foreman.Exception.new(N_("invalid time range"))
else
joins("INNER JOIN reports ON reports.host_id = hosts.id").where("reports.reported_at BETWEEN ? AND ?", fromtime, totime)
end
}
scope :with_any_reports_between, lambda { |from, to|
joins(:all_reports).where("reports.reported_at BETWEEN ? AND ?", from, to)
}
scope :for_vm, ->(cr, vm) { where(:compute_resource_id => cr.id, :uuid => Array.wrap(vm).compact.map(&:identity).map(&:to_s)) }
scope :with_compute_resource, -> { where.not(:compute_resource_id => nil).where.not(:uuid => nil) }
scope :in_build_mode, -> { where(build: true) }
scope :with_build_errors, -> { where.not(build_errors: nil) }
# some shortcuts
alias_attribute :arch, :architecture
validates :organization_id, :presence => true, :if => proc { |host| host.managed? }
validates :location_id, :presence => true, :if => proc { |host| host.managed? }
validate :compute_resource_in_taxonomy, :if => proc { |host| host.managed? && host.compute_resource_id.present? }
# define before orchestration is included so we can prepare object before VM is tried to be deleted
before_destroy :disassociate!, :if => proc { |host| host.uuid && !Setting[:destroy_vm_on_host_delete] }
# handles all orchestration of smart proxies.
include Orchestration
# DHCP orchestration delegation
delegate :dhcp?, :dhcp_records, :to => :primary_interface
# DNS orchestration delegation
delegate :dns?, :dns6?, :reverse_dns?, :reverse_dns6?, :dns_record, :to => :primary_interface
# IP delegation
delegate :mac_based_ipam?, :required_ip_addresses_set?, :compute_provides_ip?, :ip_available?, :ip6_available?, :to => :primary_interface
include Orchestration::Compute
include Rails.application.routes.url_helpers
# TFTP orchestration delegation
delegate :tftp?, :tftp6?, :tftp, :tftp6, :generate_pxe_template, :to => :provision_interface
include Orchestration::PuppetCA
include Orchestration::SshProvision
include Orchestration::Realm
include HostTemplateHelpers
delegate :require_ip4_validation?, :require_ip6_validation?, :to => :provision_interface
validates :architecture_id, :presence => true, :if => proc { |host| host.managed }
validates :root_pass, :length => {:minimum => 8, :message => N_('should be 8 characters or more')},
:presence => {:message => N_('should not be blank - consider setting a global or host group default')},
:if => proc { |host| host.managed && !host.image_build? && build? }
validates :ptable_id, :presence => {:message => N_("can't be blank unless a custom partition has been defined")},
:if => proc { |host| host.managed && host.disk.empty? && !Foreman.in_rake? && !host.image_build? && host.build? }
validates :provision_method, :inclusion => {:in => proc { provision_methods }, :message => N_('is unknown')}, :if => proc { |host| host.managed? }
validates :medium_id, :presence => true,
:if => proc { |host| host.validate_media? }
validates :medium_id, :inclusion => {:in => proc { |host| host.operatingsystem.medium_ids },
:message => N_('must belong to host\'s operating system')},
:if => proc { |host| host.operatingsystem && host.medium }
validate :provision_method_in_capabilities
validate :short_name_periods
validate :check_interfaces
before_validation :set_compute_attributes, :on => :create, :if => proc { compute_attributes_empty? }
validate :check_if_provision_method_changed, :on => :update, :if => proc { |host| host.managed }
validates :uuid, uniqueness: { :allow_blank => true }
before_validation :set_hostgroup_defaults, :set_ip_address
after_validation :ensure_associations
before_validation :set_certname, :if => proc { |h| h.managed? && Setting[:use_uuid_for_certificates] }
after_validation :trigger_nic_orchestration, :if => proc { |h| h.managed? && h.changed? }, :on => :update
before_validation :validate_dns_name_uniqueness
def <=>(other)
name <=> other.name
end
def owner_name
owner.try(:name)
end
def self.model_name
ActiveModel::Name.new(Host)
end
# Permissions introduced by plugins for this class can cause resource <-> permission
# names mapping to fail randomly so as a safety precaution, we specify the name more explicitly.
def self.find_permission_name(action)
"#{action}_hosts"
end
def clear_reports
# Remove any reports that may be held against this host
Report.where(host_id: id).delete_all
self.last_report = nil
end
def clear_facts
FactValue.where(host_id: id).delete_all
end
def clear_data_on_build
return unless respond_to?(:old) && old && build? && !old.build?
clear_facts
clear_reports
reported_data&.destroy
self.build_errors = nil
end
# Called from the host build post install process to indicate that the base build has completed
# Build is cleared and the boot link and autosign entries are removed
# A site specific build script is called at this stage that can do site specific tasks
def built(installed = true)
# delete all expired tokens
self.build = false
self.otp = nil
self.installed_at = Time.now.utc if installed
if save
send_built_notification if installed
true
else
logger.warn "Failed to set Build on #{self}: #{errors.full_messages}"
false
end
end
# Request a new OTP for a host
def handle_realm
return true unless realm?
# If no OTP is set, then this is probably a rebuild
if otp.blank?
logger.info "Setting realm for host #{name}"
set_realm :rebuild => true
save!
else
true
end
end
def disk_layout_source
@disk_layout_source ||= if disk.present?
Foreman::Renderer::Source::String.new(name: 'Custom disk layout',
content: disk.tr("\r", ''))
elsif ptable.present?
Foreman::Renderer::Source::Database.new(ptable)
end
end
apipie :method, 'Returns the host rendered partition table' do
desc 'It either uses custom partition table specified on host object itself
or the one assigned as a partition table via operating system'
raises error: Foreman::Exception, desc: 'If custom partition table was not specified and no partition table is assigned to host operating system family'
returns String, desc: 'Evaluated partition table'
example '@host.diskLayout # =>
"zerombr
clearpart --all --initlabel
autopart"', desc: 'to render the content of host partition table'
example '<% save_to_file "/root/ptable_debug", @host.diskLayout %>', desc: 'A snippet that could be used to store a file in shell script or kickstart %post section to save host partition table for debugging purposes'
end
def diskLayout
raise Foreman::Exception, 'Neither disk nor partition table defined for host' unless disk_layout_source
scope = Foreman::Renderer.get_scope(host: self, source: disk_layout_source)
Foreman::Renderer.render(disk_layout_source, scope)
end
# reports methods
def error_count
%w[failed failed_restarts].sum { |f| status f }
end
def no_report
last_report.nil? || last_report < Time.now.utc - origin_interval.minutes && enabled?
end
def origin_interval
SettingRegistry.instance.find(:"#{last_report.origin.downcase}_interval")&.value || 0
end
def disabled?
!enabled?
end
# Determine if host is setup for configuration
def configuration?
puppet_proxy_id.present?
end
def attributes_to_import_from_facts
attrs = [:architecture]
if Setting[:update_hostgroup_from_facts]
attrs << :hostgroup
end
if !Setting[:ignore_facts_for_operatingsystem] || (Setting[:ignore_facts_for_operatingsystem] && operatingsystem.blank?)
attrs << :operatingsystem
end
if !Setting[:ignore_facts_for_domain] || (Setting[:ignore_facts_for_domain] && domain.blank?)
attrs << :domain
end
super + attrs
end
def populate_fields_from_facts(parser, type, source_proxy)
super
update_os_from_facts if operatingsystem_id_changed?
populate_facet_fields(parser, type, source_proxy)
end
# Called by build link in the list
# Build is set
# The boot link and autosign entry are created
# Any existing puppet certificates are deleted
# Any facts are discarded
def setBuild
self.build = true
self.initiated_at = Time.now.utc
logger.warn("Set build failed: #{errors.inspect}") unless save
errors.empty?
end
def self.provision_methods
{
'build' => N_('Network Based'),
'image' => N_('Image Based'),
}.merge(registered_provision_methods)
end
def self.registered_provision_methods
Foreman::Plugin.all.map(&:provision_methods).inject(:merge) || {}
end
def self.valid_rebuild_only_values
if Host::Managed.respond_to?(:rebuild_methods)
Nic::Managed.rebuild_methods.values + Host::Managed.rebuild_methods.values
else
Nic::Managed.rebuild_methods.values
end
end
def can_be_built?
managed? && !image_build? && !build?
end
def hostgroup_inherited_attributes
%w{puppet_proxy_id puppet_ca_proxy_id compute_profile_id realm_id compute_resource_id}
end
def apply_inherited_attributes(attributes, initialized = true)
return nil unless attributes
attributes = hash_clone(attributes).with_indifferent_access
new_hostgroup_id = attributes['hostgroup_id'] || attributes['hostgroup_name'] || attributes['hostgroup'].try(:id)
# hostgroup didn't change, no inheritance needs update.
return attributes if new_hostgroup_id.blank?
new_hostgroup = hostgroup if initialized
unless [new_hostgroup.try(:id), new_hostgroup.try(:friendly_id)].include? new_hostgroup_id
new_hostgroup = Hostgroup.friendly.find(new_hostgroup_id)
end
return attributes unless new_hostgroup
inherited_attributes = hostgroup_inherited_attributes - attributes.keys
inherited_attributes.each do |attribute|
value = new_hostgroup.send("inherited_#{attribute}")
attributes[attribute] = value
end
apply_facet_attributes(new_hostgroup, attributes)
end
def hash_clone(value)
if value.is_a? Hash
# Prefer dup to constructing a new object to perserve permitted state
# when `value` is an ActionController::Parameters instance
new_hash = value.dup
new_hash.each { |k, v| new_hash[k] = hash_clone(v) }
return new_hash
end
value
end
def set_hostgroup_defaults(force = false)
return unless hostgroup
assign_hostgroup_attributes(inherited_attributes, force)
end
def inherited_attributes
inherited_attrs = %w{domain_id operatingsystem_id architecture_id compute_resource_id}
inherited_attrs << "subnet_id" unless compute_provides?(:ip)
inherited_attrs << "subnet6_id" unless compute_provides?(:ip6)
inherited_attrs.concat(%w{medium_id ptable_id pxe_loader}) unless image_build?
inherited_attrs
end
def set_compute_attributes
if compute_profile_present?
self.compute_attributes = compute_resource.compute_profile_attributes_for(compute_profile_id)
elsif compute_resource
self.compute_attributes ||= {}
end
end
def set_ip_address
return unless new_record? || managed?
interfaces.select { |nic| nic.managed }.each do |nic|
nic.ip = nic.subnet.unused_ip(mac).suggest_ip if nic.subnet.present? && nic.ip.blank?
nic.ip6 = nic.subnet6.unused_ip(mac).suggest_ip if nic.subnet6.present? && nic.ip6.blank?
end
end
def associate!(cr, vm)
self.uuid = vm.identity
self.compute_resource_id = cr.id
save!(:validate => false) # don't want to trigger callbacks
end
def disassociate!
self.uuid = nil
self.compute_resource_id = nil
save!(:validate => false) # don't want to trigger callbacks
end
# if certname does not exist, use hostname instead
def certname
self[:certname] || name
end
apipie :method, 'Returns the list of provisioning capabilities of this host based on its compute resource' do
returns array_of: Symbol, desc: 'Returns an array of symbols, representing capabilities of this host based on its compute resource.
* `:build` means network based provisioning
* `:image` means image based provisioning
* `:new_volume` allows adding additional storage volumes'
end
def capabilities
compute_resource ? compute_resource.capabilities : bare_metal_capabilities
end
def bare_metal_capabilities
[:build]
end
apipie :method, 'Returns the compute resource type or BareMetal for non virtualized hosts' do
returns String, desc: 'String representing the provider, BareMetal for non virtualized hosts'
example '@host.provider # => "VMware"'
example '<% case @host.provider %>
<% when "BareMetal" %>
echo "This is BareMetal"
<% when "VMware" %>
echo "This is VMware VM"
<% when "Google" %>
echo "This is VM running in Google cloud"
<% when "EC2" %>
echo "This is VM running in Amazon cloud"
<% else %>
<% end %>'
end
def provider
if compute_resource_id
compute_resource.provider_friendly_name
else
"BareMetal"
end
end
# no need to store anything in the db if the password is our default
def root_pass
return self[:root_pass] if self[:root_pass].present?
return hostgroup.try(:root_pass) if hostgroup.try(:root_pass).present?
crypt_pass(Setting[:root_pass], :root)
end
def root_pass_source
return N_("host") if root_pass_present?
return N_("hostgroup") if hostgroup.try(:root_pass_present?)
return N_("global setting") if Setting[:root_pass].present?
nil
end
include_in_clone :host_parameters, :lookup_values
exclude_from_clone :name, :uuid, :certname, :last_report, :lookup_value_matcher
def clone
# do not copy system specific attributes
host = selective_clone
host.interfaces = interfaces.map(&:clone)
if compute_resource
host.compute_attributes = host.compute_resource.vm_compute_attributes_for(uuid)
end
host.refresh_global_status
host
end
def check_interfaces
errors.add(:base, _("An interface marked as provision is missing")) if interfaces.detect(&:provision).nil?
errors.add(:base, _("An interface marked as primary is missing")) if interfaces.detect(&:primary).nil?
end
def bmc_nic
interfaces.bmc.first
end
def sp_ip
bmc_nic.try(:ip)
end
def sp_mac
bmc_nic.try(:mac)
end
def sp_subnet_id
bmc_nic.try(:subnet_id)
end
def sp_subnet
bmc_nic.try(:subnet)
end
def sp_name
bmc_nic.try(:name)
end
def vm_compute_attributes
compute_resource ? compute_resource.vm_compute_attributes_for(uuid) : nil
end
def bmc_proxy
@bmc_proxy ||= bmc_nic.proxy
end
def bmc_available?
ipmi = bmc_nic
return false if ipmi.nil?
(ipmi.credentials_present? && %w(IPMI Redfish).include?(ipmi.provider)) || ipmi.provider == 'SSH'
end
alias_method :bmc_available, :bmc_available?
def ipmi_boot(booting_device)
unless bmc_available?
raise Foreman::Exception.new(
_("No BMC NIC available for host %s") % self)
end
bmc_proxy.boot({:function => 'bootdevice', :device => booting_device})
end
# take from hostgroup if compute_profile_id is nil
def compute_profile_id
self[:compute_profile_id] || hostgroup.try(:compute_profile_id)
end
def provision_method
self[:provision_method] || capabilities.first.to_s
end
def explicit_pxe_loader
self[:pxe_loader].presence
end
def pxe_loader
explicit_pxe_loader || hostgroup.try(:pxe_loader)
end
def pxe_loader_efi?
pxe_loader.include?('EFI')
end
def image_build?
provision_method == 'image'
end
def pxe_build?
provision_method == 'build'
end
def validate_media?
managed && !image_build? && build?
end
def build_status_checker
build_status = HostBuildStatus.new(self)
build_status.check_all_statuses
build_status
end
def refresh_global_status
self.global_status = build_global_status.status
end
def refresh_global_status!
refresh_global_status
save!(:validate => false)
end
def refresh_statuses(which = HostStatus.status_registry)
which.each do |status_class|
status = get_status(status_class)
status.refresh! if status.relevant?
end
host_statuses.reload
refresh_global_status!
end
apipie :method, 'Used to retrieve a host status object by given status string' do
required :type, String, 'Type of the host status to retrieve, e.g. "HostStatus::BuildStatus"'
returns 'HostStatus', desc: 'Host status object. Can be used to retrieve additional information'
example '@host.get_status("HostStatus::BuildStatus").reported_at.to_s # => "2020-05-15 21:16:00 UTC'
end
def get_status(type)
status = host_statuses.detect { |s| s.type == type.to_s }
return status unless status.nil?
host_statuses.new(:host => self, :type => type.to_s)
end
def build_global_status(options = {})
HostStatus::Global.build(host_statuses, options)
end
def global_status_label(options = {})
HostStatus::Global.build(host_statuses, options).to_label
end
def configuration_status(options = {})
@configuration_status ||= get_status(HostStatus::ConfigurationStatus).to_status(options)
end
def configuration_status_label(options = {})
@configuration_status_label ||= get_status(HostStatus::ConfigurationStatus).to_label(options)
end
def build_status(options = {})
@build_status ||= get_status(HostStatus::BuildStatus).to_status(options)
end
def build_status_label(options = {})
@build_status_label ||= get_status(HostStatus::BuildStatus).to_label(options)
end
# rebuilds orchestration configuration for a host
# takes all the methods from Orchestration modules that are registered for configuration rebuild
# arguments:
# => only : Array of rebuild methods to execute (Example: ['TFTP'])
# returns : Hash with 'true' if rebuild was a success for a given key (Example: {"TFTP" => true, "DNS" => false})
def recreate_config(only = nil)
result = {}
Nic::Managed.rebuild_methods_for(only).map do |method, pretty_name|
interfaces.map do |interface|
value = interface.send method
result[pretty_name] = value if !result.has_key?(pretty_name) || (result[pretty_name] && !value)
end
end
self.class.rebuild_methods_for(only).map do |method, pretty_name|
raise ::Foreman::Exception.new(N_("There are orchestration modules with methods for configuration rebuild that have identical name: '%s'"), pretty_name) if result[pretty_name]
result[pretty_name] = send method
end
result
end
def apply_compute_profile(modification)
modification.run(self, compute_resource.try(:compute_profile_for, compute_profile_id))
end
def firmware_type
return unless pxe_loader.present?
Operatingsystem.firmware_type(pxe_loader)
end
def compute_resource_or_model
return compute_resource.name if compute_resource
hardware_model_name
end
def local_boot_template_name(kind)
key = "local_boot_#{kind}"
host_params[key] || host_params[key.downcase] || Setting[key]
end
# Permissions introduced by plugins for this class can cause resource <-> permission
# names mapping to fail randomly so as a safety precaution, we specify the name more explicitly.
def permission_name(action)
"#{action}_hosts"
end
private
def update_os_from_facts
operatingsystem.architectures << architecture if operatingsystem && architecture && !operatingsystem.architectures.include?(architecture)
self.medium = nil if medium&.operatingsystems&.exclude?(operatingsystem)
end
def compute_profile_present?
!(compute_profile_id.nil? || compute_resource_id.nil?)
end
def compute_attributes_empty?
compute_attributes.blank?
end
# validate uniqueness can't prevent saving two interfaces that has same DNS name
# because the validation happens before transaction is committed, so data are not in DB
# yet, this is the reason why we "reimplement" uniqueness validation
def validate_dns_name_uniqueness
dups = interfaces.select { |i| !i.marked_for_destruction? }.group_by { |i| [i.name, i.domain_id] }.detect { |dns, nics| dns.first.present? && nics.count > 1 }
if dups.present?
dups.last.first.errors.add(:name, :taken)
errors.add :interfaces, _('Some interfaces are invalid')
throw :abort
end
end
def assign_hostgroup_attributes(attrs = [], force = false)
attrs.each do |attr|
next if send(attr).to_i == -1
value = hostgroup.send("inherited_#{attr}")
assign_hostgroup_attribute attr, value, force
end
end
def assign_hostgroup_attribute(attr, value, force)
send("#{attr}=", value) if force || send(attr).blank?
end
# checks if the host association is a valid association for this host
def ensure_associations
status = true
if managed? && os && !image_build?
%w{ptable medium architecture}.each do |e|
value = send(e.to_sym)
next if value.blank?
unless os.send(e.pluralize.to_sym).include?(value)
errors.add("#{e}_id".to_sym, _("%{value} does not belong to %{os} operating system") % { :value => value, :os => os })
status = false
end
end
end
status
end
def set_certname
self.certname = Foreman.uuid if self[:certname].blank? || new_record?
end
def provision_method_in_capabilities
return unless managed?
methods_available = capabilities.map(&:to_s)
errors.add(:provision_method, _('is an unsupported provisioning method, available: %s') % methods_available.join(',')) unless methods_available.include?(provision_method)
end
def check_if_provision_method_changed
if provision_method_changed? && !provision_method_changed?(from: nil, to: capabilities.first.to_s)
errors.add(:provision_method, _("can't be updated after host is provisioned"))
end
end
def short_name_periods
errors.add(:name, _("must not include periods")) if (managed? && shortname && shortname.include?("."))
end
# we need this so when attribute like build changes we trigger tftp orchestration so token is updated on tftp
# but we should trigger it only for existing records and unless interfaces also changed (then validation is run
# on them automatically)
def trigger_nic_orchestration
primary_interface.valid? if primary_interface && !primary_interface.changed?
unless provision_interface.nil?
return if primary_interface == provision_interface
provision_interface.valid? if provision_interface && !provision_interface.changed?
end
end
# For performance reasons logs and reports are deleted in batch
# see http://projects.theforeman.org/issues/8316 for details
def remove_reports
host_reports = Report.where(host_id: id)
Log.where(report_id: host_reports.pluck(:id)).delete_all
host_reports.delete_all
end
def refresh_build_status
refresh_method = if new_record?
'refresh'
else
'refresh!'
end
get_status(HostStatus::BuildStatus).send(refresh_method)
end
def extract_params_from_object_ancestors(object)
params = []
object_parameters_symbol = "#{object.class.to_s.downcase}_parameters".to_sym
object.class.sort_by_ancestry(object.ancestors).each { |o| params += o.send(object_parameters_symbol).authorized(:view_params) }
params += object.send(object_parameters_symbol).authorized(:view_params)
params
end
def send_built_notification
recipients = owner ? owner.recipients_for(:host_built) : []
MailNotification[:host_built].deliver(self, :users => recipients) if recipients.present?
rescue SocketError, Net::SMTPError => e
Foreman::Logging.exception("Host has been created. Failed to send email", e)
end
# Ensures that object assigned in the association belongs to the taxonomies of the host.
# Returns true if it does, otherwise it adds a validation error and returns false.
def validate_association_taxonomy(association_name)
association = self.class.reflect_on_association(association_name)
raise ArgumentError, "Association #{association_name} not found" unless association
associated_object_id = public_send(association.foreign_key)
if associated_object_id.present? &&
association.klass.with_taxonomy_scope(organization, location).find_by(id: associated_object_id).blank?
errors.add(association.foreign_key, _("with id %{object_id} doesn't exist or is not assigned to proper organization and/or location") % { :object_id => associated_object_id })
false
else
true
end
end
def compute_resource_in_taxonomy
validate_association_taxonomy(:compute_resource)
end
def root_pass_present?
self[:root_pass].present?
end
end