Class: Chef::Application::WindowsService

Inherits:
Win32::Daemon
  • Object
show all
Includes:
Mixin::ShellOut, Mixlib::CLI
Defined in:
lib/chef/application/windows_service.rb

Instance Method Summary collapse

Methods included from Mixin::ShellOut

#a_to_s, #clean_array, #shell_out, #shell_out!, #shell_out_compact, #shell_out_compact!, #shell_out_compact_timeout, #shell_out_compact_timeout!, #shell_out_with_systems_locale, #shell_out_with_systems_locale!

Methods included from Mixin::PathSanity

#enforce_path_sanity, #sanitized_path

Instance Method Details

#service_initObject


64
65
66
67
68
69
70
# File 'lib/chef/application/windows_service.rb', line 64

def service_init
  @service_action_mutex = Mutex.new
  @service_signal = ConditionVariable.new

  reconfigure
  Chef::Log.info("Chef Client Service initialized")
end

#service_main(*startup_parameters) ⇒ Object


72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# File 'lib/chef/application/windows_service.rb', line 72

def service_main(*startup_parameters)
  # Chef::Config is initialized during service_init
  # Set the initial timeout to splay sleep time
  timeout = rand Chef::Config[:splay]

  while running?
    # Grab the service_action_mutex to make a chef-client run
    @service_action_mutex.synchronize do
      begin
        Chef::Log.info("Next chef-client run will happen in #{timeout} seconds")
        @service_signal.wait(@service_action_mutex, timeout)

        # Continue only if service is RUNNING
        next if state != RUNNING

        # Reconfigure each time through to pick up any changes in the client file
        Chef::Log.info("Reconfiguring with startup parameters")
        reconfigure(startup_parameters)
        timeout = Chef::Config[:interval]

        # Honor splay sleep config
        timeout += rand Chef::Config[:splay]

        # run chef-client only if service is in RUNNING state
        next if state != RUNNING

        Chef::Log.info("Chef-Client service is starting a chef-client run...")
        run_chef_client
      rescue SystemExit => e
        # Do not raise any of the errors here in order to
        # prevent service crash
        Chef::Log.error("#{e.class}: #{e}")
      rescue Exception => e
        Chef::Log.error("#{e.class}: #{e}")
      end
    end
  end

  # Daemon class needs to have all the signal callbacks return
  # before service_main returns.
  Chef::Log.debug("Giving signal callbacks some time to exit...")
  sleep 1
  Chef::Log.debug("Exiting service...")
end

#service_pauseObject


145
146
147
148
149
150
151
152
153
154
155
156
157
# File 'lib/chef/application/windows_service.rb', line 145

def service_pause
  Chef::Log.info("PAUSE request from operating system.")

  # We don't need to wake up the service_main if it's waiting
  # since this is a PAUSE signal.

  if @service_action_mutex.locked?
    Chef::Log.info("Currently a chef-client run is happening.")
    Chef::Log.info("Service will pause once it's completed.")
  else
    Chef::Log.info("Service is pausing....")
  end
end

#service_resumeObject


159
160
161
162
163
164
165
# File 'lib/chef/application/windows_service.rb', line 159

def service_resume
  # We don't need to wake up the service_main if it's waiting
  # since this is a RESUME signal.

  Chef::Log.info("RESUME signal received from the OS.")
  Chef::Log.info("Service is resuming....")
end

#service_shutdownObject


167
168
169
170
171
172
173
# File 'lib/chef/application/windows_service.rb', line 167

def service_shutdown
  Chef::Log.info("SHUTDOWN signal received from the OS.")

  # Treat shutdown similar to stop.

  service_stop
end

#service_stopObject

Control Signal Callback Methods


121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# File 'lib/chef/application/windows_service.rb', line 121

def service_stop
  run_warning_displayed = false
  Chef::Log.info("STOP request from operating system.")
  loop do
    # See if a run is in flight
    if @service_action_mutex.try_lock
      # Run is not in flight. Wake up service_main to exit.
      @service_signal.signal
      @service_action_mutex.unlock
      break
    else
      unless run_warning_displayed
        Chef::Log.info("Currently a chef run is happening on this system.")
        Chef::Log.info("Service  will stop when run is completed.")
        run_warning_displayed = true
      end

      Chef::Log.debug("Waiting for chef-client run...")
      sleep 1
    end
  end
  Chef::Log.info("Service is stopping....")
end