Mirrors/inspec
2
0
Fork 0
mirror of https://github.com/inspec/inspec synced 2024-09-20 22:41:55 +00:00
Code Issues Projects Releases Packages Wiki Activity

Updates the os resource to use dot notation for family (#2807)

Browse source 
The dot notation is supported for family on the os resource. That is
by far easier to type out and use.

Also fixes that the platform names returned are Strings and not Symbols.

Signed-off-by: Franklin Webber <franklin@chef.io>
This commit is contained in:
Franklin Webber 2018-03-12 12:02:48 -05:00 committed by Jared Quick
parent 3a64dffb7d
commit bb538bfb5c
1 changed files with 18 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
docs/resources/os.md.erb
View file

@ -13,7 +13,7 @@ Use the `os` InSpec audit resource to test the platform on which the system is r
An `os` resource block declares the platform to be tested. The platform may specified via matcher or control block name. For example, using a matcher:
describe os[:family] do
describe os.family do
it { should eq 'platform_family_name' }
end
@ -33,19 +33,19 @@ The following examples show how to use this InSpec audit resource.
### Test for RedHat
describe os[:family] do
describe os.family do
it { should eq 'redhat' }
end
### Test for Ubuntu
describe os[:family] do
describe os.family do
it { should eq 'debian' }
end
### Test for Microsoft Windows
describe os[:family] do
describe os.family do
it { should eq 'windows' }
end
@ -103,28 +103,28 @@ Use the following helpers to test for operating system names, releases, and arch
it { should eq 'foo' }
end
### os[:family] Symbols
### os.family names
Use `os[:family]` to enable more granular testing of platforms, platform names, architectures, and releases. Use any of the following platform-specific symbols to test for specific platforms:
Use `os.family` to enable more granular testing of platforms, platform names, architectures, and releases. Use any of the following platform-specific names to test for specific platforms:
* `:aix`
* `:bsd` For platforms that are part of the Berkeley OS family: `:darwin`, `:freebsd`, `:netbsd`, and `:openbsd`.
* `:debian`
* `:hpux`
* `:linux`. For platforms that are part of the Linux family: `:alpine`, `:amazon`, `:arch`, `:coreos`, `:exherbo`, `:fedora`, `:gentoo`, and `:slackware`.
* `:redhat`. For platforms that are part of the Redhat family: `:centos`.
* `:solaris`. For platforms that are part of the Solaris family: `:nexentacore`, `:omnios`, `:openindiana`, `:opensolaris`, and `:smartos`.
* `:suse`
* `:unix`
* `:windows`
* `aix`
* `bsd` For platforms that are part of the Berkeley OS family `darwin`, `freebsd`, `netbsd`, and `openbsd`.
* `debian`
* `hpux`
* `linux`. For platforms that are part of the Linux family `alpine`, `amazon`, `arch`, `coreos`, `exherbo`, `fedora`, `gentoo`, and `slackware`.
* `redhat`. For platforms that are part of the Redhat family `centos`.
* `solaris`. For platforms that are part of the Solaris family `nexentacore`, `omnios`, `openindiana`, `opensolaris`, and `smartos`.
* `suse`
* `unix`
* `windows`
For example, both of the following tests should have the same result:
if os[:family] == 'debian'
if os.family == 'debian'
describe port(69) do
its('processes') { should include 'in.tftpd' }
end
elsif os[:family] == 'redhat'
elsif os.family == 'redhat'
describe port(69) do
its('processes') { should include 'xinetd' }
end