Class: Service

Inherits:
Object
  • Object
show all
Defined in:
lib/resources/service.rb

Overview

Usage: describe service(‘dhcp’) do

it { should be_enabled }
it { should be_installed }
it { should be_running }

end

We detect the init system for each operating system, based on the operating system.

Fedora 15 : systemd RedHat 7 : systemd Ubuntu 15.04 : systemd Ubuntu < 15.04 : upstart

TODO: extend the logic to detect the running init system, independently of OS

Instance Method Summary collapse

Constructor Details

#initialize(service_name) ⇒ Service

Returns a new instance of Service.



33
34
35
36
37
38
 
# File 'lib/resources/service.rb', line 33

def initialize(service_name)
  @service_name = service_name
  @service_mgmt = nil
  @cache = nil
  select_package_manager
end

Instance Method Details

#enabled?(_level = nil) ⇒ Boolean

verifies the service is enabled

Returns:

  • (Boolean) 


95
96
97
98
 
# File 'lib/resources/service.rb', line 95

def enabled?(_level = nil)
  return false if info.nil?
  info[:enabled]
end

#info ⇒ Object 



88
89
90
91
92
 
# File 'lib/resources/service.rb', line 88

def info
  return @cache if !@cache.nil?
  return nil if @service_mgmt.nil?
  @cache = @service_mgmt.info(@service_name)
end

#installed?(_name = nil, _version = nil) ⇒ Boolean

verifies the service is registered

Returns:

  • (Boolean) 


101
102
103
104
 
# File 'lib/resources/service.rb', line 101

def installed?(_name = nil, _version = nil)
  return false if info.nil?
  info[:installed]
end

#running?(_under = nil) ⇒ Boolean

verifies the service is currently running

Returns:

  • (Boolean) 


107
108
109
110
 
# File 'lib/resources/service.rb', line 107

def running?(_under = nil)
  return false if info.nil?
  info[:running]
end

#select_package_manager ⇒ Object

rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity



40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/resources/service.rb', line 40

def select_package_manager # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
  family = inspec.os[:family]

  case family
  # Ubuntu
  # @see: https://wiki.ubuntu.com/SystemdForUpstartUsers
  # Ubuntu 15.04 : Systemd
  #   Systemd runs with PID 1 as /sbin/init.
  #   Upstart runs with PID 1 as /sbin/upstart.
  # Ubuntu < 15.04 : Upstart
  # Upstart runs with PID 1 as /sbin/init.
  # Systemd runs with PID 1 as /lib/systemd/systemd.
  when 'ubuntu'
    version = inspec.os[:release].to_f
    if version < 15.04
      @service_mgmt = Upstart.new(inspec)
    else
      @service_mgmt = Systemd.new(inspec)
    end
  when 'debian'
    version = inspec.os[:release].to_i
    if version > 7
      @service_mgmt = Systemd.new(inspec)
    else
      @service_mgmt = SysV.new(inspec)
    end
  when 'redhat', 'fedora', 'centos'
    version = inspec.os[:release].to_i
    if (%w{ redhat centos }.include?(family) && version >= 7) || (family == 'fedora' && version >= 15)
      @service_mgmt = Systemd.new(inspec)
    else
      @service_mgmt = SysV.new(inspec)
    end
  when 'wrlinux'
    @service_mgmt = SysV.new(inspec)
  when 'darwin'
    @service_mgmt = LaunchCtl.new(inspec)
  when 'windows'
    @service_mgmt = WindowsSrv.new(inspec)
  when 'freebsd'
    @service_mgmt = BSDInit.new(inspec)
  when 'arch', 'opensuse'
    @service_mgmt = Systemd.new(inspec)
  end

  return skip_resource 'The `service` resource is not supported on your OS yet.' if @service_mgmt.nil?
end

#to_s ⇒ Object 



112
113
114
 
# File 'lib/resources/service.rb', line 112

def to_s
  "Service #{@service_name}"
end