inspec-core 2.2.55 → 2.2.61

data/docs/resources/docker_image.md.erb

@@ -9,6 +9,16 @@ Use the `docker_image` InSpec audit resource to verify a Docker image.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.21.0 of InSpec.
+
 ## Syntax
 
 A `docker_image` resource block declares the image:

data/docs/resources/docker_plugin.md.erb

@@ -0,0 +1,80 @@
+---
+title: About the docker_plugin Resource
+platform: linux
+---
+
+# docker_plugin
+
+Use the `docker_plugin` InSpec audit resource to verify a Docker plugin.
+
+<br>
+
+## Syntax
+
+A `docker_plugin` resource block declares the plugin:
+
+    describe docker_plugin('rexray/ebs') do
+      it { should exist }
+      its('id') { should_not eq '0ac30b93ad40' }
+      its('version') { should eq '0.11.1' }
+      it { should be_enabled }
+    end
+
+<br>
+
+## Resource Parameter Examples
+
+The resource allows you to pass in an plugin id:
+
+    describe docker_plugin(id: plugin_id) do
+      it { should be_enabled }
+    end
+
+<br>
+
+## Properties
+
+### id
+
+The `id` property returns the full plugin id:
+
+    describe docker_plugin('cloudstor/aws') do
+      its('id') { should eq '0ac30b93ad40' }
+    end
+
+### version
+
+The `version` property tests the value of plugin version:
+
+    describe docker_plugin('cloudstor/aws') do
+      its('version') { should eq '0.11.0' }
+    end
+
+## Examples
+
+### Test a Docker plugin
+
+    describe docker_plugin('rexray/ebs') do
+      it { should exist }
+      its('id') { should_not eq '0ac30b93ad40' }
+      its('version') { should eq '0.11.1' }
+      it { should be_enabled }
+    end
+
+<br>
+
+## Matchers
+
+For a full list of available matchers, please visit our [Universal Matchers](https://www.inspec.io/docs/reference/matchers/).
+
+### exist
+
+The `exist` matcher tests if the plugin is available on the node:
+
+    describe docker_plugin('rexray/ebs') do
+      it { should exist }
+    end
+
+### enabled
+
+The `be_enabled` matches tests if the plugin is enabled

data/docs/resources/docker_service.md.erb

@@ -9,6 +9,16 @@ Use the `docker_service` InSpec audit resource to verify a docker swarm service.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.51.0 of InSpec.
+
 ## Syntax
 
 A `docker_service` resource block declares the service by name:

data/docs/resources/elasticsearch.md.erb

@@ -12,6 +12,16 @@ a variety of settings and statuses.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.43.5 of InSpec.
+
 ## Syntax
 
     describe elasticsearch do

data/docs/resources/etc_fstab.md.erb

@@ -9,6 +9,16 @@ Use the `etc_fstab` InSpec audit resource to test information about all partitio
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.37.6 of InSpec.
+
 ## Syntax
 
 An etc_fstab rule specifies a device name, its mount point, its mount type, the options its mounted with,

data/docs/resources/etc_group.md.erb

@@ -9,6 +9,16 @@ Use the `etc_group` InSpec audit resource to test groups that are defined on Lin
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 A `etc_group` resource block declares a collection of properties to be tested:

data/docs/resources/etc_hosts.md.erb

@@ -9,6 +9,16 @@ Use the `etc_hosts` InSpec audit resource to test rules set to match IP addresse
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.37.6 of InSpec.
+
 ## Syntax
 
 An etc/hosts rule specifies an IP address and what its hostname is along with optional aliases it can have.

data/docs/resources/etc_hosts_allow.md.erb

@@ -9,6 +9,16 @@ Use the `etc_hosts_allow` InSpec audit resource to test rules defined for accept
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.39.1 of InSpec.
+
 ## Syntax
 
 An etc/hosts.allow rule specifies one or more daemons mapped to one or more clients, with zero or more options to for accepting traffic when found.

data/docs/resources/etc_hosts_deny.md.erb

@@ -9,6 +9,16 @@ Use the `etc_hosts_deny` InSpec audit resource to test rules for rejecting daemo
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.39.1 of InSpec.
+
 ## Syntax
 
 An etc/hosts.deny rule specifies one or more daemons mapped to one or more clients, with zero or more options for rejecting traffic when found.

data/docs/resources/file.md.erb

@@ -9,6 +9,16 @@ Use the `file` InSpec audit resource to test all system file types, including fi
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 A `file` resource block declares the location of the file type to be tested, the expected file type  (if required), and one (or more) resource properties.

data/docs/resources/filesystem.md.erb

@@ -9,6 +9,16 @@ Use the `filesystem` InSpec resource to audit filesystem disk space usage.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.51.0 of InSpec.
+
 ## Syntax
 
 A `filesystem` resource block declares tests for disk space in a partition:

data/docs/resources/firewalld.md.erb

@@ -11,6 +11,16 @@ A firewalld has a number of zones that can be configured to allow and deny acces
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.40.0 of InSpec.
+
 ## Syntax
 
     describe firewalld do

data/docs/resources/gem.md.erb

@@ -9,6 +9,16 @@ Use the `gem` InSpec audit resource to test if a global Gem package is installed
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 A `gem` resource block declares a package and (optionally) a package version:

data/docs/resources/group.md.erb

@@ -9,6 +9,16 @@ Use the `group` InSpec audit resource to test groups on the system.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 A `group` resource block declares a group, and then the details to be tested, such as if the group is a local group, the group identifier, or if the group exists:

data/docs/resources/grub_conf.md.erb

@@ -9,6 +9,16 @@ Grub is a boot loader on the Linux platform used to load and then transfer contr
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 A `grub_conf` resource block declares a list of settings in a `grub.conf` file:

data/docs/resources/host.md.erb

@@ -9,6 +9,16 @@ Use the `host` InSpec audit resource to test the name used to refer to a specifi
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 A `host` resource block declares a host name, and then (depending on what is to be tested) a port and/or a protocol:

data/docs/resources/http.md.erb

@@ -9,6 +9,16 @@ Use the `http` InSpec audit resource to test an http endpoint.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.10.0 of InSpec.
+
 ## Syntax
 
 An `http` resource block declares the configuration settings to be tested:

data/docs/resources/iis_app.md.erb

@@ -9,6 +9,16 @@ Use the `iis_app` InSpec audit resource to test the state of IIS on Windows Serv
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.28.0 of InSpec.
+
 ## Syntax
 
 An `iis_app` resource block declares details about the named site:

data/docs/resources/iis_site.md.erb

@@ -9,6 +9,16 @@ Use the `iis_site` InSpec audit resource to test the state of IIS on Windows Ser
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 An `iis_site` resource block declares details about the named site:

data/docs/resources/inetd_conf.md.erb

@@ -9,6 +9,16 @@ Use the `inetd_conf` InSpec audit resource to test if a service is listed in the
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 An `inetd_conf` resource block declares the list of services that are enabled in the `inetd.conf` file:

data/docs/resources/ini.md.erb

@@ -9,6 +9,16 @@ Use the `ini` InSpec audit resource to test settings in an INI file.
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 An `ini` resource block declares the configuration settings to be tested:

data/docs/resources/interface.md.erb

@@ -12,6 +12,16 @@ Use the `interface` InSpec audit resource to test basic network adapter properti
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.0.0 of InSpec.
+
 ## Syntax
 
 An `interface` resource block declares network interface properties to be tested: