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) 


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

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

#info ⇒ Object 



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

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) 


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

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) 


109
110
111
112
 
# File 'lib/resources/service.rb', line 109

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
87
88
 
# 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)
  when 'aix'
    @service_mgmt = SrcMstr.new(inspec)
  end

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

#to_s ⇒ Object 



114
115
116
 
# File 'lib/resources/service.rb', line 114

def to_s
  "Service #{@service_name}"
end