|
1 | | - |
2 | 1 | ===================================================== |
3 | | -Release Notes: |chef server_title| 12.4 |
| 2 | +Release Notes: |chef client| 12.4 |
4 | 3 | ===================================================== |
5 | 4 |
|
6 | | -.. include:: ../../includes_chef/includes_chef_index.rst |
| 5 | +.. include:: ../../includes_chef/includes_chef.rst |
7 | 6 |
|
8 | 7 | What's New |
9 | 8 | ===================================================== |
10 | | -The following items are new for |chef server| 12.4: |
| 9 | +The following items are new for |chef client| 12.4 and/or are changes from previous versions. The short version: |
11 | 10 |
|
12 | | -* **/universe endpoint** Use the ``/universe`` endpoint to retrieve the known collection of cookbooks, and then use it with |berkshelf| and |supermarket|. |
| 11 | +* **Validatorless bootstrap now requires the node name** Use of the ``-N node_name`` option with a validatorless bootstrap is now required. |
| 12 | +* **remote_file resource supports Windows UNC paths for source location** A |windows| UNC path may be used to specify the location of a remote file. |
| 13 | +* **Run PowerShell commands without excessive quoting** Use the ``Import-Module chef`` module to run |windows powershell| commands without excessive quotation. |
| 14 | +* **Logging may use the Windows Event Logger** Log files may be sent to the |windows event logger|. Set the ``log_location`` setting in the |client rb| file to ``Chef::Log::WinEvt.new``. |
| 15 | +* **Logging may be configured to use daemon facility available to the chef-client** Log files may be sent to the syslog available to the |chef client|. Set the ``log_location`` setting in the |client rb| file to ``Chef::Log::Syslog.new("chef-client", ::Syslog::LOG_DAEMON)``. |
| 16 | +* **Package locations on the Windows platform may be specified using a URL** The location of a package may be at URL when using the |resource package_windows| resource. |
| 17 | +* **Package locations on the Windows platform may be specified by passing attributes to the remote_file resource** Use the ``remote_file_attributes`` attribute to pass a |ruby hash| of attributes that modifies the |resource remote_file| resource. |
| 18 | +* **Public key management for users and clients** The |subcommand knife client| and |subcommand knife user| subcommands may now create, delete, edit, list, and show public keys. |
| 19 | +* **chef-client audit-mode is no longer marked as "experimental"** The recommended version of |chef client_audit| is |chef client| 12.4, where it is no longer marked as experimental. The |chef client| will report audit failures independently of converge failures. |
13 | 20 |
|
14 | | -/universe |
15 | | -===================================================== |
16 | | -.. include:: ../../includes_api_chef_server/includes_api_chef_server_endpoint_universe.rst |
| 21 | +UNC paths, |resource remote_file| |
| 22 | +----------------------------------------------------- |
| 23 | +When using the |resource remote_file| resource, the location of a source file may be specified using a |windows| UNC. For example: |
| 24 | + |
| 25 | +.. code-block:: ruby |
| 26 | +
|
| 27 | + source "\\\\path\\to\\img\\sketch.png" |
| 28 | +
|
| 29 | +Import-Module chef |
| 30 | +----------------------------------------------------- |
| 31 | +.. include:: ../../includes_knife/includes_knife_common_windows_quotes_module.rst |
| 32 | + |
| 33 | +|client rb| Settings |
| 34 | +----------------------------------------------------- |
| 35 | +The following settings have changed: |
| 36 | + |
| 37 | +.. list-table:: |
| 38 | + :widths: 200 300 |
| 39 | + :header-rows: 1 |
| 40 | + |
| 41 | + * - Setting |
| 42 | + - Description |
| 43 | + * - ``log_location`` |
| 44 | + - |log_location| Possible values: ``/path/to/log_location``, ``STDOUT``, ``STDERR``, ``Chef::Log::WinEvt.new`` (|windows event logger|), or ``Chef::Log::Syslog.new("chef-client", ::Syslog::LOG_DAEMON)`` (writes to the syslog daemon facility with the originator set as ``chef-client``). The application log will specify the source as ``Chef``. Default value: ``STDOUT``. |
| 45 | + |
| 46 | +|resource package_windows| Updates |
| 47 | +----------------------------------------------------- |
| 48 | +The |resource package_windows| resource has two new attributes (``checksum`` and ``remote_file_attributes``) and the ``source`` attribute now supports using a URL: |
| 49 | + |
| 50 | +.. list-table:: |
| 51 | + :widths: 200 300 |
| 52 | + :header-rows: 1 |
| 53 | + |
| 54 | + * - Attribute |
| 55 | + - Description |
| 56 | + * - ``checksum`` |
| 57 | + - |checksum remote_file| Use when a URL is specified by the ``source`` attribute. |
| 58 | + * - ``remote_file_attributes`` |
| 59 | + - |remote_file_attributes| |
| 60 | + * - ``source`` |
| 61 | + - Optional. |source resource package| The location of the package may be at a URL. Default value: the ``name`` of the resource block. |see syntax| |
| 62 | + |
| 63 | +Examples: |
| 64 | + |
| 65 | +**Specify a URL for the source attribute** |
| 66 | + |
| 67 | +.. include:: ../../step_resource/step_resource_package_windows_source_url.rst |
| 68 | + |
| 69 | +**Specify path and checksum** |
| 70 | + |
| 71 | +.. include:: ../../step_resource/step_resource_package_windows_source_url_checksum.rst |
| 72 | + |
| 73 | +**Modify remote_file resource attributes** |
| 74 | + |
| 75 | +.. include:: ../../step_resource/step_resource_package_windows_source_remote_file_attributes.rst |
| 76 | + |
| 77 | + |
| 78 | + |
| 79 | +knife client key |
| 80 | +----------------------------------------------------- |
| 81 | +.. include:: ../../includes_knife/includes_knife_client.rst |
| 82 | + |
| 83 | +key create |
| 84 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 85 | +.. include:: ../../includes_knife/includes_knife_client_key_create.rst |
17 | 86 |
|
18 | | -GET |
| 87 | +Syntax |
| 88 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 89 | +.. include:: ../../includes_knife/includes_knife_client_key_create_syntax.rst |
| 90 | + |
| 91 | +Options |
| 92 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 93 | +.. include:: ../../includes_knife/includes_knife_client_key_create_options.rst |
| 94 | + |
| 95 | +key delete |
| 96 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 97 | +.. include:: ../../includes_knife/includes_knife_client_key_delete.rst |
| 98 | + |
| 99 | +Syntax |
| 100 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 101 | +.. include:: ../../includes_knife/includes_knife_client_key_delete_syntax.rst |
| 102 | + |
| 103 | +key edit |
| 104 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 105 | +.. include:: ../../includes_knife/includes_knife_client_key_edit.rst |
| 106 | + |
| 107 | +Syntax |
| 108 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 109 | +.. include:: ../../includes_knife/includes_knife_client_key_edit_syntax.rst |
| 110 | + |
| 111 | +Options |
| 112 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 113 | +.. include:: ../../includes_knife/includes_knife_client_key_edit_options.rst |
| 114 | + |
| 115 | +key list |
| 116 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 117 | +.. include:: ../../includes_knife/includes_knife_client_key_list.rst |
| 118 | + |
| 119 | +Syntax |
| 120 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 121 | +.. include:: ../../includes_knife/includes_knife_client_key_list_syntax.rst |
| 122 | + |
| 123 | +Options |
| 124 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 125 | +.. include:: ../../includes_knife/includes_knife_client_key_list_options.rst |
| 126 | + |
| 127 | +key show |
| 128 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 129 | +.. include:: ../../includes_knife/includes_knife_client_key_show.rst |
| 130 | + |
| 131 | +Syntax |
| 132 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 133 | +.. include:: ../../includes_knife/includes_knife_client_key_show_syntax.rst |
| 134 | + |
| 135 | + |
| 136 | +knife user key |
19 | 137 | ----------------------------------------------------- |
20 | | -.. include:: ../../includes_api_chef_server/includes_api_chef_server_endpoint_universe_get.rst |
| 138 | +.. include:: ../../includes_knife/includes_knife_user.rst |
| 139 | + |
| 140 | +key create |
| 141 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 142 | +.. include:: ../../includes_knife/includes_knife_user_key_create.rst |
| 143 | + |
| 144 | +Syntax |
| 145 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 146 | +.. include:: ../../includes_knife/includes_knife_user_key_create_syntax.rst |
| 147 | + |
| 148 | +Options |
| 149 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 150 | +.. include:: ../../includes_knife/includes_knife_user_key_create_options.rst |
| 151 | + |
| 152 | +key delete |
| 153 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 154 | +.. include:: ../../includes_knife/includes_knife_user_key_delete.rst |
| 155 | + |
| 156 | +Syntax |
| 157 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 158 | +.. include:: ../../includes_knife/includes_knife_user_key_delete_syntax.rst |
| 159 | + |
| 160 | +key edit |
| 161 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 162 | +.. include:: ../../includes_knife/includes_knife_user_key_edit.rst |
| 163 | + |
| 164 | +Syntax |
| 165 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 166 | +.. include:: ../../includes_knife/includes_knife_user_key_edit_syntax.rst |
| 167 | + |
| 168 | +Options |
| 169 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 170 | +.. include:: ../../includes_knife/includes_knife_user_key_edit_options.rst |
| 171 | + |
| 172 | +key list |
| 173 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 174 | +.. include:: ../../includes_knife/includes_knife_user_key_list.rst |
| 175 | + |
| 176 | +Syntax |
| 177 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 178 | +.. include:: ../../includes_knife/includes_knife_user_key_list_syntax.rst |
| 179 | + |
| 180 | +Options |
| 181 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 182 | +.. include:: ../../includes_knife/includes_knife_user_key_list_options.rst |
| 183 | + |
| 184 | +key show |
| 185 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| 186 | +.. include:: ../../includes_knife/includes_knife_user_key_show.rst |
| 187 | + |
| 188 | +Syntax |
| 189 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 190 | +.. include:: ../../includes_knife/includes_knife_user_key_show_syntax.rst |
| 191 | + |
21 | 192 |
|
22 | | -What's Fixed |
| 193 | +Changelog |
23 | 194 | ===================================================== |
24 | | -For the list of issues that were addressed for this release, please see the changelog on |github|: https://github.com/chef/opscode-omnibus/blob/master/CHANGELOG.md |
| 195 | +https://github.com/chef/chef/blob/12.4.1/CHANGELOG.md |
0 commit comments