From fefd7aa7e88a1846fc9666da439a839495448d07 Mon Sep 17 00:00:00 2001 From: Jacob Hammons Date: Mon, 24 Aug 2015 10:13:01 -0600 Subject: [PATCH] 2015.8.0 release notes and doc/conf.py updates --- doc/conf.py | 16 +- doc/ref/cli/spm.rst | 2 + doc/topics/releases/2015.5.3.rst | 14 +- doc/topics/releases/2015.5.5.rst | 6 +- doc/topics/releases/2015.8.0.rst | 277 ++++++++++++++++++ .../releases/{ => includes}/2015.8.0rc2.rst | 52 ++-- .../releases/{ => includes}/2015.8.0rc3.rst | 10 +- .../git-2015.8.0.rst} | 172 +---------- doc/topics/releases/index.rst | 1 + 9 files changed, 332 insertions(+), 218 deletions(-) create mode 100644 doc/topics/releases/2015.8.0.rst rename doc/topics/releases/{ => includes}/2015.8.0rc2.rst (99%) rename doc/topics/releases/{ => includes}/2015.8.0rc3.rst (99%) rename doc/topics/releases/{beryllium.rst => includes/git-2015.8.0.rst} (56%) diff --git a/doc/conf.py b/doc/conf.py index 4a7f4c0baf..c15cabc388 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -162,16 +162,16 @@ project = 'Salt' copyright = '2015 SaltStack, Inc.' version = salt.version.__version__ -latest_release = '2015.5.3' # latest release -previous_release = '2014.7.6' # latest release from previous branch -previous_release_dir = '2014.7' # path on web server for previous branch -build_type = 'develop' # latest, previous, develop +latest_release = '2015.8.0' # latest release +previous_release = '2015.5.5' # latest release from previous branch +previous_release_dir = '2015.5' # path on web server for previous branch +build_type = 'latest' # latest, previous, develop # set release to 'version' for develop so sha is used # - otherwise - # set release to 'latest_release' or 'previous_release' -release = version # version, latest_release, previous_release +release = latest_release # version, latest_release, previous_release # Set google custom search engine @@ -179,6 +179,8 @@ if release == latest_release: search_cx = '004624818632696854117:yfmprrbw3pk' elif release.startswith('2014.7'): search_cx = '004624818632696854117:thhslradbru' +elif release.startswith('2015.5'): + search_cx = '004624818632696854117:ovogwef29do' else: search_cx = '004624818632696854117:haj7bjntf4s' # develop @@ -226,8 +228,8 @@ rst_prolog = """\ .. _`salt-packagers`: https://groups.google.com/forum/#!forum/salt-packagers .. |windownload| raw:: html - Salt-Minion-{release}-2-x86-Setup.exe - | md5 + Salt-Minion-{release}-x86-Setup.exe + | md5 """.format(release=release) diff --git a/doc/ref/cli/spm.rst b/doc/ref/cli/spm.rst index 796a205c0c..d74abcbb29 100644 --- a/doc/ref/cli/spm.rst +++ b/doc/ref/cli/spm.rst @@ -1,3 +1,5 @@ +.. _spm: + ======= ``spm`` ======= diff --git a/doc/topics/releases/2015.5.3.rst b/doc/topics/releases/2015.5.3.rst index c9cd2c3054..b0a747fb0a 100644 --- a/doc/topics/releases/2015.5.3.rst +++ b/doc/topics/releases/2015.5.3.rst @@ -1,6 +1,6 @@ - -Changes for v2015.5.2..v2015.5.3 --------------------------------- +=========================== +Salt 2015.5.3 Release Notes +=========================== Extended Changelog Courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs): @@ -621,7 +621,7 @@ Changes: - **ISSUE** `#24560`_: (*hydrosine*) Documentation missing on parameter | refs: `#24632`_ - - **ISSUE** `#24547`_: (*dragonpaw*) Artifactory docs say module is 'jboss7'. + - **ISSUE** `#24547`_: (*dragonpaw*) Artifactory docs say module is 'jboss7'. | refs: `#24632`_ - **ISSUE** `#24375`_: (*companykitchen-dev*) Custom grain won't sync under any circumstances | refs: `#24632`_ @@ -634,7 +634,7 @@ Changes: * c7cdd41 Doc bug fixes Refs `#24547`_ Refs `#24275`_ Refs `#24375`_ Refs `#24560`_ Refs `#24163`_ -- **PR** `#24607`_: (*garethgreenaway*) fixes to minion.py +- **PR** `#24607`_: (*garethgreenaway*) fixes to minion.py @ *2015-06-17T18:16:42Z* - **ISSUE** `#24198`_: (*ahammond*) salt-call event.send doesn't send events from minion @@ -852,7 +852,7 @@ Changes: | refs: `#24591`_ - **ISSUE** `#21217`_: (*Colstuwjx*) Maybe a bug for jinja render? | refs: `#24591`_ - - **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments - + - **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments - | refs: `#24631`_ - **PR** `#24492`_: (*DmitryKuzmenko*) Don't remove grains from opts * 5f491f9 Merge pull request `#24631`_ from rallytime/`bp-24591`_ @@ -1284,7 +1284,7 @@ Changes: - **PR** `#24426`_: (*basepi*) [2015.5] Merge forward from 2014.7 to 2015.5 @ *2015-06-05T03:59:11Z* - - **ISSUE** `#24276`_: (*markuskramerIgitt*) Live salt-master Profiling with SIGUSR2 fails + - **ISSUE** `#24276`_: (*markuskramerIgitt*) Live salt-master Profiling with SIGUSR2 fails - **PR** `#24405`_: (*jacksontj*) Fix for `#24276`_ - **PR** `#24395`_: (*hvnsweeting*) handle exceptions when received data is not in good shape - **PR** `#24305`_: (*twangboy*) Added documentation, fixed formatting diff --git a/doc/topics/releases/2015.5.5.rst b/doc/topics/releases/2015.5.5.rst index a8acda8a5b..a81b707af2 100644 --- a/doc/topics/releases/2015.5.5.rst +++ b/doc/topics/releases/2015.5.5.rst @@ -1,6 +1,6 @@ - -Changes for v2015.5.4..v2015.5.5 --------------------------------- +=========================== +Salt 2015.5.5 Release Notes +=========================== Extended changelog courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs): diff --git a/doc/topics/releases/2015.8.0.rst b/doc/topics/releases/2015.8.0.rst new file mode 100644 index 0000000000..9feb534a39 --- /dev/null +++ b/doc/topics/releases/2015.8.0.rst @@ -0,0 +1,277 @@ +================================================ +Salt 2015.8.0 Release Notes - Codename Beryllium +================================================ + +.. toctree:: + includes/2015.8.0rc2 + includes/2015.8.0rc3 + +The 2015.8.0 feature release of Salt contains several major new features. As +usual the release notes are not exhaustive and primarily include the most +notable additions and improvements. Hundreds of bugs have been fixed and many +modules have been substantially updated and added. + +Send Event on State Completion +============================== + +A `fire_event` global state keyword argument was added that allows any state to +send an event upon completion. Useful for custom progress bars and checking in +on long state runs. + +ZeroMQ socket monitoring +======================== + +If :conf_master:`zmq_monitor` is enabled, log all ZMQ events for socket monitoring +purposes. Verbose, but useful. + +SPM (Salt Package Manager) +========================== + +Allows Salt formulas to be packaged for ease of deployment. See :ref:`spm `. + +Specify a Single Environment for Top Files +========================================== + +A new :conf_master:`default_top` option was added to load the state top file +from a single, specific environment, rather than merging top data across all +environments. Additionally, new :conf_master:`top_file_merge_strategy` and +:conf_master:`env_order` options were added for more control over top file +merging. + +Tornado TCP Transport +===================== + +Implemented a pure-TCP transport, in addition to ZeroMQ and RAET. The new +transport uses Tornado, which allows Salt to use a standardized set of libraries +for asynchronous behavior, which should greatly improve reliability and +performance. + +.. note:: + + Tornado is considered early-access in this release. The following known + issues were being investigated at the time of release: + - TCP tests show + performance degredation over time (:issue:`26051`) + - TCP transport stacktrace on windows minion: Future exception was never + retrieved (:issue:`25718) + - [freebsd] TCP transport not working in 2015.8.0rc3 (:issue:`26364`) + +Core Changes +============ + +- Add system version info to ``versions_report``, which appears in both ``salt + --versions-report`` and ``salt '*' test.versions_report``. Also added is an + alias ``test.versions`` to ``test.versions_report``. (:issue:`21906`) + +- Add colorized console logging support. This is activated by using + ``%(colorlevel)s``, ``%(colorname)s``, ``%(colorprocess)s``, ``%(colormsg)s`` + in ``log_fmt_console`` in the config file for any of ``salt-master``, + ``salt-minion``, and ``salt-cloud``. + +Git Pillar +========== + +The git external pillar has been rewritten to bring it up to feature parity +with :mod:`gitfs `. Support for pygit2_ has been added, +bring with it the ability to access authenticated repositories. + +Using the new features will require updates to the git ext_pillar +configuration, further details can be found :ref:`here +`. + +Salt Cloud Improvements +======================= + +- Pricing data from several cloud providers (GCE, DigitalOcean, SoftLayer_HW, EC2) +- All cloud providers now use standardized bootstrapping code +- Modified the Linode Salt Cloud driver to use Linode's native API instead of + depending on apache-libcloud or linode-python. +- When querying for VMs in ``digital_ocean.py``, the number of VMs to include in + a page was changed from 20 (default) to 200 to reduce the number of API calls + to Digital + +Salt Cloud Changes +------------------ + +- Changed the default behavior of ``rename_on_destroy`` to be set to ``True`` + in the EC2 and AWS drivers. +- Changed the default behavior of the EC2 and AWS drivers to always check for + duplicate names of VMs before trying to create a new VM. Will now throw an + error similarly to other salt-cloud drivers when trying to create a VM of the + same name, even if the VM is in the ``terminated`` state. +- Modified the Linode Salt Cloud driver to use Linode's native API instead of + depending on apache-libcloud or linode-python. +- When querying for VMs in ``ditigal_ocean.py``, the number of VMs to include in + a page was changed from 20 (default) to 200 to reduce the number of API calls + to Digital Ocean.Ocean. + +State and Execution Module Improvements +======================================= + +- New and improved Docker state and execution modules (:mod:`state + ` and :mod:`execution module `). +.. toctree:: + includes/git-2015.8.0 +- OpenStack Glance API V2 execution module +- Amazon VPC state module +- RallyDev execution module +- BambooHR execution module +- Stormpath execution, state modules +- Remove unused argument ``timeout`` in jboss7.status. +- Deprecate ``enabled`` argument in ``pkgrepo.managed`` in favor of ``disabled``. +- Archive module changes: In the ``archive.tar`` and ``archive.cmd_unzip`` + module functions, remove the arbitrary prefixing of the options string with + ``-``. An options string beginning with a ``--long-option``, would have + uncharacteristically needed its first ``-`` removed under the former scheme. + Also, tar will parse its options differently if short options are used with or + without a preceding ``-``, so it is better to not confuse the user into + thinking they're using the non- ``-`` format, when really they are using the + with- ``-`` format. + +Windows Improvements +==================== + +- Templatize Windows Software package definitions +- Added additional capabilities to the user module for windows +- Added new module for managing windows updates (win_wua) +- Turned on multi-processing by default for windows in minion conf + +Windows Software Repo Changes +----------------------------- + +Several config options have been renamed to make their naming more consistent. +For a list of the winrepo config options, see :ref:`here +` for master config options, and :ref:`here +` for configuration options for masterless Windows +minions. + +On the master, the :mod:`winrepo.update_git_repos +` runner has been updated to use either +pygit2_ or GitPython_ to checkout the git repositories containing repo data. If +pygit2_ or GitPython_ is installed, existing winrepo git checkouts should be +removed after upgrading to 2015.8.0, to allow them to be checked out again by +running :py:func:`winrepo.update_git_repos +`. + +This enhancement also brings new functionality, see the :ref:`Windows Software +Repository <2015-8-0-winrepo-changes>` documentation for more information. + +If neither GitPython_ nor pygit2_ are installed, then Salt will fall back to +the pre-existing behavior for :mod:`winrepo.update_git_repos +`, and a warning will be logged in the +master log. + +.. note:: + Standalone Windows minions do not support the new GitPython_/pygit2_ + functionality, and will instead use the :py:func:`git.latest + ` state to keep repositories up-to-date. More + information on how to use the Windows Software Repo on a standalone minion + can be found :ref:`here `. + +.. _pygit2: https://github.com/libgit2/pygit2 +.. _GitPython: https://github.com/gitpython-developers/GitPython + +Win System Module +----------------- + +The unit of the ``timeout`` parameter in the ``system.halt``, +``system.poweroff``, ``system.reboot``, and ``system.shutdown`` functions has +been changed from seconds to minutes in order to be consistent with the linux +timeout setting. (:issue:`24411`) Optionally, the unit can be reverted to +seconds by specifying ``in_seconds=True``. + +Other Improvements +================== + +- Python 3 +- Sanitize sensitive fields in http.query +- Allow authorization to be read from Django and eauth +- Add templating to SMTP returner +- New REST module for SDB +- Added rest_timeout config option and timeout argument to jobs api call +- Provide config options for Raet lane and road buffer count. (Useful for BSD kernels) +- Implemented ZeroMQ socket monitor for master and minion +- Add end time to master job cache for jobs (optional, off by default) +- Tornado is now the default backend for http.request +- Support pillarenv selection as it's done for saltenv + +Deprecations +============ + +- The ``digital_ocean.py`` Salt Cloud driver was removed in favor of the + ``digital_ocean_v2.py`` driver as DigitalOcean has removed support for APIv1. + The ``digital_ocean_v2.py`` was renamed to ``digital_ocean.py`` and supports + DigitalOcean's APIv2. + +- The ``vsphere.py`` Salt Cloud driver has been deprecated in favor of the + ``vmware.py`` driver. + +- The ``openstack.py`` Salt Cloud driver has been deprecated in favor of the + ``nova.py`` driver. + +- The use of ``provider`` in Salt Cloud provider files to define cloud drivers + has been deprecated in favor of using ``driver``. Both terms will work until + the Nitrogen release of Salt. Example provider file: + +.. code-block:: yaml + + my-ec2-cloud-config: + id: 'HJGRYCILJLKJYG' + key: 'kdjgfsgm;woormgl/aserigjksjdhasdfgn' + private_key: /etc/salt/my_test_key.pem + keyname: my_test_key + securitygroup: default + driver: ec2 + +- The use of ``lock`` has been deprecated and from ``salt.utils.fopen``. + ``salt.utils.flopen`` should be used instead. + +- The following args have been deprecated from the ``rabbitmq_vhost.present`` + state: ``user``, ``owner``, ``conf``, ``write``, ``read``, and ``runas``. + +- The use of ``runas`` has been deprecated from the ``rabbitmq_vhost.absent`` + state. + +- Support for ``output`` in ``mine.get`` was removed. ``--out`` should be used + instead. + +- The use of ``delim`` was removed from the following functions in the ``match`` + execution module: ``pillar_pcre``, ``pillar``, ``grain_pcre``, + +Major Bug Fixes +=============== + +- Fixed minion failover to next master on DNS errors (:issue:`21082`) +- Fixed memory consuption in SaltEvents (:issue:`25557`) +- Don't lookup outside system path in which() util (:issue:`24085`) +- Fixed broken jobs rest api call (:issue:`23408`) +- Fixed stale grains data using in modules (:issue:`24073`) +- Added ssh_identities_only config flag for ssh-agent configured environments + (:issue:`24096`) +- Fixed "object has no attribute" errors for Raet transport (:issue:`21640`) +- Flush event returners before master exit (:issue:`22814`) +- Fix CommandExecutionError in grains generation with lspci missing (:issue:`23342`) +- Fix salt-ssh against CentOS 7 when python-zmq not installed (:issue:`23503`) +- Fix salt-ssh issues related to out-of-date six module (:issue:`20949`) +- Fix salt-ssh thin generation after previous run was interrupted (:issue:`24376`) +- Use proper line endings on Windows with "file.managed" w/contents (:issue:`25675`) +- Fixed broken comment/uncomment functions in file.py (:issue:`24620`) +- Fixed problem with unicode when changing computer description (:issue:`12255`) +- Fixed problem with chocolatey module not loading (:issue:`25717`) +- Fixed problem adding users to groups with spaces in the name (:issue:`25144`) +- Fixed problem adding full name to user account (:issue:`25206`) +- Fixed gem module stack trace (:issue:`21041`) +- Fixed problem with file.managed when test=True (:issue:`20441`) +- Fixed problem with powershell hanging while waiting for user input (:issue:`13943`) +- Fixed problem where the salt-minion service would not consistently start + (:issue:`25272`) +- Fixed problem where pkg.refresh_db would return True even when winrepo.p was not + found (:issue:`18919`) +- Could someone please provide end to end example for Proxy Minion with REST + (:issue:`25500`) +- Proxy minions stopped working between 2014.7 and 2015.5 (:issue:`25053`) +- Proxy minion documentation includes outdated code sample (:issue:`24018`) +- Proxy Minion documentation missing grains example (:issue:`18273`) +- Improve process management in proxy minion (:issue:`12024`) +- Proxy minion never comes up with message ' I am XXX and I am not supposed to + start any proxies.' (:issue:`25908`) diff --git a/doc/topics/releases/2015.8.0rc2.rst b/doc/topics/releases/includes/2015.8.0rc2.rst similarity index 99% rename from doc/topics/releases/2015.8.0rc2.rst rename to doc/topics/releases/includes/2015.8.0rc2.rst index 2a865af336..750ea874a9 100644 --- a/doc/topics/releases/2015.8.0rc2.rst +++ b/doc/topics/releases/includes/2015.8.0rc2.rst @@ -1,6 +1,6 @@ - -Changes for v2015.5.3..v2015.8.0rc2 ------------------------------------ +============================== +Salt 2015.8.0rc2 Release Notes +============================== Extended changelog courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs): @@ -1197,7 +1197,7 @@ Changes: - **PR** `#25257`_: (*notpeter*) Document SourceDestCheck added in `#25242`_. @ *2015-07-09T23:29:48Z* - - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that + - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that | refs: `#25242`_ - **PR** `#25242`_: (*ruzarowski*) Make SourceDestCheck flag available to network interface definition * cd405b4 Merge pull request `#25257`_ from notpeter/SourceDestCheck @@ -1322,7 +1322,7 @@ Changes: | refs: `#25173`_ - **PR** `#25001`_: (*jasonkeene*) Add docs for key arg in ssh_known_hosts.present | refs: `#25171`_ - - **PR** `#24421`_: (*bechtoldt*) add missing module documentation + - **PR** `#24421`_: (*bechtoldt*) add missing module documentation | refs: `#25019`_ - **PR** `#21880`_: (*bechtoldt*) update references, fixes `#21879`_ | refs: `#25019`_ @@ -1428,7 +1428,7 @@ Changes: - **PR** `#25242`_: (*ruzarowski*) Make SourceDestCheck flag available to network interface definition @ *2015-07-08T16:36:22Z* - - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that + - **ISSUE** `#25241`_: (*ruzarowski*) salt-cloud: SourceDestCheck flag not passed to AWS, provisioning NAT instances needs that | refs: `#25242`_ * 810b109 Merge pull request `#25242`_ from ruzarowski/2015.8 * 62b6d4f Make SourceDestCheck flag available to network interface definition @@ -2036,7 +2036,7 @@ Changes: | refs: `#25019`_ - **ISSUE** `#19262`_: (*bechtoldt*) salt.pillar.file_tree doesn't appear in the documentation | refs: `#25019`_ - - **PR** `#24421`_: (*bechtoldt*) add missing module documentation + - **PR** `#24421`_: (*bechtoldt*) add missing module documentation | refs: `#25019`_ - **PR** `#21880`_: (*bechtoldt*) update references, fixes `#21879`_ | refs: `#25019`_ @@ -2126,7 +2126,7 @@ Changes: - **PR** `#24976`_: (*cachedout*) Catch typeerror on msgpack failure @ *2015-06-25T22:02:04Z* - - **ISSUE** `#19130`_: (*Mrten*) grain typechecking + - **ISSUE** `#19130`_: (*Mrten*) grain typechecking | refs: `#24976`_ * 8e60cc2 Merge pull request `#24976`_ from cachedout/issue_19130 * 9680996 Catch typeerror on msgpack failure @@ -3260,14 +3260,14 @@ Changes: - **PR** `#24549`_: (*jfindlay*) Shutdown time @ *2015-06-11T16:20:55Z* - - **ISSUE** `#24411`_: (*vernondcole*) module system.shutdown timeout value not documented and inconsistant + - **ISSUE** `#24411`_: (*vernondcole*) module system.shutdown timeout value not documented and inconsistant | refs: `#24549`_ * 78a6814 Merge pull request `#24549`_ from jfindlay/shutdown_time * 79de6cd prefer shutdown timeout value in minutes on windows * b845775 document system.shutdown arg -- **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments - +- **PR** `#24591`_: (*tbaker57*) Add some documentation surrounding Jinja vs yaml comments - @ *2015-06-11T15:54:17Z* - **ISSUE** `#24494`_: (*arnoutpierre*) Computed comments in jinja states @@ -3790,7 +3790,7 @@ Changes: * ffb5018 Fixed a small pylint error -- **PR** `#24421`_: (*bechtoldt*) add missing module documentation +- **PR** `#24421`_: (*bechtoldt*) add missing module documentation | refs: `#25019`_ @ *2015-06-05T00:30:39Z* @@ -4291,7 +4291,7 @@ Changes: * c4f5e23 Merge remote-tracking branch 'upstream/2015.5' into merge-forward-develop2 -- **PR** `#24248`_: (*msteed*) Reinit pycrypto RNG in Cloud multiprocess paths +- **PR** `#24248`_: (*msteed*) Reinit pycrypto RNG in Cloud multiprocess paths @ *2015-05-29T18:27:09Z* - **ISSUE** `#24176`_: (*nmadhok*) [salt-cloud] VM creation fails with NameError on develop branch @@ -6360,7 +6360,7 @@ Changes: * 72ed91a Add 'upload_path' option -- **PR** `#23282`_: (*lisa2lisa*) Iss23201-fix the revoke *.* bug for mysql module +- **PR** `#23282`_: (*lisa2lisa*) Iss23201-fix the revoke *.* bug for mysql module @ *2015-05-03T00:42:34Z* * bf867c6 Merge pull request `#23282`_ from lisa2lisa/iss23201 @@ -7410,7 +7410,7 @@ Changes: * 0e53fde fix authorityid bug -- **PR** `#23003`_: (*notpeter*) Typo in ssh.check_key_file doc example +- **PR** `#23003`_: (*notpeter*) Typo in ssh.check_key_file doc example @ *2015-04-24T03:16:34Z* * 336373c Merge pull request `#23003`_ from notpeter/develop @@ -9172,7 +9172,7 @@ Changes: - **PR** `#22414`_: (*syphernl*) Cloud: Do not look for disk underneath config in Proxmox driver @ *2015-04-07T19:13:54Z* - - **ISSUE** `#22382`_: (*ghost*) The 'proxmox' cloud provider alias, for the 'proxmox' driver, does not define the function 'disk'". + - **ISSUE** `#22382`_: (*ghost*) The 'proxmox' cloud provider alias, for the 'proxmox' driver, does not define the function 'disk'". | refs: `#22414`_ * ff04f10 Merge pull request `#22414`_ from syphernl/fix/proxmox_kvm * 6cfaeda Lint @@ -10807,7 +10807,7 @@ Changes: * 40b99a2 Merge pull request `#21947`_ from dmyerscough/20625-Fixing-invalid-syntax * ac93e11 Ensure nginx config check passes by checking the exit status.... Nginx writes messages to stderr even when there are no errors -- **PR** `#21930`_: (*ptonelli*) add hg_pillar similar to git_pillar +- **PR** `#21930`_: (*ptonelli*) add hg_pillar similar to git_pillar @ *2015-03-24T19:10:53Z* - **ISSUE** `#2`_: (*thatch45*) salt job queries @@ -11914,7 +11914,7 @@ Changes: - **PR** `#21554`_: (*rallytime*) Add versionadded directive to docker.lastest_running function @ *2015-03-11T19:33:20Z* - - **ISSUE** `#21547`_: (*jasonm-makerbot*) docker.latest_running not in 2015.2 + - **ISSUE** `#21547`_: (*jasonm-makerbot*) docker.latest_running not in 2015.2 | refs: `#21554`_ * e3e455e Merge pull request `#21554`_ from rallytime/versionadded_docker_func * 1c3a764 Add versionadded directive to docker.lastest_running function @@ -12274,7 +12274,7 @@ Changes: | refs: `#21421`_ - **ISSUE** `#8754`_: (*techhat*) [salt.cloud] Need test cases for salt.cloud providers | refs: `#21421`_ - - **PR** `#21421`_: (*junckritter*) Tests for cloud GCE provider + - **PR** `#21421`_: (*junckritter*) Tests for cloud GCE provider | refs: `#21429`_ * 0852db0 Merge pull request `#21429`_ from thatch45/junckritter-cloud-gce-tests * 0da8878 lint @@ -12570,7 +12570,7 @@ Changes: * a52ebda Merge pull request `#21286`_ from ahus1/ahus1_releasedocs * 0887dfe make latest 2014.7.x releases visible in documentation -- **PR** `#21285`_: (*pravka*) fix ca creation in tls module +- **PR** `#21285`_: (*pravka*) fix ca creation in tls module @ *2015-03-04T06:17:34Z* * b7d4232 Merge pull request `#21285`_ from atbell/fix_ca_creation @@ -13151,7 +13151,7 @@ Changes: * 35f1266 Merge pull request `#20968`_ from jayeshka/win_firewall-unit-test * d5b70b5 adding win_firewall unit test case -- **PR** `#20975`_: (*evilNullPointer*) Add Artifactory classifier support +- **PR** `#20975`_: (*evilNullPointer*) Add Artifactory classifier support @ *2015-02-24T21:38:29Z* * c61c3c1 Merge pull request `#20975`_ from FrimaStudio/add_artifactory_classifier @@ -14044,7 +14044,7 @@ Changes: | refs: `#20658`_ `#20658`_ - **PR** `#20618`_: (*cxfcxf*) add ranged interface support for bond interface | refs: `#20658`_ `#20649`_ - - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system, + - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system, | refs: `#20618`_ `#20658`_ `#20649`_ * 84fc28b Merge pull request `#20658`_ from cxfcxf/develop * 4ddc1b1 range interface support for vlan @@ -14099,7 +14099,7 @@ Changes: | refs: `#20658`_ `#20649`_ @ *2015-02-12T17:39:33Z* - - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system, + - **PR** `#20602`_: (*cxfcxf*) adding range interface support and ability to turn arpcheck off to redhat related system, | refs: `#20618`_ `#20658`_ `#20649`_ * 598f119 Merge pull request `#20618`_ from cxfcxf/develop * ef58955 add ranged interface support for bond and fix typo on rh6_eth.jinja @@ -14427,7 +14427,7 @@ Changes: - **PR** `#20537`_: (*rallytime*) More python 3 compatibility changes | refs: `#20542`_ - - **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied + - **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied | refs: `#20542`_ * f232f7f Merge pull request `#20542`_ from saltstack/revert-20537-py-3-compat * a0d5c3d Revert "More python 3 compatibility changes" @@ -14649,7 +14649,7 @@ Changes: * 3b1ff44 Merge pull request `#20454`_ from scream3/develop * 3f7f50b Fix wrong check for rvm script existence -- **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied +- **PR** `#20443`_: (*SmithSamuelM*) Fixed bug and reverted some unnecessary changes where .six.itervalues was applied | refs: `#20542`_ @ *2015-02-06T17:33:32Z* @@ -18596,7 +18596,7 @@ Changes: * 3a1cffd Merge pull request `#19322`_ from garethgreenaway/19132_simple_state_notification * 6a3c15a Adding a simple notification function to the test module. -- **PR** `#19307`_: (*blueicefield*) Feature : Adding functions to Mongodb module for the management of user roles +- **PR** `#19307`_: (*blueicefield*) Feature : Adding functions to Mongodb module for the management of user roles @ *2015-01-05T20:13:29Z* - **ISSUE** `#8933`_: (*thaddeusmt*) mongodb_user not creating users @@ -18830,7 +18830,7 @@ Changes: * 846c78e Merge pull request `#19261`_ from manonthemat/develop * cd47b6d environ.set -> environ.setenv -- **PR** `#19254`_: (*jacksontj*) Fix for: TypeError: pub() got multiple values for keyword argument 'user' +- **PR** `#19254`_: (*jacksontj*) Fix for: TypeError: pub() got multiple values for keyword argument 'user' @ *2014-12-28T20:42:16Z* * 7c85a70 Merge pull request `#19254`_ from jacksontj/multi_syndic diff --git a/doc/topics/releases/2015.8.0rc3.rst b/doc/topics/releases/includes/2015.8.0rc3.rst similarity index 99% rename from doc/topics/releases/2015.8.0rc3.rst rename to doc/topics/releases/includes/2015.8.0rc3.rst index 26c749dd3b..fea7d4df47 100644 --- a/doc/topics/releases/2015.8.0rc3.rst +++ b/doc/topics/releases/includes/2015.8.0rc3.rst @@ -1,6 +1,6 @@ - -Changes for v2015.8.0rc2..v2015.8.0rc3 --------------------------------------- +============================== +Salt 2015.8.0rc3 Release Notes +============================== Extended changelog courtesy of Todd Stansell (https://github.com/tjstansell/salt-changelogs): @@ -111,7 +111,7 @@ Changes: - **PR** `#25919`_: (*TheBigBear*) Minor update to msi un-installer info - **PR** `#25917`_: (*jmdcal*) adding missing format string | refs: `#25967`_ - - **PR** `#25905`_: (*rallytime*) Back-port `#25982`_ to 2015.5 + - **PR** `#25905`_: (*rallytime*) Back-port `#25982`_ to 2015.5 - **PR** `#25898`_: (*jfindlay*) clarify and expand syndic docs - **PR** `#25895`_: (*basepi*) [2015.5] Merge forward from 2014.7 to 2015.5 - **PR** `#25894`_: (*jacobhammons*) Minor doc bug fixes @@ -254,7 +254,7 @@ Changes: | refs: `#25642`_ - **ISSUE** `#25478`_: (*zyio*) salt-ssh - Unable to locate current thin version | refs: `#25862`_ - - **ISSUE** `#25447`_: (*spo0nman*) SaltMaster is crippled with Minion Re-Authentication + - **ISSUE** `#25447`_: (*spo0nman*) SaltMaster is crippled with Minion Re-Authentication | refs: `#25856`_ - **ISSUE** `#25437`_: (*lorengordon*) Stacktrace on Windows when running pkg.list_pkgs | refs: `#25763`_ diff --git a/doc/topics/releases/beryllium.rst b/doc/topics/releases/includes/git-2015.8.0.rst similarity index 56% rename from doc/topics/releases/beryllium.rst rename to doc/topics/releases/includes/git-2015.8.0.rst index cd0cf5893c..9fadfe219d 100644 --- a/doc/topics/releases/beryllium.rst +++ b/doc/topics/releases/includes/git-2015.8.0.rst @@ -1,42 +1,6 @@ -======================================= -Salt Release Notes - Codename Beryllium -======================================= - -Core Changes -============ - -- Add system version info to ``versions_report``, which appears in both ``salt - --versions-report`` and ``salt '*' test.versions_report``. Also added is an - alias ``test.versions`` to ``test.versions_report``. (:issue:`21906`) - -- Add colorized console logging support. This is activated by using - ``%(colorlevel)s``, ``%(colorname)s``, ``%(colorprocess)s``, ``%(colormsg)s`` - in ``log_fmt_console`` in the config file for any of ``salt-master``, - ``salt-minion``, and ``salt-cloud``. - -Salt Cloud Changes -================== - -- Changed the default behavior of ``rename_on_destroy`` to be set to ``True`` - in the EC2 and AWS drivers. -- Changed the default behavior of the EC2 and AWS drivers to always check for - duplicate names of VMs before trying to create a new VM. Will now throw an - error similarly to other salt-cloud drivers when trying to create a VM of the - same name, even if the VM is in the ``terminated`` state. -- Modified the Linode Salt Cloud driver to use Linode's native API instead of - depending on apache-libcloud or linode-python. -- When querying for VMs in ``ditigal_ocean.py``, the number of VMs to include in - a page was changed from 20 (default) to 200 to reduce the number of API calls - to Digital Ocean. - -New Docker State/Module -======================= - -A new docker :mod:`state ` and :mod:`execution module -` have been added. They will eventually take the place -of the existing state and execution module, but for now will exist alongside -them. +.. _2015.8.0-git-: +========================================= Git State and Execution Modules Rewritten ========================================= @@ -214,135 +178,3 @@ Changes to Functions in Git Execution Module - Added the ``command`` argument to allow for operations other than ``update`` to be run on submodules, and deprecated the ``init`` argument. To do a submodule update with ``init=True`` moving forward, use ``command=update - opts='--init'`` - - -Git Pillar Rewritten -==================== - -The git external pillar has been rewritten to bring it up to feature parity -with :mod:`gitfs `. Support for pygit2_ has been added, -bring with it the ability to access authenticated repositories. - -Using the new features will require updates to the git ext_pillar -configuration, further details can be found :ref:`here -`. - -.. note:: - As with :mod:`gitfs `, pygit2_ 0.20.3 is required to - use pygit2_ with the git external pillar. - -Windows Software Repo Changes -============================= - -Several config options have been renamed to make their naming more consistent. -For a list of the winrepo config options, see :ref:`here -` for master config options, and :ref:`here -` for configuration options for masterless Windows -minions. - -On the master, the :mod:`winrepo.update_git_repos -` runner has been updated to use either -pygit2_ or GitPython_ to checkout the git repositories containing repo data. If -pygit2_ or GitPython_ is installed, existing winrepo git checkouts should be -removed after upgrading to 2015.8.0, to allow them to be checked out again by -running :py:func:`winrepo.update_git_repos -`. - -This enhancement also brings new functionality, see the :ref:`Windows Software -Repository <2015-8-0-winrepo-changes>` documentation for more information. - -If neither GitPython_ nor pygit2_ are installed, then Salt will fall back to -the pre-existing behavior for :mod:`winrepo.update_git_repos -`, and a warning will be logged in the -master log. - -.. note:: - Standalone Windows minions do not support the new GitPython_/pygit2_ - functionality, and will instead use the :py:func:`git.latest - ` state to keep repositories up-to-date. More - information on how to use the Windows Software Repo on a standalone minion - can be found :ref:`here `. - -.. _pygit2: https://github.com/libgit2/pygit2 -.. _GitPython: https://github.com/gitpython-developers/GitPython - -JBoss 7 State -============= - -Remove unused argument ``timeout`` in jboss7.status. - -Pkgrepo State -============= - -Deprecate ``enabled`` argument in ``pkgrepo.managed`` in favor of ``disabled``. - -Archive Module -============== - -In the ``archive.tar`` and ``archive.cmd_unzip`` module functions, remove the -arbitrary prefixing of the options string with ``-``. An options string -beginning with a ``--long-option``, would have uncharacteristically needed its -first ``-`` removed under the former scheme. - -Also, tar will parse its options differently if short options are used with or -without a preceding ``-``, so it is better to not confuse the user into -thinking they're using the non- ``-`` format, when really they are using the -with- ``-`` format. - -Win System Module -================= - -The unit of the ``timeout`` parameter in the ``system.halt``, -``system.poweroff``, ``system.reboot``, and ``system.shutdown`` functions has -been changed from seconds to minutes in order to be consistent with the linux -timeout setting. (:issue:`24411`) Optionally, the unit can be reverted to -seconds by specifying ``in_seconds=True``. - -Deprecations -============ - -- The ``digital_ocean.py`` Salt Cloud driver was removed in favor of the -``digital_ocean_v2.py`` driver as DigitalOcean has removed support for APIv1. -The ``digital_ocean_v2.py`` was renamed to ``digital_ocean.py`` and supports -DigitalOcean's APIv2. - -- The ``vsphere.py`` Salt Cloud driver has been deprecated in favor of the -``vmware.py`` driver. - -- The ``openstack.py`` Salt Cloud driver has been deprecated in favor of the -``nova.py`` driver. - -- The use of ``provider`` in Salt Cloud provider files to define cloud drivers -has been deprecated in favor of useing ``driver``. Both terms will work until -the Nitrogen release of Salt. Example provider file: - -.. code-block:: yaml - - my-ec2-cloud-config: - id: 'HJGRYCILJLKJYG' - key: 'kdjgfsgm;woormgl/aserigjksjdhasdfgn' - private_key: /etc/salt/my_test_key.pem - keyname: my_test_key - securitygroup: default - driver: ec2 - -- The use of ``lock`` has been deprecated and from ``salt.utils.fopen``. -``salt.utils.flopen`` should be used instead. - -- The following args have been deprecated from the ``rabbitmq_vhost.present`` -state: ``user``, ``owner``, ``conf``, ``write``, ``read``, and ``runas``. - -- The use of ``runas`` has been deprecated from the ``rabbitmq_vhost.absent`` -state. - -- Support for ``output`` in ``mine.get`` was removed. ``--out`` should be used -instead. - -- The use of ``delim`` was removed from the following functions in the ``match`` -execution module: ``pillar_pcre``, ``pillar``, ``grain_pcre``, - -Known Issues -============ - -- The TCP transport does not function on FreeBSD. diff --git a/doc/topics/releases/index.rst b/doc/topics/releases/index.rst index e31a06e050..bfb0a160eb 100644 --- a/doc/topics/releases/index.rst +++ b/doc/topics/releases/index.rst @@ -17,6 +17,7 @@ Previous Releases :maxdepth: 1 :glob: + 2015.8.* 2015.5.* 2014.7.* 2014.1.*