Add Chef 13.8 and 14.0 release notes #7074

tas50 · 2018-03-27T03:44:07Z

First stab at Chef 14 release notes. Let me know if I got it all. I'm sure there's plenty of typos.

Yes it's really big. That's ok. It's a big release with a lot of things we want people to know about.

Signed-off-by: Tim Smith tsmith@chef.io

juliandunn · 2018-03-27T04:07:16Z

RELEASE_NOTES.md

+
+### dmg_package
+
+Use the dmg_package resourceto install a DMG 'Package'. The resource will retrieve the DMG file from a remote URL, mount it using hdid, copy the application (.app directory) to the specified destination (/Applications), and detach the image using hdiutil. The dmg file will be stored in the Chef::Config[:file_cache_path]. This resource was ported from the `dmg` community cookbook.


what do you mean by hdid -- do you mean hdiutil?

also missed that there needs to be an extra space between resource and to

juliandunn · 2018-03-27T04:08:10Z

RELEASE_NOTES.md

+
+### sudo
+
+Use the sudo resource to add or remove individual sudo entries using sudoers.d files. Sudo version 1.7.2 or newer is required to use the sudo resource as it relies on the '#includedir' directive introduced in version 1.7.2\. The resource does not enforce installing the version. Supported releases of Ubuntu, Debian, Suse, and RHEL (6+) all support this feature. This resource was ported from the `sudo` community cookbook.


either SUSE or SuSE

juliandunn · 2018-03-27T04:08:23Z

RELEASE_NOTES.md

+
+### sysctl
+
+Use the sysctl resource to set kernel parameters using the sysctl command line tool and configuration files in the system's sysctl.d directory.Configuration files managed by this resource are named 99-chef-KEYNAME.conf. If an existing value was already set for the value it will be backed up to the node and restored if the :remove action is used later. This resource was ported from the `sysctl` community cookbook.


missing space before Configuration

juliandunn · 2018-03-27T04:08:58Z

RELEASE_NOTES.md

+
+`Note`: This resource no longer backs up existing key values to the node. It has also been renamed from sysctl_param to systctl with backwards compatibility for the previous name.
+
+### windows_ad_join


are reboots necessary after this resource?

Yes, reboots are necessary. We provide a property that allows the user to either defer the reboot until the end of run or reboot immediately.

added and reboot the node

juliandunn · 2018-03-27T04:09:58Z

RELEASE_NOTES.md

+
+### Deprecations in Cookbook Resources
+
+Chef 14 provides new primitives that allow you to deprecate resources or properties with the same deprecations functionality used for deprecations in chef-client resources. This allows you make breaking changes to enterprise or community cookbooks with friendly notifications to downstream cookbook consumers directly in the Chef run.


remove the first "deprecations"

juliandunn · 2018-03-27T04:18:44Z

RELEASE_NOTES.md

+
+### cloud_v2 and filesystem2 Ohai Plugins
+
+In Chef 13 the `cloud_v2` plugin replaced the `cloud` plugin and `filesystem2` replaced the `filesystem` plugin. We continued to write data to both locations for compatibility with users that had written cookbooks for the "v2" plugins. We now no longer write data to the v2 locations which greatly reduces the amount of data we need to store on the Chef server.


this is a bit confusing to me -- do you mean you no longer write data to the old locations? isn't v2 the current?

Nope v2 is old, but I can clarify here.

I think it's better now

juliandunn · 2018-03-27T04:19:07Z

RELEASE_NOTES.md

+
+The libvirt Ohai plugin now writes data to `node['libvirt']` instead of writing to various locations in `node['virtualization']`. This plugin required installing an additional gem into the Chef installation and thus was infrequently used.
+
+### Ohai Plugin V6 Support


say "Removed"

juliandunn · 2018-03-27T04:19:15Z

RELEASE_NOTES.md

