"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/topics/releases/2019.2.0.rst" between
salt-2019.2.0.tar.gz and salt-2019.2.1.tar.gz

About: SaltStack is a systems management software for data center automation, cloud orchestration, server provisioning, configuration management and more. Community version.

2019.2.0.rst  (salt-2019.2.0):2019.2.0.rst  (salt-2019.2.1)
.. _release-2019-2-0: .. _release-2019-2-0:
=============================================== ===============================================
Salt 2019.2.0 Release Notes - Codename Fluorine Salt 2019.2.0 Release Notes - Codename Fluorine
=============================================== ===============================================
Python 2.7 Deprecation
======================
In light of Python 2.7 reaching its End of Life (EOL) on Jan 1st 2020,
Python 2 will be deprecated from SaltStack no earlier than the Sodium
release, that is either the Sodium release or a later release.
This decision is pending further community discussion.
Non-Backward-Compatible Change to YAML Renderer Non-Backward-Compatible Change to YAML Renderer
=============================================== ===============================================
In earlier releases, this was considered valid usage in Python 2, assuming that In earlier releases, this was considered valid usage in Python 2, assuming that
``data`` was a list or dictionary containing keys/values which are ``unicode`` ``data`` was a list or dictionary containing keys/values which are ``unicode``
types: types:
.. code-block:: jinja .. code-block:: jinja
/etc/foo.conf: /etc/foo.conf:
skipping to change at line 44 skipping to change at line 52
.. code-block:: jinja .. code-block:: jinja
/etc/foo.conf: /etc/foo.conf:
file.managed: file.managed:
- source: salt://foo.conf.jinja - source: salt://foo.conf.jinja
- template: jinja - template: jinja
- context: - context:
data: {{ data|tojson }} data: {{ data|tojson }}
Another example where the new filter needs to be used is the following state exa
mple:
.. code-block:: jinja
grafana_packages:
pkg.installed:
- names: {{ server.pkgs }}
This will fail when pkgs is a list or dictionary. You will need to update the st
ate:
.. code-block:: jinja
grafana_packages:
pkg.installed:
- names: {{ server.pkgs|tojson }}
This test case has also been tested with the ``yaml`` and ``json`` filters succe
ssfully.
.. note:: .. note::
This filter was added in Jinja 2.9. However, fear not! The 2018.3.3 release This filter was added in Jinja 2.9. However, fear not! The 2018.3.3 release
added a ``tojson`` filter which will be used if this filter is not already added a ``tojson`` filter which will be used if this filter is not already
present, making it available on platforms like RHEL 7 and Ubuntu 14.04 present, making it available on platforms like RHEL 7 and Ubuntu 14.04
which provide older versions of Jinja. which provide older versions of Jinja.
.. important:: .. important::
The :jinja_ref:`json_encode_dict` and :jinja_ref:`json_encode_list` filters The :jinja_ref:`json_encode_dict` and :jinja_ref:`json_encode_list` filters
do not actually dump the results to JSON. Since ``tojson`` accomplishes do not actually dump the results to JSON. Since ``tojson`` accomplishes
what those filters were designed to do, they are now deprecated and will be what those filters were designed to do, they are now deprecated and will be
skipping to change at line 266 skipping to change at line 292
To replace various configuration chunks, you can use the new To replace various configuration chunks, you can use the new
:mod:`net.replace_pattern <salt.modules.napalm_network.replace_pattern>` :mod:`net.replace_pattern <salt.modules.napalm_network.replace_pattern>`
execution function, or the execution function, or the
:mod:`netconfig.replace_pattern <salt.states.netconfig.replace_pattern>` State :mod:`netconfig.replace_pattern <salt.states.netconfig.replace_pattern>` State
function. For example, if you want to update your configuration and rename function. For example, if you want to update your configuration and rename
a BGP policy referenced in many places, you can do so by running: a BGP policy referenced in many places, you can do so by running:
.. code-block:: bash .. code-block:: bash
salt '*' net.replae_pattern OLD-POLICY-CONFIG new-policy-config salt '*' net.replace_pattern OLD-POLICY-CONFIG new-policy-config
Similarly, you can also replace entire configuration blocks using the Similarly, you can also replace entire configuration blocks using the
:mod:`net.blockreplace <salt.modules.napalm_network.blockreplace>` function. :mod:`net.blockreplace <salt.modules.napalm_network.blockreplace>` function.
Configuration Save Features Configuration Save Features
""""""""""""""""""""""""""" """""""""""""""""""""""""""
The :mod:`net.save_config <salt.modules.napalm_network.save_config>` function The :mod:`net.save_config <salt.modules.napalm_network.save_config>` function
can be used to save the configuration of the managed device into a file. For can be used to save the configuration of the managed device into a file. For
the State subsystem, the :mod:`netconfig.saved <salt.states.netconfig.saved>` the State subsystem, the :mod:`netconfig.saved <salt.states.netconfig.saved>`
skipping to change at line 482 skipping to change at line 508
<salt.modules.dockermod.call>`. Any state module calls are passed through the <salt.modules.dockermod.call>`. Any state module calls are passed through the
corresponding function from the :py:mod:`docker <salt.modules.dockermod>` corresponding function from the :py:mod:`docker <salt.modules.dockermod>`
module. module.
.. code-block:: yaml .. code-block:: yaml
proxy: proxy:
proxytype: docker proxytype: docker
name: keen_proskuriakova name: keen_proskuriakova
Terraform Salt-SSH Roster
=========================
You can now dynamically generate a Salt-SSH roster from the terraform resources
defined with `terraform-provider-salt <https://github.com/dmacvicar/terraform-pr
ovider-salt>`_.
This allows you to combine both terraform and Salt-SSH to provision and
configure your hosts. See the :py:mod:`terraform roster<salt.roster.terraform>`
for
an example on how to setup and use.
Grains Dictionary Passed into Custom Grains Grains Dictionary Passed into Custom Grains
=========================================== ===========================================
Starting in this release, if a custom grains function accepts a variable named Starting in this release, if a custom grains function accepts a variable named
``grains``, the Grains dictionary of the already compiled grains will be passed ``grains``, the Grains dictionary of the already compiled grains will be passed
in. Because of the non-deterministic order that grains are rendered in, the in. Because of the non-deterministic order that grains are rendered in, the
only grains that can be relied upon to be passed in are ``core.py`` grains, only grains that can be relied upon to be passed in are ``core.py`` grains,
since those are compiled first. since those are compiled first.
More Precise ``virtual`` Grain More Precise ``virtual`` Grain
skipping to change at line 1323 skipping to change at line 1359
Execution Modules Execution Modules
----------------- -----------------
- :mod:`salt.modules.ciscoconfparse_mod <salt.modules.ciscoconfparse_mod>` - :mod:`salt.modules.ciscoconfparse_mod <salt.modules.ciscoconfparse_mod>`
- :mod:`salt.modules.jira <salt.modules.jira_mod>` - :mod:`salt.modules.jira <salt.modules.jira_mod>`
- :mod:`salt.modules.google_chat <salt.modules.google_chat>` - :mod:`salt.modules.google_chat <salt.modules.google_chat>`
- :mod:`salt.modules.iosconfig <salt.modules.iosconfig>` - :mod:`salt.modules.iosconfig <salt.modules.iosconfig>`
- :mod:`salt.modules.netmiko <salt.modules.netmiko_mod>` - :mod:`salt.modules.netmiko <salt.modules.netmiko_mod>`
- :mod:`salt.modules.nxos_api <salt.modules.nxos_api>` - :mod:`salt.modules.nxos_api <salt.modules.nxos_api>`
- :mod:`salt.modules.peeringdb <salt.modules.peeringdb>` - :mod:`salt.modules.peeringdb <salt.modules.peeringdb>`
- :mod:`salt.modules.purefb <salt.modules.purefb>`
- :mod:`salt.modules.pyeapi <salt.modules.arista_pyeapi>` - :mod:`salt.modules.pyeapi <salt.modules.arista_pyeapi>`
Pillar Modules Pillar Modules
-------------- --------------
- :mod:`netbox <salt.pillar.netbox>` - :mod:`netbox <salt.pillar.netbox>`
Proxy Modules Proxy Modules
------------- -------------
 End of changes. 5 change blocks. 
1 lines changed or deleted 43 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)