- Included in:
- Defined in:
This module is responsible for encapsulating the logic for “locking” the puppet agent during a catalog run; in other words, keeping track of enough state to answer the question “is there a puppet agent currently applying a catalog?”
The implementation involves writing a lockfile whose contents are simply the PID of the running agent process. This is considered part of the public Puppet API because it used by external tools such as mcollective.
For more information, please see docs on the website.
Instance Method Summary collapse
#lock ⇒ Object
Yield if we get a lock, else raise Puppet::LockError.
- #lockfile_path ⇒ Object
- #running? ⇒ Boolean deprecated Deprecated.
Instance Method Details
Yield if we get a lock, else raise Puppet::LockError. Return value of block yielded.
18 19 20 21 22 23 24 25 26 27 28
# File 'lib/puppet/agent/locker.rb', line 18 def lock if lockfile.lock begin yield ensure lockfile.unlock end else fail Puppet::LockError, _('Failed to acquire lock') end end
41 42 43
# File 'lib/puppet/agent/locker.rb', line 41 def lockfile_path @lockfile_path ||= Puppet[:agent_catalog_run_lockfile] end
#running? ⇒ Boolean
31 32 33 34 35 36 37 38 39
# File 'lib/puppet/agent/locker.rb', line 31 def running? #TRANSLATORS 'Puppet::Agent::Locker.running?' is a method name and should not be translated = _('Puppet::Agent::Locker.running? is deprecated as it is inherently unsafe.') #TRANSLATORS 'LockError' should not be translated += ' ' + _('The only safe way to know if the lock is locked is to try lock and perform some '\ 'action and then handle the LockError that may result.') Puppet.deprecation_warning() lockfile.locked? end