+
+In Chef 13 the `cloud_v2` plugin replaced the `cloud` plugin and `filesystem2` replaced the `filesystem` plugin. We continued to write data to both locations for compatibility with users that had written cookbooks for the "v2" plugins. We now no longer write data to the v2 locations which greatly reduces the amount of data we need to store on the Chef server.
+
+### Ipscopes Ohai Plugin


say "Removed"

juliandunn · 2018-03-27T04:19:35Z

RELEASE_NOTES.md

+
+In 2014 we introduced Ohai v7 with a greatly improved plugin format. With Chef 14 we no longer support loading of the legacy "v6" plugin format.
+
+### Newly Disabled Ohai Plugins


Newly-disabled

juliandunn · 2018-03-27T04:20:04Z

RELEASE_NOTES.md


-Since our supported Windows platforms can all run .NET Framework 4.0 and PowerShell 4.0 we have taken time to add a new interop that will allow faster and safer interactions with the system PowerShell.  You will be able to use the `powershell_exec` mixin in most places where you would have previously used `powershell_out`.  For comparison, a basic benchmark test to return the `$PSVersionTable` 100 times completed 7.3X faster compared to the `powershell_out` method.  The majority of the time difference is because of less time spent in invocation.  So we believe it has big future potential where multiple calls to PowerShell are required inside (for example) a custom resource.
+Chef 14 includes a large number of resources ported from community cookbooks. These resources have been tested, improved, and functionality expanded. With these new resources in the chef-client itself the need for external cookbook dependencies and dependency management has been greatly reduced.


Chef Client not chef-client (we only use the latter in copy when referring literally to the binary, not the product)

"have had their functionality expanded" or something like that. Also there should be a comma after "itself" in the second sentence.

Fixed and Fixed

stuartpreston

+1 on all the windows bits in here. Great work pulling this together @tas50

brewn · 2018-03-27T15:17:12Z

RELEASE_NOTES.md

+
+### dmg_package
+
+Use the dmg_package resourceto install a DMG 'Package'. The resource will retrieve the DMG file from a remote URL, mount it using hdid, copy the application (.app directory) to the specified destination (/Applications), and detach the image using hdiutil. The dmg file will be stored in the Chef::Config[:file_cache_path]. This resource was ported from the `dmg` community cookbook.


The capitalization of DMG / dmg is inconsistent here. It might be clearer to just refer to it as the file extension .dmg. Or just use all caps consistently - I can't seem find it written a specific way in Apple's documentation.

making it lowercase

brewn · 2018-03-27T15:28:05Z

RELEASE_NOTES.md

+
+### macos_userdefaults
+
+Use the macos_userdefaults resource to manage the macOS user defaults system. The properties to the resource are passed to the defaults command and the parameters follow convention of the macOS command. See the defaults(1) man page for details on how the tool works. This resource was ported from the `mac_os_x` community cookbook.


"The properties of this resource are passed to the defaults command, and the parameters follow the convention of that command." might be clearer - at least highlighting defaults as a shell command.

brewn · 2018-03-27T15:29:11Z

RELEASE_NOTES.md

+
+### openssl_rsa_public_key
+
+Use the openssl_rsa_public_key resource to generate RSA public key files given a RSA private key". This resource was ported from the `openssl` community cookbook.


Quotation mark after key.

brewn · 2018-03-27T15:30:48Z

RELEASE_NOTES.md

+
+### rhsm_errata
+
+Use the rhsm_errata for installing packages associated with a given Red Hat Subscription Manager Errata ID. This is helpful if packages to mitigate a single vulnerability must be installed on your hosts. This resource was ported from the `redhat_subscription_manager` community cookbook.


"Use the rhsm_errata resource to install"

^ add the word resource and s/for installing/to install

Fixed. I already made this change to the descriptions in the actual resources. These were merged in before our meeting about how we wanted to word the descriptions

brewn · 2018-03-27T15:31:46Z

RELEASE_NOTES.md

