Modularize resources

Signed-off-by: Ian Maddaus <ian.maddaus@progress.com>

Author: IanMadd

content/resources/core/docker.md

@@ -2,280 +2,6 @@
 title = "docker resource"
 draft = false
 
-platform = "linux"
-
-[menu.resources]
-    title = "docker"
-    identifier = "resources/core/docker.md docker resource"
-    parent = "resources/core"
 +++
 
-Use the `docker` Chef InSpec audit resource to test configuration data for the Docker daemon. It's a very comprehensive resource. See also: [docker_container](/resources/core/docker_container/) and [docker_image](/resources/core/docker_image/), too.
-
-## Availability
-
-### Install
-
-{{< readfile file="content/reusable/md/inspec_installation.md" >}}
-
-### Version
-
-This resource first became available in v1.21.0 of InSpec.
-
-## Syntax
-
-A `docker` resource block allows you to write tests for many containers:
-
-```ruby
-describe docker.containers do
-  its('images') { should_not include 'u12:latest' }
-end
-```
-
-or:
-
-```ruby
-describe docker.containers.where { names == 'flamboyant_allen' } do
-  it { should be_running }
-end
-```
-
-where:
-
-- `.where()` may specify a specific item and value, to which the resource parameters are compared
-- `commands`, `ids`, `images`, `labels`, `local_volumes`, `mounts`, `names`, `networks`, `ports`, `sizes` and `status` are valid parameters for `containers`
-
-The `docker` resource block also declares allows you to write test for many images:
-
-```ruby
-describe docker.images do
-  its('repositories') { should_not include 'insecure_image' }
-end
-```
-
-or if you want to query specific images:
-
-```ruby
-describe docker.images.where { repository == 'ubuntu' && tag == '12.04' } do
-  it { should_not exist }
-end
-```
-
-where:
-
-- `.where()` may specify a specific filter and expected value, against which parameters are compared
-
-## Examples
-
-The following examples show how to use this Chef InSpec audit resource.
-
-### Return all running containers
-
-```ruby
-docker.containers.running?.ids.each do |id|
-  describe docker.object(id) do
-    its('State.Health.Status') { should eq 'healthy' }
-  end
-end
-```
-
-### Verify a Docker Server and Client version
-
-```ruby
-describe docker.version do
-  its('Server.Version') { should cmp >= '1.12'}
-  its('Client.Version') { should cmp >= '1.12'}
-end
-```
-
-### Iterate over all containers to verify host configuration
-
-```ruby
-docker.containers.ids.each do |id|
-  # call Docker inspect for a specific container id
-  describe docker.object(id) do
-    its(%w(HostConfig Privileged)) { should cmp false }
-    its(%w(HostConfig Privileged)) { should_not cmp true }
-  end
-end
-```
-
-### Iterate over all images to verify the container was built without ADD instruction
-
-```ruby
-docker.images.ids.each do |id|
-  describe command("docker history #{id}| grep 'ADD'") do
-    its('stdout') { should eq '' }
-  end
-end
-```
-
-### Verify that health-checks are enabled for a container
-
-```ruby
-describe docker.object('71b5df59442b') do
-  its(%w(Config Healthcheck)) { should_not eq nil }
-end
-```
-
-## How to run the DevSec Docker baseline profile
-
-You can run the `docker-baseline` profile to test Docker in two possible ways:
-
-Clone the profile:
-
-```sh
-git clone https://github.com/dev-sec/cis-docker-benchmark.git
-```
-
-and then run:
-
-```sh
-inspec exec cis-docker-benchmark
-```
-
-Or execute the profile directly using a URL:
-
-```sh
-inspec exec https://github.com/dev-sec/cis-docker-benchmark
-```
-
-## Resource parameters
-
-- `commands`, `ids`, `images`, `labels`, `local_volumes`, `mounts`, `names`, `networks`, `ports`, `sizes` and `status` are valid parameters for `containers`
-
-## Resource Parameter Examples
-
-### containers
-
-`containers` returns information about containers as returned by [docker ps -a](https://docs.docker.com/engine/reference/commandline/ps/).
-
-```ruby
-describe docker.containers do
-  its('ids') { should include 'sha:71b5df59...442b' }
-  its('commands') { should_not include '/bin/sh' }
-  its('images') { should_not include 'u12:latest' }
-  its('ports') { should include '0.0.0.0:1234->1234/tcp' }
-  its('labels') { should include 'License=GPLv2' }
-end
-```
-
-### object('id')
-
-`object` returns low-level information about Docker objects. It's calling [docker inspect](https://docs.docker.com/engine/reference/commandline/info/) under the hood.
-
-```ruby
-describe docker.object(id) do
-  its('Configuration.Path') { should eq 'value' }
-end
-```
-
-### images
-
-`images` returns information about a Docker image as returned by [docker images](https://docs.docker.com/engine/reference/commandline/images/).
-
-```ruby
-describe docker.images do
-  its('ids') { should include 'sha:12b5df59...442b' }
-  its('repositories') { should_not include 'my_image' }
-  its('tags') { should_not include 'unwanted_tag' }
-  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/).
-
-```ruby
-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/)
-
-```ruby
-describe docker.info do
-  its('Configuration.Path') { should eq 'value' }
-end
-```
-
-### version
-
-`info` returns the parsed result of [docker version](https://docs.docker.com/engine/reference/commandline/version/)
-
-```ruby
-describe docker.version do
-  its('Server.Version') { should cmp >= '1.12'}
-  its('Client.Version') { should cmp >= '1.12'}
-end
-```
-
-## Properties
-
-- `id`
-- `image`
-- `repo`
-- `tag`
-- `ports`
-- `command`
-
-## Property Examples
-
-### id
-
-```ruby
-describe docker_container(name: 'an-echo-server') do
-  its('id') { should_not eq '' }
-end
-```
-
-### image
-
-```ruby
-describe docker_container(name: 'an-echo-server') do
-  its('image') { should eq 'busybox:latest' }
-end
-```
-
-### repo
-
-```ruby
-describe docker_container(name: 'an-echo-server') do
-  its('repo') { should eq 'busybox' }
-end
-```
-
-### tag
-
-```ruby
-describe docker_container(name: 'an-echo-server') do
-  its('tag') { should eq 'latest' }
-end
-```
-
-### ports
-
-```ruby
-describe docker_container(name: 'an-echo-server') do
-  its('ports') { should eq '0.0.0.0:1234->1234/tcp' }
-end
-```
-
-### command
-
-```ruby
-describe docker_container(name: 'an-echo-server') do
-  its('command') { should eq 'nc -ll -p 1234 -e /bin/cat' }
-end
-```
-
-## Matchers
-
-{{< readfile file="content/reusable/md/inspec_matchers_link.md" >}}
+{{< readfile file="content/reusable/md/modularized_resource.md" >}}