inspec 2.2.55 → 2.2.61

data/docs/resources/azure_virtual_machine.md.erb

@@ -7,6 +7,16 @@ platform: azure
 
 Use the `azure_virtual_machine` InSpec audit resource to ensure that a Virtual Machine has been provisioned correctly.
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v2.0.16 of InSpec.
+
 ## Syntax
 
 The name of the machine and the resource group are required as properties to the resource.

data/docs/resources/azure_virtual_machine_data_disk.md.erb

@@ -7,6 +7,16 @@ platform: azure
 
 Use this resource to ensure that a specific data disk attached to a machine has been created properly.
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v2.0.16 of InSpec.
+
 ## Syntax
 
 The name of the resource group and machine are required to use this resource.

data/docs/resources/bash.md.erb

@@ -9,6 +9,16 @@ Use the `bash` InSpec audit resource to test an arbitrary command that is run on
 
 <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 `command` resource block declares a command to be run, one (or more) expected outputs, and the location to which that output is sent:

data/docs/resources/bond.md.erb

@@ -9,6 +9,16 @@ Use the `bond` InSpec audit resource to test a logical, bonded network interface
 
 <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 `bond` resource block declares a bonded network interface, and then specifies the properties of that bonded network interface to be tested:

data/docs/resources/bridge.md.erb

@@ -9,6 +9,16 @@ Use the `bridge` InSpec audit resource to test basic network bridge properties,
 
 <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 `bridge` resource block declares the bridge to be tested and what interface it should be associated with:

data/docs/resources/bsd_service.md.erb

@@ -9,6 +9,16 @@ Use the `bsd_service` InSpec audit resource to test a service using a Berkeley O
 
 <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 `bsd_service` resource block declares the name of a service and then one (or more) matchers to test the state of the service:

data/docs/resources/chocolatey_package.md.erb

@@ -9,6 +9,16 @@ Use the `chocolatey_package` InSpec audit resource to test if the named [Chocola
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v2.1.30 of InSpec.
+
 ## Syntax
 
 A `chocolatey_package` resource block declares the name of a Chocolatey package to be tested:

data/docs/resources/command.md.erb

@@ -9,6 +9,16 @@ Use the `command` InSpec audit resource to test an arbitrary command that is run
 
 <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 `command` resource block declares a command to be run, one (or more) expected values, and the location to which that output is sent:

data/docs/resources/cpan.md.erb

@@ -9,6 +9,16 @@ Use the `cpan` InSpec audit resource to test Perl modules that are installed by
 
 <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
 
 A `cpan` resource block declares a package and (optionally) a package version:

data/docs/resources/cran.md.erb

@@ -9,6 +9,16 @@ Use the `cran` InSpec audit resource to test R modules that are installed from C
 
 <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
 
 A `cran` resource block declares a package and (optionally) a package version:

data/docs/resources/crontab.md.erb

@@ -9,6 +9,16 @@ Use the `crontab` InSpec audit resource to test the crontab entries for a partic
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.15.0 of InSpec.
+
 ## Syntax
 
 A `crontab` resource block declares a user (which defaults to the current user, if not specified), and then the details to be tested, such as the schedule elements for each crontab entry or the commands itself:

data/docs/resources/csv.md.erb

@@ -9,6 +9,16 @@ Use the `csv` InSpec audit resource to test configuration data in a CSV 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
 
 A `csv` resource block declares the configuration data to be tested:

data/docs/resources/dh_params.md.erb

@@ -9,6 +9,16 @@ Use the `dh_params` InSpec audit resource to test Diffie-Hellman (DH) parameters
 
 <br>
 
+## Availability
+
+### Installation
+
+This resource is distributed along with InSpec itself. You can use it automatically.
+
+### Version
+
+This resource first became available in v1.19.0 of InSpec.
+
 ## Syntax
 
 A `dh_params` resource block declares a parameter file to be tested.

data/docs/resources/directory.md.erb

@@ -9,6 +9,16 @@ Use the `directory` InSpec audit resource to test if the file type is a director
 
 <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 `directory` resource block declares the location of the directory to be tested, and then one (or more) matchers.

data/docs/resources/docker.md.erb

@@ -9,6 +9,16 @@ Use the `docker` InSpec audit resource to test configuration data for the Docker
 
 <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` resource block declares allows you to write test for many containers:
@@ -148,6 +158,17 @@ Or execute the profile directly via URL:
       its('sizes') { should_not include "1.41 GB" }
     end
 
+### plugins
+
+`plugins` returns information about Docker plugins as returned by [docker plugin ls](https://docs.docker.com/engine/reference/commandline/plugin/).
+
+    describe docker.plugins do
+      its('names') { should include ["store/weaveworks/net-plugin", "docker4x/cloudstor"] }
+      its('ids') { should cmp ["6ea8176de74b", "771d3ee7c7ea"] }
+      its('versions') { should cmp ["2.3.0", "18.03.1-ce-aws1"] }
+      its('enabled') { should cmp [true, false] }
+    end
+
 ### info
 
 `info` returns the parsed result of [docker info](https://docs.docker.com/engine/reference/commandline/info/)

data/docs/resources/docker_container.md.erb

@@ -9,6 +9,16 @@ Use the `docker_container` InSpec audit resource to test a Docker container.
 
 <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_container` resource block declares the configuration data to be tested:

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,