+
+### rhsm_errata_level
+
+Use the rhsm_errata_level resource for installing all packages of a specified errata level from the Red Hat Subscript Manager. For example, you can ensure that all packages associated with errata marked at a 'Critical' security level are installed. This resource was ported from the `redhat_subscription_manager` community cookbook.


Subscript --> Subscription

Also, "for installing" should be "to install" here as well.

brewn · 2018-03-27T15:33:00Z

RELEASE_NOTES.md

+
+### rhsm_register
+
+Use the rhsm_register resource for registering a node with the Red Hat Subscription Manager or a local Red Hat Satellite server. This resource was ported from the `redhat_subscription_manager` community cookbook.


"for registering" --> "to register"

brewn · 2018-03-27T15:33:27Z

RELEASE_NOTES.md

+
+### rhsm_repo
+
+Use the rhsm_repo resource for enabling and disabling Red Hat Subscription Manager repositories that are made available via attached subscriptions. This resource was ported from the `redhat_subscription_manager` community cookbook.


"for enabling and disable" --> "to enable and disable"

brewn · 2018-03-27T15:43:37Z

RELEASE_NOTES.md

+
+### sudo
+
+Use the sudo resource to add or remove individual sudo entries using sudoers.d files. Sudo version 1.7.2 or newer is required to use the sudo resource as it relies on the '#includedir' directive introduced in version 1.7.2\. The resource does not enforce installing the version. Supported releases of Ubuntu, Debian, Suse, and RHEL (6+) all support this feature. This resource was ported from the `sudo` community cookbook.


Sudo version 1.7.2 or newer is required to use the sudo resource as it relies on the '#includedir' directive introduced in version 1.7.2.

comma after "resource" - also remove backslash at the end of the sentence.

sudoers.d files should be highlighted

The resource does not enforce installing the version.

This resource does not enforce installation of the required sudo version

The backslash is a MD thing. My editor adds those automatically and you don't see.

brewn · 2018-03-27T15:48:18Z

RELEASE_NOTES.md

+
+### rhsm_subscription
+
+Use the rhsm_subscription resource for adding additional Redhat Subscription Manager subscriptions to your host. This can be used when a host's activation_key does not attach all necessary subscriptions to your host. This resource was ported from the `redhat_subscription_manager` community cookbook.


Use the rhsm_subscription resource for adding additional Redhat Subscription Manager subscriptions to your host

Use the rhsm_subscription resource to add or remove Red Hat Subscription Manager subscriptions for your host.

brewn · 2018-03-27T15:52:04Z

RELEASE_NOTES.md

+
+### swap_file
+
+Use the swap_file resource to create or delete swap files on Linux systems and optionally manage the swappiness configuration for a host. This resource was ported from the `swap` community cookbook.


Use the swap_file resource to create or delete swap files on Linux systems and optionally manage the swappiness configuration for a host.

add comma after systems. "and optionally manage" --> "and optionally to manage"

brewn · 2018-03-27T15:54:21Z

RELEASE_NOTES.md

+
+### sysctl
+
+Use the sysctl resource to set kernel parameters using the sysctl command line tool and configuration files in the system's sysctl.d directory.Configuration files managed by this resource are named 99-chef-KEYNAME.conf. If an existing value was already set for the value it will be backed up to the node and restored if the :remove action is used later. This resource was ported from the `sysctl` community cookbook.


sysctl.d should be syntax highlighted. Missing space after first sentence's period.

If an existing value was already set for the value

This is confusing. Does "If an existing value was already set, it will be backed up to the node..." work?

I reworded this a bit.

brewn · 2018-03-27T15:55:27Z

RELEASE_NOTES.md

+
+### windows_feature
+
+Using the windows_feature resource to add, remove or delete Windows features and roles. This resource calls the `windows_feature_dism` or `windows_feature_powershell` resources depending on the specified installation method and defaults to dism, which is available on both Workstation and Server editions of Windows. This resource was ported from the `windows` community cookbook.


s/using/use at beginning of sentence.

Fixed here and in the resource

brewn · 2018-03-27T15:58:18Z

