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.



25
26
27
28
29
30
 
# File 'lib/resources/service.rb', line 25

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) 


85
86
87
88
 
# File 'lib/resources/service.rb', line 85

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

#info ⇒ Object 



78
79
80
81
82
 
# File 'lib/resources/service.rb', line 78

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) 


91
92
93
94
 
# File 'lib/resources/service.rb', line 91

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) 


97
98
99
100
 
# File 'lib/resources/service.rb', line 97

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

#select_package_manager ⇒ Object

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



32
33
34
35
36
37
38
39
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
 
# File 'lib/resources/service.rb', line 32

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 '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 



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

def to_s
  "Service #{@service_name}"
end