inspec/docs/resources/apache.md.erb
Clinton Wolfe 82cafccebb Remove enclosing HTML and re-render
Signed-off-by: Clinton Wolfe <clintoncwolfe@gmail.com>
2019-06-03 11:56:34 -04:00

77 lines
1.7 KiB
Text

---
title: About the apache Resource
platform: linux
---
# apache
**Warning**:This resource is deprecated and should not be used. It was removed in Chef InSpec 4.0. The documentation below is preserved as a reference. Replacement functionality is available in the [`apache_conf`](/docs/reference/resources/apache_conf) resource.
Use the `apache` Chef InSpec audit resource to test the state of the Apache server on Linux/Unix systems.
<br>
## Availability
### Installation
This resource was distributed along with Chef InSpec itself.
### Version
This resource first became available in v1.51.15 of InSpec and was removed in version 4.0.
## Syntax
An `apache` Chef InSpec audit resource block declares settings that should be tested:
describe apache do
its('setting_name') { should cmp 'value' }
end
where
* `'setting_name'` is description of the Apache configuration file
* `{ should cmp 'value' }` is the value that is expected
<br>
## Properties
* `service`, `conf_dir`, `conf_path`, `user`
<br>
## Property Examples
The following examples show how to use this Chef InSpec audit resource.
### Test the service name.
describe apache do
its ('service') { should cmp 'apache2' }
end
### Test the configuration location
describe apache do
its ('conf_dir') { should cmp '/etc/apache2' }
end
### Test the path of the configuration file
describe apache do
its ('conf_path') { should cmp '/etc/apache2/apache2.conf' }
end
### Test the apache user
describe apache do
its ('user') { should cmp 'www-data' }
end
<br>
## Matchers
For a full list of available matchers, please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).