RELEASE_NOTES.md

+
+### windows_font
+
+Use the windows_font resource to install or remove font files on Windows. Sources the font by default from the cookbook using the resource, but a URI source can be specified as well. This resource was ported from the `windows` community cookbook.


Sources the font by default

"By default, the font is sourced from the cookbook using the resource..."

Fixed here and in the resource

brewn · 2018-03-27T15:59:55Z

RELEASE_NOTES.md

+
+## Custom Resource Improvements
+
+We've expanded the DSL for custom resources with new functionality to better document your resources and help users with errors and upgrades. Many resources in Chef itself are now using this new functionality, and you'll see more updated to take advantage of this new functionality in the future.


Many resources in Chef itself are now using this new functionality, and you'll see more updated to take advantage of this new functionality in the future.

probably don't need to say "new functionality" twice - could could just replace with "it" the second time.

brewn · 2018-03-27T16:01:41Z

RELEASE_NOTES.md

+
+## Improved Resources
+
+Many existing resources include new actions and properties to expand their functionality.


"Many existing resources now include new actions and properties that expand their functionality"

brewn · 2018-03-27T16:02:50Z

RELEASE_NOTES.md

+
+### registry_key
+
+The `sensitive` property can now be used in `registry_key` to supress the output of the key's data from logs and error messages. Thanks @shoekstra for implementing this.


s/supress/suppress

brewn · 2018-03-27T16:04:21Z

RELEASE_NOTES.md

+`systemd_unit` includes the following new actions:
+
+- `preset` - Restore the preset enable/disable configuration for a unit
+- `revert` - Revert to a vendors version of a unit file


brewn · 2018-03-27T16:04:48Z

RELEASE_NOTES.md

+
+### windows_service
+
+`windows_service` now includes actions for fully managing services on Windows in addition to the previous actions for starting/stopping/enabling services.


comma after Windows

brewn · 2018-03-27T16:05:47Z

RELEASE_NOTES.md

+
+### Virtualization / Container Detection
+
+In addition to detecting if a system is a docker host we now provide a large amount of Docker configuration information available at `node['docker']`. This including the release of docker, installed plugins, network config, and the number of running containers.


comma after "docker host"

brewn · 2018-03-27T16:07:18Z

RELEASE_NOTES.md

+
+Ohai now includes the ability to mark plugins as optional, which skips those plugins by default. This allows us to ship additional plugins, which some users may find useful, but not all users would want being written to their Chef server. The change introduces two new configuration options; `run_all_plugins` which runs everything including optional plugins, and `optional_plugins` which allows you to run plugins marked as optional.
+
+By default we will now be marking the `lspci`, `sessions` and `passwd` plugins as optional. Passwd has been particularly problematic for nodes attached LDAP or AD where it attempts to write the entire directory to the node. If you previously disabled this plugin via Ohai config, you no longer need to. Hurray!


"attached to LDAP or AD, where it attempts to write..."

brewn · 2018-03-27T16:08:44Z

RELEASE_NOTES.md

+
+Many users of Policies rely on "hoisting" to provide group specific attributes. This approach was formalized in the poise-hoist extension, and is now included in Chef 14.
+
+To hoist an attribute, the user provide a default attribute structure in their Policyfile similar to:


s/provide/provides

brewn · 2018-03-27T16:09:17Z

RELEASE_NOTES.md

