upstart_service resource
Use the upstart_service
Chef InSpec audit resource to test a service using Upstart.
Availability
Install
This resource is distributed with Chef InSpec and is automatically available for use.Version
This resource first became available in v1.0.0 of InSpec.
Syntax
An upstart_service
resource block declares the name of a service and then one (or more) matchers to test the state of the service:
describe upstart_service('service_name') do
it { should be_installed }
it { should be_enabled }
it { should be_running }
end
where
('service_name')
must specify a service namebe_installed
,be_enabled
, andbe_running
are valid matchers for this resource; all matchers available to theservice
resource may be used
The path to the service manager’s control may be specified for situations where the path isn’t available in the current PATH
. For example:
describe upstart_service('service_name', '/path/to/control') do
it { should be_enabled }
it { should be_installed }
it { should be_running }
end
Matchers
For a full list of available matchers, see our Universal Matchers page.This resource has the following special matchers.
be_enabled
The be_enabled
matcher tests if the named service is enabled:
it { should be_enabled }
be_installed
The be_installed
matcher tests if the named service is installed:
it { should be_installed }
be_running
The be_running
matcher tests if the named service is running:
it { should be_running }