+node['myapp']['title']
+```
+
+The correct attribute is then be provided based on the policy_group of the node, so with a policy_group of staging the attribute would contain "My Staging App".


is then be provided

is then provided

brewn · 2018-03-27T16:12:47Z

RELEASE_NOTES.md

+
+### Logging Improvements
+
+Chef now includes a new log level of `:trace` in addition to the existing `:info`, `:warn`, and `:debug` levels. With the introduction of `trace` level logging we've moved a large amount of logging that more useful for Chef developers from `debug` to `trace`. This makes it easier for Chef Cookbook developers to use `debug` level to get useful information.


large amount of logging that more useful

that is more useful

Just like our logging I was trying to keep it brief.

First stab at Chef 14 release notes. Let me know if I got it all. I'm sure there's plenty of typos. Yes it's really big. That's ok. It's a big release with a lot of things we want people to know about. Signed-off-by: Tim Smith <tsmith@chef.io>

Fixed the resoruce docs while I was in there. Signed-off-by: Tim Smith <tsmith@chef.io>

Signed-off-by: Tim Smith <tsmith@chef.io>

scotthain · 2018-03-27T16:57:55Z

RELEASE_NOTES.md

+
+### hostname
+
+Use the hostname resource to sets the system's hostname, configure hostname and hosts config file, and re-run the Ohai hostname plugin so the hostname will be available in subsequent cookbooks. This resource was ported from the `chef_hostname` community cookbook.


Fixed here and in the resource

scotthain · 2018-03-27T16:59:35Z

RELEASE_NOTES.md

+
+### rhsm_repo
+
+Use the rhsm_repo resource to enabling or disabling Red Hat Subscription Manager repositories that are made available via attached subscriptions. This resource was ported from the `redhat_subscription_manager` community cookbook.


to enable or disable

scotthain · 2018-03-27T17:00:06Z

RELEASE_NOTES.md

+
+### sudo
+
+Use the sudo resource to add or remove individual sudo entries using `sudoers.d` files. Sudo version 1.7.2 or newer is required to use the sudo resource, as it relies on the `#includedir` directive introduced in version 1.7.2\. This resource does not enforce installation of the required sudo version. Supported releases of Ubuntu, Debian, SuSE, and RHEL (6+) all support this feature. This resource was ported from the `sudo` community cookbook.


It's a markdown escape. It happens when you end a sentence with a number.

scotthain · 2018-03-27T17:00:56Z

RELEASE_NOTES.md

+
+Use the sysctl resource to set kernel parameters using the sysctl command line tool and configuration files in the system's `sysctl.d` directory. Configuration files managed by this resource are named 99-chef-KEYNAME.conf. If an existing value was already set for the value it will be backed up to the node and restored if the :remove action is used later. This resource was ported from the `sysctl` community cookbook.
+
+`Note`: This resource no longer backs up existing key values to the node when changing values as we done in the sysctl cookbook previously. The resource has also been renamed from `sysctl_param` to `systctl` with backwards compatibility for the previous name.


as we have done

scotthain · 2018-03-27T17:09:19Z

RELEASE_NOTES.md

+
+## Revert attributes changes from 13.7
+
+Per <https://discourse.chef.io/t/regression-in-chef-client-13-7-16/12518/1> , there was a regression in how arrays and hashes were handled in 13.7\. In 13.8, we've reverted to the same code as 13.6.


scotthain · 2018-03-27T17:09:49Z

RELEASE_NOTES.md

-cookbook will be available to help users migrate during the Chef 14 release
-cycle. See [the deprecation documentation](https://docs.chef.io/deprecations_deploy_resource.html)
-for more information.
+The `deploy` resource (and its alter ego `deploy_revision`) have been deprecated, to be removed in Chef 14\. This is being done because this resource is considered overcomplicated and error-prone in the modern Chef ecosystem. A compatibility cookbook will be available to help users migrate during the Chef 14 release cycle. See [the deprecation documentation](https://docs.chef.io/deprecations_deploy_resource.html) for more information.


scotthain · 2018-03-27T17:10:21Z

RELEASE_NOTES.md

@@ -136,7 +516,7 @@ The Packages plugin now supports gathering packages data on Amazon Linux

 ### Deprecation updates

-In Ohai 13 we replaced the filesystem and cloud plugins with the filesystem2 and cloud_v2 plugins. To maintain compatibility with users of the previous V2 plugins we write data to both locations. We had originally planned to continue writing data to both locations until Chef 15. Instead due to the large amount of duplicate node data this introduces we are updating OHAI-11 and OHAI-12 deprecations to remove node['cloud_v2'] and node['filesystem2'] with the release of Chef 14 in April 2018.
+In Ohai 13 we replaced the filesystem and cloud plugins with the filesystem2 and cloud_v2 plugins. To maintain compatibility with users of the previous V2 plugins we write data to both locations. We had originally planned to continue writing data to both locations until Chef 15\. Instead due to the large amount of duplicate node data this introduces we are updating OHAI-11 and OHAI-12 deprecations to remove node['cloud_v2'] and node['filesystem2'] with the release of Chef 14 in April 2018.


Signed-off-by: Tim Smith <tsmith@chef.io>

brewn · 2018-03-27T18:10:15Z

RELEASE_NOTES.md

-    **Platforms:** Fedora, RHEL, Amazon Linux
-    Whether the interface is controlled by the channel bonding interface
-    defined by `master`, above.
+- `ethtool\_opts`<br>


remove \ in ethtool_opts

brewn · 2018-03-27T18:10:28Z

RELEASE_NOTES.md

+  **Ruby types:** String<br>
+  **Platforms:** Fedora, RHEL, Amazon Linux A string containing arguments to ethtool. The string will be wrapped in double quotes, so ensure that any needed quotes in the property are surrounded by single quotes
+
+- `bonding\_opts`<br>


remove \ in bonding_opts

Just a markdown escape. Doesn't display

Signed-off-by: Tim Smith <tsmith@chef.io>

lock · 2018-05-26T18:43:47Z

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.

tas50 requested a review from a team March 27, 2018 03:44

juliandunn reviewed Mar 27, 2018

View reviewed changes

stuartpreston reviewed Mar 27, 2018

View reviewed changes

brewn reviewed Mar 27, 2018

View reviewed changes

tas50 added 2 commits March 27, 2018 09:29

Add Chef 13.8 and 14.0 release notes

753e67a

First stab at Chef 14 release notes. Let me know if I got it all. I'm sure there's plenty of typos. Yes it's really big. That's ok. It's a big release with a lot of things we want people to know about. Signed-off-by: Tim Smith <tsmith@chef.io>

Update release notes and resources to match

07d8338

Fixed the resoruce docs while I was in there. Signed-off-by: Tim Smith <tsmith@chef.io>

tas50 force-pushed the release_notes_v1 branch from ef6df6a to 07d8338 Compare March 27, 2018 16:40

Minor typo

17f2bbd

Signed-off-by: Tim Smith <tsmith@chef.io>

scotthain reviewed Mar 27, 2018

View reviewed changes

tas50 added 2 commits March 27, 2018 10:18

Shard is also optional

180d43c

Signed-off-by: Tim Smith <tsmith@chef.io>

More release note updates from reviews

0fa1d1e

Signed-off-by: Tim Smith <tsmith@chef.io>

brewn reviewed Mar 27, 2018

View reviewed changes

Remove some extra slashes

0ea3eb7

Signed-off-by: Tim Smith <tsmith@chef.io>

brewn approved these changes Mar 27, 2018

View reviewed changes

scotthain approved these changes Mar 27, 2018

View reviewed changes

tas50 merged commit d329b3f into master Mar 27, 2018

tas50 deleted the release_notes_v1 branch March 27, 2018 18:38

lock bot locked as resolved and limited conversation to collaborators May 26, 2018


		### dmg_package

		Use the dmg_package resourceto install a DMG 'Package'. The resource will retrieve the DMG file from a remote URL, mount it using hdid, copy the application (.app directory) to the specified destination (/Applications), and detach the image using hdiutil. The dmg file will be stored in the Chef::Config[:file_cache_path]. This resource was ported from the `dmg` community cookbook.


		### sudo

		Use the sudo resource to add or remove individual sudo entries using sudoers.d files. Sudo version 1.7.2 or newer is required to use the sudo resource as it relies on the '#includedir' directive introduced in version 1.7.2\. The resource does not enforce installing the version. Supported releases of Ubuntu, Debian, Suse, and RHEL (6+) all support this feature. This resource was ported from the `sudo` community cookbook.


		### sysctl

		Use the sysctl resource to set kernel parameters using the sysctl command line tool and configuration files in the system's sysctl.d directory.Configuration files managed by this resource are named 99-chef-KEYNAME.conf. If an existing value was already set for the value it will be backed up to the node and restored if the :remove action is used later. This resource was ported from the `sysctl` community cookbook.


		`Note`: This resource no longer backs up existing key values to the node. It has also been renamed from sysctl_param to systctl with backwards compatibility for the previous name.

		### windows_ad_join


		### Deprecations in Cookbook Resources

		Chef 14 provides new primitives that allow you to deprecate resources or properties with the same deprecations functionality used for deprecations in chef-client resources. This allows you make breaking changes to enterprise or community cookbooks with friendly notifications to downstream cookbook consumers directly in the Chef run.


		### cloud_v2 and filesystem2 Ohai Plugins

		In Chef 13 the `cloud_v2` plugin replaced the `cloud` plugin and `filesystem2` replaced the `filesystem` plugin. We continued to write data to both locations for compatibility with users that had written cookbooks for the "v2" plugins. We now no longer write data to the v2 locations which greatly reduces the amount of data we need to store on the Chef server.


		The libvirt Ohai plugin now writes data to `node['libvirt']` instead of writing to various locations in `node['virtualization']`. This plugin required installing an additional gem into the Chef installation and thus was infrequently used.

		### Ohai Plugin V6 Support


		In Chef 13 the `cloud_v2` plugin replaced the `cloud` plugin and `filesystem2` replaced the `filesystem` plugin. We continued to write data to both locations for compatibility with users that had written cookbooks for the "v2" plugins. We now no longer write data to the v2 locations which greatly reduces the amount of data we need to store on the Chef server.

		### Ipscopes Ohai Plugin


		In 2014 we introduced Ohai v7 with a greatly improved plugin format. With Chef 14 we no longer support loading of the legacy "v6" plugin format.

		### Newly Disabled Ohai Plugins


		Since our supported Windows platforms can all run .NET Framework 4.0 and PowerShell 4.0 we have taken time to add a new interop that will allow faster and safer interactions with the system PowerShell. You will be able to use the `powershell_exec` mixin in most places where you would have previously used `powershell_out`. For comparison, a basic benchmark test to return the `$PSVersionTable` 100 times completed 7.3X faster compared to the `powershell_out` method. The majority of the time difference is because of less time spent in invocation. So we believe it has big future potential where multiple calls to PowerShell are required inside (for example) a custom resource.
		Chef 14 includes a large number of resources ported from community cookbooks. These resources have been tested, improved, and functionality expanded. With these new resources in the chef-client itself the need for external cookbook dependencies and dependency management has been greatly reduced.


		### macos_userdefaults

		Use the macos_userdefaults resource to manage the macOS user defaults system. The properties to the resource are passed to the defaults command and the parameters follow convention of the macOS command. See the defaults(1) man page for details on how the tool works. This resource was ported from the `mac_os_x` community cookbook.


		### openssl_rsa_public_key

		Use the openssl_rsa_public_key resource to generate RSA public key files given a RSA private key". This resource was ported from the `openssl` community cookbook.


		### rhsm_errata

		Use the rhsm_errata for installing packages associated with a given Red Hat Subscription Manager Errata ID. This is helpful if packages to mitigate a single vulnerability must be installed on your hosts. This resource was ported from the `redhat_subscription_manager` community cookbook.


		### rhsm_errata_level

		Use the rhsm_errata_level resource for installing all packages of a specified errata level from the Red Hat Subscript Manager. For example, you can ensure that all packages associated with errata marked at a 'Critical' security level are installed. This resource was ported from the `redhat_subscription_manager` community cookbook.


		### rhsm_register

		Use the rhsm_register resource for registering a node with the Red Hat Subscription Manager or a local Red Hat Satellite server. This resource was ported from the `redhat_subscription_manager` community cookbook.


		### rhsm_repo

		Use the rhsm_repo resource for enabling and disabling Red Hat Subscription Manager repositories that are made available via attached subscriptions. This resource was ported from the `redhat_subscription_manager` community cookbook.


		### rhsm_subscription

		Use the rhsm_subscription resource for adding additional Redhat Subscription Manager subscriptions to your host. This can be used when a host's activation_key does not attach all necessary subscriptions to your host. This resource was ported from the `redhat_subscription_manager` community cookbook.


		### swap_file

		Use the swap_file resource to create or delete swap files on Linux systems and optionally manage the swappiness configuration for a host. This resource was ported from the `swap` community cookbook.


		### windows_feature

		Using the windows_feature resource to add, remove or delete Windows features and roles. This resource calls the `windows_feature_dism` or `windows_feature_powershell` resources depending on the specified installation method and defaults to dism, which is available on both Workstation and Server editions of Windows. This resource was ported from the `windows` community cookbook.


		### windows_font

		Use the windows_font resource to install or remove font files on Windows. Sources the font by default from the cookbook using the resource, but a URI source can be specified as well. This resource was ported from the `windows` community cookbook.

Add Chef 13.8 and 14.0 release notes #7074

Add Chef 13.8 and 14.0 release notes #7074

Conversation

tas50 commented Mar 27, 2018

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

stuartpreston left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

brewn Mar 27, 2018 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

brewn Mar 27, 2018 •

edited

Loading


		## Custom Resource Improvements

		We've expanded the DSL for custom resources with new functionality to better document your resources and help users with errors and upgrades. Many resources in Chef itself are now using this new functionality, and you'll see more updated to take advantage of this new functionality in the future.


		## Improved Resources

		Many existing resources include new actions and properties to expand their functionality.


		### registry_key

		The `sensitive` property can now be used in `registry_key` to supress the output of the key's data from logs and error messages. Thanks @shoekstra for implementing this.


		### windows_service

		`windows_service` now includes actions for fully managing services on Windows in addition to the previous actions for starting/stopping/enabling services.


		### Virtualization / Container Detection

		In addition to detecting if a system is a docker host we now provide a large amount of Docker configuration information available at `node['docker']`. This including the release of docker, installed plugins, network config, and the number of running containers.


		Ohai now includes the ability to mark plugins as optional, which skips those plugins by default. This allows us to ship additional plugins, which some users may find useful, but not all users would want being written to their Chef server. The change introduces two new configuration options; `run_all_plugins` which runs everything including optional plugins, and `optional_plugins` which allows you to run plugins marked as optional.

		By default we will now be marking the `lspci`, `sessions` and `passwd` plugins as optional. Passwd has been particularly problematic for nodes attached LDAP or AD where it attempts to write the entire directory to the node. If you previously disabled this plugin via Ohai config, you no longer need to. Hurray!


		Many users of Policies rely on "hoisting" to provide group specific attributes. This approach was formalized in the poise-hoist extension, and is now included in Chef 14.

		To hoist an attribute, the user provide a default attribute structure in their Policyfile similar to:


		### Logging Improvements

		Chef now includes a new log level of `:trace` in addition to the existing `:info`, `:warn`, and `:debug` levels. With the introduction of `trace` level logging we've moved a large amount of logging that more useful for Chef developers from `debug` to `trace`. This makes it easier for Chef Cookbook developers to use `debug` level to get useful information.


		### hostname

		Use the hostname resource to sets the system's hostname, configure hostname and hosts config file, and re-run the Ohai hostname plugin so the hostname will be available in subsequent cookbooks. This resource was ported from the `chef_hostname` community cookbook.


		### rhsm_repo

		Use the rhsm_repo resource to enabling or disabling Red Hat Subscription Manager repositories that are made available via attached subscriptions. This resource was ported from the `redhat_subscription_manager` community cookbook.