valitydev/salt
14
0
Fork 0
mirror of https://github.com/valitydev/salt.git synced 2024-11-06 08:35:21 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge branch '2019.2.0.rc1' into 2019.2

Browse Source
This commit is contained in:
Ch3LL 2019-01-16 16:38:32 -05:00
commit 810c6119ec
No known key found for this signature in database
GPG Key ID: 132B55A7C13EFA73
135 changed files with 45073 additions and 7279 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.rst
View File

@ -2,7 +2,7 @@
What is SaltStack?
==================
SaltStack makes software for complex systems management at scale.
SaltStack makes software for complex systems management at scale.
SaltStack is the company that created and maintains the Salt Open
project and develops and sells SaltStack Enterprise software, services
and support. Easy enough to get running in minutes, scalable enough to

2
conf/minion
View File

@ -33,7 +33,7 @@
# and a warning will be logged.
#random_master: False
# NOTE: Deprecated in Salt Fluorine. Use 'random_master' instead.
# NOTE: Deprecated in Salt 2019.2.0. Use 'random_master' instead.
#master_shuffle: False
# Minions can connect to multiple masters simultaneously (all masters

2
doc/faq.rst
View File

@ -158,7 +158,7 @@ Similarly, custom states are synced to Minions when :py:func:`saltutil.sync_stat
They are both also synced when a :ref:`highstate <running-highstate>` is
triggered.
As of the Fluorine release, as well as 2017.7.7 and 2018.3.2 in their
As of the 2019.2.0 release, as well as 2017.7.7 and 2018.3.2 in their
respective release cycles, the ``sync`` argument to :py:func:`state.apply
<salt.modules.state.apply_>`/:py:func:`state.sls <salt.modules.state.sls>` can
be used to sync custom types when running individual SLS files.

2
doc/man/salt-api.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-API" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-API" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-api \- salt-api Command
.

2
doc/man/salt-call.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-CALL" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-CALL" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-call \- salt-call Documentation
.

2
doc/man/salt-cloud.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-CLOUD" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-CLOUD" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-cloud \- Salt Cloud Command
.

2
doc/man/salt-cp.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-CP" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-CP" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-cp \- salt-cp Documentation
.

2
doc/man/salt-key.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-KEY" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-KEY" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-key \- salt-key Documentation
.

2
doc/man/salt-master.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-MASTER" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-MASTER" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-master \- salt-master Documentation
.

2
doc/man/salt-minion.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-MINION" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-MINION" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-minion \- salt-minion Documentation
.

2
doc/man/salt-proxy.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-PROXY" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-PROXY" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-proxy \- salt-proxy Documentation
.

2
doc/man/salt-run.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-RUN" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-RUN" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-run \- salt-run Documentation
.

7
doc/man/salt-ssh.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-SSH" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-SSH" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-ssh \- salt-ssh Documentation
.
@ -177,6 +177,11 @@ Specify the SSH private key file to be used for authentication.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-priv\-passwd=SSH_PRIV_PASSWD
Specify the SSH private key file\(aqs passphrase if need be.
.UNINDENT
.INDENT 0.0
.TP
.B \-i, \-\-ignore\-host\-keys
By default ssh host keys are honored and connections will ask for
approval. Use this option to disable StrictHostKeyChecking.

2
doc/man/salt-syndic.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-SYNDIC" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-SYNDIC" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-syndic \- salt-syndic Documentation
.

2
doc/man/salt-unity.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT-UNITY" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT-UNITY" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt-unity \- salt-unity Command
.

2
doc/man/salt.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SALT" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SALT" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
salt \- salt
.

50619
doc/man/salt.7
View File

File diff suppressed because it is too large Load Diff

2
doc/man/spm.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
.TH "SPM" "1" "Sep 21, 2018" "2018.3.3" "Salt"
.TH "SPM" "1" "Jan 08, 2019" "2019.2.0" "Salt"
.SH NAME
spm \- Salt Package Manager Command
.

2
doc/ref/configuration/master.rst
View File

@ -1044,7 +1044,7 @@ cache events are fired when a minion requests a minion data cache refresh.
``http_connect_timeout``
------------------------
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Default: ``20``

14
doc/ref/configuration/minion.rst
View File

@ -213,7 +213,7 @@ minion event bus. The value is expressed in bytes.
``enable_legacy_startup_events``
--------------------------------
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Default: ``True``
@ -286,13 +286,13 @@ to the next master in the list if it finds the existing one is dead.
------------------
.. versionadded:: 2014.7.0
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
Default: ``False``
.. warning::
This option has been deprecated in Salt ``Fluorine``. Please use
This option has been deprecated in Salt ``2019.2.0``. Please use
:conf_minion:`random_master` instead.
.. code-block:: yaml
@ -305,7 +305,7 @@ Default: ``False``
-----------------
.. versionadded:: 2014.7.0
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
The :conf_minion:`master_failback` option can be used in conjunction with
``random_master`` to force the minion to fail back to the first master in the
list if the first master is back online. Note that :conf_minion:`master_type`
@ -1377,7 +1377,7 @@ talking to the intended master.
``http_connect_timeout``
------------------------
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Default: ``20``
@ -1463,7 +1463,7 @@ The password used for HTTP proxy access.
``no_proxy``
------------
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Default: ``[]``
@ -1486,7 +1486,7 @@ Docker Configuration
----------------------
.. versionadded:: 2017.7.8,2018.3.3
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
The default value is now ``False``
Default: ``True``

8
doc/topics/cloud/profitbricks.rst
View File

@ -156,7 +156,7 @@ command:
# salt-cloud --list-sizes my-profitbricks-config
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
One or more public IP address can be reserved with the following command:
@ -196,7 +196,7 @@ The following list explains some of the important properties.
- ``disk_type`` - This option allow the disk type to be set to HDD or SSD. The
default is HDD.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
- ``image_password`` - A password is set on the image for the "root" or
"Administrator" account. This field may only be set during volume creation.
@ -215,7 +215,7 @@ The following list explains some of the important properties.
LAN. If no LAN exists, then a new public LAN will be created. The value
accepts a LAN ID (integer).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
- ``public_ips`` - Public IPs assigned to the NIC in the public LAN.
@ -238,7 +238,7 @@ The following list explains some of the important properties.
private LAN. If no LAN exists, then a new private LAN will be created. The
value accepts a LAN ID (integer).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
- ``private_ips`` - Private IPs assigned in the private LAN. NAT setting is
ignored when this setting is active.

2
doc/topics/grains/index.rst
View File

@ -277,7 +277,7 @@ grains in ``_grains`` will override *any* grains of the same name.
For custom grains, if the function takes an argument ``grains``, then the
previously rendered grains will be passed in. Because the rest of the grains
could be rendered in any order, the only grains that can be relied upon to be
passed in are ``core`` grains. This was added in the Fluorine release.
passed in are ``core`` grains. This was added in the 2019.2.0 release.
Examples of Grains

6
doc/topics/jinja/index.rst
View File

@ -886,7 +886,7 @@ Example:
encoding (usually a ``unicode`` type). This filter was incorrectly-named
when it was added. ``json_decode_list`` will be supported until the Neon
release.
.. deprecated:: 2018.3.3,Fluorine
.. deprecated:: 2018.3.3,2019.2.0
The :jinja_ref:`tojson` filter accomplishes what this filter was designed
to do, making this filter redundant.
@ -919,7 +919,7 @@ Returns:
encoding (usually a ``unicode`` type). This filter was incorrectly-named
when it was added. ``json_decode_dict`` will be supported until the Neon
release.
.. deprecated:: 2018.3.3,Fluorine
.. deprecated:: 2018.3.3,2019.2.0
The :jinja_ref:`tojson` filter accomplishes what this filter was designed
to do, making this filter redundant.
@ -946,7 +946,7 @@ Returns:
``tojson``
----------
.. versionadded:: 2018.3.3,Fluorine
.. versionadded:: 2018.3.3,2019.2.0
Dumps a data structure to JSON.

4
doc/topics/releases/2017.7.0.rst
View File

@ -301,7 +301,7 @@ reports of confusion among community members, since the targeting method is
published to minions as ``tgt_type``, and appears as ``tgt_type`` in the job
cache as well.
While ``expr_form`` will continue to be supported until the **Fluorine**
While ``expr_form`` will continue to be supported until the **2019.2.0**
release cycle (two major releases after this one), those who are using the
:ref:`LocalClient <local-client>` (either directly, or implictly via a
:ref:`netapi module <all-netapi-modules>`) are encouraged to update their code
@ -566,7 +566,7 @@ of objects (users, databases, roles, etc.).
.. _`Moby announcement`: https://blog.docker.com/2017/04/introducing-the-moby-project/
.. _DockerCon: http://2017.dockercon.com/
The old syntax will continue to work until the **Fluorine** release of Salt.
The old syntax will continue to work until the **2019.2.0** release of Salt.
The old ``dockerng`` naming will also continue to work until that release, so
no immediate changes need to be made to your SLS files (unless you were still
using the old docker states that have been moved to salt-contrib_).

2
doc/topics/releases/2018.3.0.rst
View File

@ -250,7 +250,7 @@ examples.
.. note::
git_pillar does not yet support variable update intervals, this is targeted
for the next feature release (Fluorine).
for the next feature release (2019.2.0).
LDAP via External Authentication Changes
========================================

14
doc/topics/releases/fluorine.rst → doc/topics/releases/2019.2.0.rst
View File

@ -1,8 +1,8 @@
:orphan:
.. _release-2019-2-0:
======================================
Salt Release Notes - Codename Fluorine
======================================
===============================================
Salt 2019.2.0 Release Notes - Codename Fluorine
===============================================
Non-Backward-Compatible Change to YAML Renderer
===============================================
@ -62,7 +62,7 @@ Ansible Playbook State and Execution Modules
Along with the including the :py:mod:`ansible modules
<salt.module.ansiblegate>` in the Oxygen release, running playbooks has been
added in Fluorine with the :py:func:`playbooks function
added in 2019.2.0 with the :py:func:`playbooks function
<salt.modules.ansiblegate.playbooks>`. This also includes an :py:func:`ansible
playbooks state module <salt.states.ansiblegate.playbooks>` which can be used
on a targeted host to run ansible playbooks, or used in an
@ -918,7 +918,7 @@ Minion Configuration Deprecations
---------------------------------
The :conf_minion:`master_shuffle` configuration option is deprecated as of the
``Fluorine`` release. Please use the :conf_minion:`random_master` option instead.
``2019.2.0`` release. Please use the :conf_minion:`random_master` option instead.
Module Deprecations
-------------------
@ -988,7 +988,7 @@ Roster Deprecations
- The :py:mod:`cache <salt.roster.cache>` roster has been changed as follows:
- Support for ``roster_order`` as a list or tuple has been removed. As of
the ``Fluorine`` release, ``roster_order`` must be a dictionary.
the ``2019.2.0`` release, ``roster_order`` must be a dictionary.
- The ``roster_order`` option now includes IPv6 in addition to IPv4 for the
``private``, ``public``, ``global`` or ``local`` settings. The syntax for

1
doc/topics/releases/index.rst
View File

@ -20,6 +20,7 @@ Previous Releases
:maxdepth: 1
:glob:
2019.2.*
2018.3.*
2017.7.*
2016.11.*

2
doc/topics/releases/version_numbers.rst
View File

@ -35,7 +35,7 @@ Assigned codenames:
- Carbon: ``2016.11.0``
- Nitrogen: ``2017.7.0``
- Oxygen: ``2018.3.0``
- Fluorine: ``TBD``
- Fluorine: ``2019.2.0``
- Neon: ``TBD``
- Sodium: ``TBD``

4
doc/topics/targeting/index.rst
View File

@ -116,10 +116,10 @@ There are many ways to target individual minions or groups of minions in Salt:
Loadable Matchers
=================
.. versionadded:: Flourine
.. versionadded:: 2019.2.0
Internally targeting is implemented with chunks of code called Matchers. As of
the Flourine release, matchers can be loaded dynamically. Currently new matchers
the 2019.2.0 release, matchers can be loaded dynamically. Currently new matchers
cannot be created, but existing matchers can have their functionality altered or
extended. For more information on Matchers see

4
doc/topics/targeting/nodegroups.rst
View File

@ -59,12 +59,12 @@ To match a nodegroup on the CLI, use the ``-N`` command-line option:
salt -N group1 test.ping
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. note::
The ``N@`` classifier historically could not be used in compound matches
within the CLI or :term:`top file`, it was only recognized in the
:conf_master:`nodegroups` master config file parameter. As of the Fluorine
:conf_master:`nodegroups` master config file parameter. As of the 2019.2.0
release, this limitation no longer exists.
To match a nodegroup in your :term:`top file`, make sure to put ``- match:

2
doc/topics/utils/index.rst
View File

@ -145,7 +145,7 @@ following Salt functions are called:
* :py:func:`saltutil.sync_utils <salt.modules.saltutil.sync_utils>`
* :py:func:`saltutil.sync_all <salt.modules.saltutil.sync_all>`
As of the Fluorine release, as well as 2017.7.7 and 2018.3.2 in their
As of the 2019.2.0 release, as well as 2017.7.7 and 2018.3.2 in their
respective release cycles, the ``sync`` argument to :py:func:`state.apply
<salt.modules.state.apply_>`/:py:func:`state.sls <salt.modules.state.sls>` can
be used to sync custom types when running individual SLS files.

12
pkg/windows/clean_env.bat
View File

@ -37,6 +37,10 @@ goto CheckPython3
MsiExec.exe /X {0398A685-FD8D-46B3-9816-C47319B0CF5E} /QN
echo %0 :: - 2.7.14 (64 bit)
MsiExec.exe /X {0398A685-FD8D-46B3-9816-C47319B0CF5F} /QN
echo %0 :: - 2.7.15 (32 bit)
MsiExec.exe /X {16CD92A4-0152-4CB7-8FD6-9788D3363616} /QN
echo %0 :: - 2.7.15 (64 bit)
MsiExec.exe /X {16CD92A4-0152-4CB7-8FD6-9788D3363617} /QN
echo.
@ -63,12 +67,20 @@ goto eof
echo %0 :: - 3.5.3 64bit
"%LOCALAPPDATA%\Package Cache\{b94f45d6-8461-440c-aa4d-bf197b2c2499}\python-3.5.3-amd64.exe" /uninstall /quiet
)
if exist "%LOCALAPPDATA%\Package Cache\{5d57524f-af24-49a7-b90b-92138880481e}" (
echo %0 :: - 3.5.4 64bit
"%LOCALAPPDATA%\Package Cache\{5d57524f-af24-49a7-b90b-92138880481e}\python-3.5.4-amd64.exe" /uninstall /quiet
)
:: 32 bit
if exist "%LOCALAPPDATA%\Package Cache\{a10037e1-4247-47c9-935b-c5ca049d0299}" (
echo %0 :: - 3.5.3 32bit
"%LOCALAPPDATA%\Package Cache\{a10037e1-4247-47c9-935b-c5ca049d0299}\python-3.5.3" /uninstall /quiet
)
if exist "%LOCALAPPDATA%\Package Cache\{06e841fa-ca3b-4886-a820-cd32c614b0c1}" (
echo %0 :: - 3.5.4 32bit
"%LOCALAPPDATA%\Package Cache\{06e841fa-ca3b-4886-a820-cd32c614b0c1}\python-3.5.4" /uninstall /quiet
)
rem wipe the Python directory
echo %0 :: Removing the C:\Python35 Directory ...

8
pkg/windows/modules/get-settings.psm1
View File

@ -54,15 +54,15 @@ Function Get-Settings {
# Filenames for 64 bit Windows
$64bitPrograms = @{
"Python2" = "python-2.7.14.amd64.msi"
"Python3" = "python-3.5.3-amd64.exe"
"Python2" = "python-2.7.15.amd64.msi"
"Python3" = "python-3.5.4-amd64.exe"
}
$ini.Add("64bitPrograms", $64bitPrograms)
# Filenames for 32 bit Windows
$32bitPrograms = @{
"Python2" = "python-2.7.14.msi"
"Python3" = "python-3.5.3.exe"
"Python2" = "python-2.7.15.msi"
"Python3" = "python-3.5.4.exe"
}
$ini.Add("32bitPrograms", $32bitPrograms)

2
salt/beacons/watchdog.py
View File

@ -2,7 +2,7 @@
'''
watchdog beacon
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Watch files and translate the changes into salt events

2
salt/beacons/wtmp.py
View File

@ -71,7 +71,7 @@ can be overridden using a ``ut_type`` key in the beacon configuration:
This beacon's events include an ``action`` key which will be either ``login``
or ``logout`` depending on the event type.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
``action`` key added to beacon event, and ``ut_type`` config parameter
added.

8
salt/cloud/clouds/azurearm.py
View File

@ -5,7 +5,7 @@ Azure ARM Cloud Module
.. versionadded:: 2016.11.0
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
The Azure ARM cloud module is used to control access to Microsoft Azure Resource Manager
@ -1883,7 +1883,7 @@ def list_subnets(call=None, kwargs=None):
def create_or_update_vmextension(call=None, kwargs=None): # pylint: disable=unused-argument
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a VM extension object "inside" of a VM object.
@ -1989,7 +1989,7 @@ def create_or_update_vmextension(call=None, kwargs=None): # pylint: disable=unu
def stop(name, call=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Stop (deallocate) a VM
@ -2050,7 +2050,7 @@ def stop(name, call=None):
def start(name, call=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Start a VM

3
salt/cloud/clouds/ec2.py
View File

@ -97,6 +97,7 @@ import decimal
# Import Salt Libs
import salt.utils.cloud
import salt.utils.compat
import salt.utils.files
import salt.utils.hashutils
import salt.utils.json
@ -1225,7 +1226,7 @@ def get_imageid(vm_):
_t = lambda x: datetime.datetime.strptime(x['creationDate'], '%Y-%m-%dT%H:%M:%S.%fZ')
image_id = sorted(aws.query(params, location=get_location(),
provider=get_provider(), opts=__opts__, sigver='4'),
lambda i, j: cmp(_t(i), _t(j))
lambda i, j: salt.utils.compat.cmp(_t(i), _t(j))
)[-1]['imageId']
get_imageid.images[image] = image_id
return image_id

304
salt/cloud/deploy/bootstrap-salt.sh
View File

@ -1,4 +1,9 @@
#!/bin/sh -
# WARNING: Changes to this file in the salt repo will be overwritten!
# Please submit pull requests against the salt-bootstrap repo:
# https://github.com/saltstack/salt-bootstrap
#======================================================================================================================
# vim: softtabstop=4 shiftwidth=4 expandtab fenc=utf-8 spell spelllang=en cc=120
#======================================================================================================================
@ -18,7 +23,7 @@
#======================================================================================================================
set -o nounset # Treat unset variables as an error
__ScriptVersion="2018.08.15"
__ScriptVersion="2019.01.08"
__ScriptName="bootstrap-salt.sh"
__ScriptFullName="$0"
@ -585,14 +590,14 @@ elif [ "$ITYPE" = "stable" ]; then
if [ "$#" -eq 0 ];then
STABLE_REV="latest"
else
if [ "$(echo "$1" | grep -E '^(latest|1\.6|1\.7|2014\.1|2014\.7|2015\.5|2015\.8|2016\.3|2016\.11|2017\.7|2018\.3)$')" != "" ]; then
if [ "$(echo "$1" | grep -E '^(latest|1\.6|1\.7|2014\.1|2014\.7|2015\.5|2015\.8|2016\.3|2016\.11|2017\.7|2018\.3|2019\.2)$')" != "" ]; then
STABLE_REV="$1"
shift
elif [ "$(echo "$1" | grep -E '^([0-9]*\.[0-9]*\.[0-9]*)$')" != "" ]; then
STABLE_REV="archive/$1"
shift
else
echo "Unknown stable version: $1 (valid: 1.6, 1.7, 2014.1, 2014.7, 2015.5, 2015.8, 2016.3, 2016.11, 2017.7, 2018.3, latest, \$MAJOR.\$MINOR.\$PATCH)"
echo "Unknown stable version: $1 (valid: 1.6, 1.7, 2014.1, 2014.7, 2015.5, 2015.8, 2016.3, 2016.11, 2017.7, 2018.3, 2019.2, latest, \$MAJOR.\$MINOR.\$PATCH)"
exit 1
fi
fi
@ -1269,6 +1274,7 @@ __ubuntu_derivatives_translation() {
linuxmint_13_ubuntu_base="12.04"
linuxmint_17_ubuntu_base="14.04"
linuxmint_18_ubuntu_base="16.04"
linuxmint_19_ubuntu_base="18.04"
linaro_12_ubuntu_base="12.04"
elementary_os_02_ubuntu_base="12.04"
neon_16_ubuntu_base="16.04"
@ -1632,7 +1638,8 @@ __check_end_of_life_versions() {
amazon*linux*ami)
# Amazon Linux versions lower than 2012.0X no longer supported
if [ "$DISTRO_MAJOR_VERSION" -lt 2012 ]; then
# Except for Amazon Linux 2, which reset the major version counter
if [ "$DISTRO_MAJOR_VERSION" -lt 2012 ] && [ "$DISTRO_MAJOR_VERSION" -gt 10 ]; then
echoerror "End of life distributions are not supported."
echoerror "Please consider upgrading to the next stable. See:"
echoerror " https://aws.amazon.com/amazon-linux-ami/"
@ -1797,24 +1804,32 @@ __function_defined() {
# process is finished so the script doesn't exit on a locked proc.
#----------------------------------------------------------------------------------------------------------------------
__wait_for_apt(){
echodebug "Checking if apt process is currently running."
# Timeout set at 15 minutes
WAIT_TIMEOUT=900
while ps -C apt,apt-get,aptitude,dpkg >/dev/null; do
sleep 1
WAIT_TIMEOUT=$((WAIT_TIMEOUT - 1))
# Run our passed in apt command
"${@}"
APT_RETURN=$?
# If timeout reaches 0, abort.
if [ "$WAIT_TIMEOUT" -eq 0 ]; then
echoerror "Apt, apt-get, aptitude, or dpkg process is taking too long."
echoerror "Bootstrap script cannot proceed. Aborting."
return 1
fi
# If our exit code from apt is 100, then we're waiting on a lock
while [ $APT_RETURN -eq 100 ]; do
echoinfo "Aware of the lock. Patiently waiting $WAIT_TIMEOUT more seconds..."
sleep 1
WAIT_TIMEOUT=$((WAIT_TIMEOUT - 1))
# If timeout reaches 0, abort.
if [ "$WAIT_TIMEOUT" -eq 0 ]; then
echoerror "Apt, apt-get, aptitude, or dpkg process is taking too long."
echoerror "Bootstrap script cannot proceed. Aborting."
return 1
else
# Try running apt again until our return code != 100
"${@}"
APT_RETURN=$?
fi
done
echodebug "No apt processes are currently running."
return $APT_RETURN
}
#--- FUNCTION -------------------------------------------------------------------------------------------------------
@ -1823,8 +1838,7 @@ __wait_for_apt(){
# PARAMETERS: packages
#----------------------------------------------------------------------------------------------------------------------
__apt_get_install_noinput() {
__wait_for_apt
apt-get install -y -o DPkg::Options::=--force-confold "${@}"; return $?
__wait_for_apt apt-get install -y -o DPkg::Options::=--force-confold "${@}"; return $?
} # ---------- end of function __apt_get_install_noinput ----------
@ -1833,8 +1847,7 @@ __apt_get_install_noinput() {
# DESCRIPTION: (DRY) apt-get upgrade with noinput options
#----------------------------------------------------------------------------------------------------------------------
__apt_get_upgrade_noinput() {
__wait_for_apt
apt-get upgrade -y -o DPkg::Options::=--force-confold; return $?
__wait_for_apt apt-get upgrade -y -o DPkg::Options::=--force-confold; return $?
} # ---------- end of function __apt_get_upgrade_noinput ----------
@ -1844,11 +1857,10 @@ __apt_get_upgrade_noinput() {
# PARAMETERS: url
#----------------------------------------------------------------------------------------------------------------------
__apt_key_fetch() {
__wait_for_apt
url=$1
# shellcheck disable=SC2086
apt-key adv ${_GPG_ARGS} --fetch-keys "$url"; return $?
__wait_for_apt apt-key adv ${_GPG_ARGS} --fetch-keys "$url"; return $?
} # ---------- end of function __apt_key_fetch ----------
@ -2633,8 +2645,7 @@ __install_saltstack_ubuntu_repository() {
__apt_key_fetch "$SALTSTACK_UBUNTU_URL/SALTSTACK-GPG-KEY.pub" || return 1
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
}
install_ubuntu_deps() {
@ -2646,8 +2657,7 @@ install_ubuntu_deps() {
__enable_universe_repository || return 1
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
fi
__PACKAGES=''
@ -2703,8 +2713,7 @@ install_ubuntu_stable_deps() {
# No user interaction, libc6 restart services for example
export DEBIAN_FRONTEND=noninteractive
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
if [ "${_UPGRADE_SYS}" -eq $BS_TRUE ]; then
if [ "${_INSECURE_DL}" -eq $BS_TRUE ]; then
@ -2724,8 +2733,7 @@ install_ubuntu_stable_deps() {
}
install_ubuntu_git_deps() {
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
if ! __check_command_exists git; then
__apt_get_install_noinput git-core || return 1
@ -3032,8 +3040,7 @@ __install_saltstack_debian_repository() {
__apt_key_fetch "$SALTSTACK_DEBIAN_URL/SALTSTACK-GPG-KEY.pub" || return 1
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
}
install_debian_deps() {
@ -3044,8 +3051,7 @@ install_debian_deps() {
# No user interaction, libc6 restart services for example
export DEBIAN_FRONTEND=noninteractive
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
if [ "${_UPGRADE_SYS}" -eq $BS_TRUE ]; then
# Try to update GPG keys first if allowed
@ -3164,8 +3170,7 @@ install_debian_8_git_deps() {
/etc/apt/sources.list.d/backports.list
fi
__wait_for_apt
apt-get update || return 1
__wait_for_apt apt-get update || return 1
# python-tornado package should be installed from backports repo
__PACKAGES="${__PACKAGES} python-backports.ssl-match-hostname python-tornado/jessie-backports"
@ -3415,36 +3420,33 @@ install_debian_check_services() {
#
install_fedora_deps() {
if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then
dnf -y update || return 1
fi
__PACKAGES="${__PACKAGES:=}"
if [ -n "$_PY_EXE" ] && [ "$_PY_MAJOR_VERSION" -eq 3 ]; then
# Packages are named python3-<whatever>
PY_PKG_VER=3
__PACKAGES="python3-m2crypto python3-PyYAML"
__PACKAGES="${__PACKAGES} python3-m2crypto python3-PyYAML"
else
PY_PKG_VER=2
__PACKAGES="m2crypto"
__PACKAGES="${__PACKAGES} m2crypto"
if [ "$DISTRO_MAJOR_VERSION" -ge 28 ]; then
__PACKAGES="${__PACKAGES} python2-pyyaml"
else
__PACKAGES="${__PACKAGES} PyYAML"
fi
fi
__PACKAGES="${__PACKAGES} procps-ng dnf-utils libyaml python${PY_PKG_VER}-crypto python${PY_PKG_VER}-jinja2"
__PACKAGES="${__PACKAGES} dnf-utils libyaml procps-ng python${PY_PKG_VER}-crypto python${PY_PKG_VER}-jinja2"
__PACKAGES="${__PACKAGES} python${PY_PKG_VER}-msgpack python${PY_PKG_VER}-requests python${PY_PKG_VER}-zmq"
# shellcheck disable=SC2086
dnf install -y ${__PACKAGES} || return 1
if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then
dnf -y update || return 1
fi
if [ "${_EXTRA_PACKAGES}" != "" ]; then
echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}"
# shellcheck disable=SC2086
dnf install -y ${_EXTRA_PACKAGES} || return 1
fi
# shellcheck disable=SC2086
dnf install -y ${__PACKAGES} ${_EXTRA_PACKAGES} || return 1
return 0
}
@ -3494,36 +3496,38 @@ install_fedora_git_deps() {
PY_PKG_VER=2
fi
__PACKAGES="${__PACKAGES:=}"
if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then
dnf install -y ca-certificates || return 1
__PACKAGES="${__PACKAGES} ca-certificates"
fi
if ! __check_command_exists git; then
__PACKAGES="${__PACKAGES} git"
fi
if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then
__PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud python${PY_PKG_VER}-netaddr"
fi
__PACKAGES="${__PACKAGES} python${PY_PKG_VER}-systemd"
# Fedora 28+ ships with tornado 5.0+ which is broken for salt on py3
# https://github.com/saltstack/salt-bootstrap/issues/1220
if [ "${PY_PKG_VER}" -lt 3 ] || [ "$DISTRO_MAJOR_VERSION" -lt 28 ]; then
__PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado"
fi
install_fedora_deps || return 1
if ! __check_command_exists git; then
dnf install -y git || return 1
fi
__git_clone_and_checkout || return 1
__PACKAGES="python${PY_PKG_VER}-systemd"
# Fedora 28+ needs tornado <5.0 from pip
# https://github.com/saltstack/salt-bootstrap/issues/1220
if [ "${PY_PKG_VER}" -eq 3 ] && [ "$DISTRO_MAJOR_VERSION" -ge 28 ]; then
__check_pip_allowed "You need to allow pip based installations (-P) for Tornado <5.0 in order to install Salt on Python 3"
grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" | while IFS='
' read -r dep; do
"${_PY_EXE}" -m pip install "${dep}" || return 1
done
else
__PACKAGES="${__PACKAGES} python${PY_PKG_VER}-tornado"
fi
if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then
__PACKAGES="${__PACKAGES} python${PY_PKG_VER}-libcloud python${PY_PKG_VER}-netaddr"
fi
# shellcheck disable=SC2086
dnf install -y ${__PACKAGES} || return 1
# Let's trigger config_salt()
if [ "$_TEMP_CONFIG_DIR" = "null" ]; then
_TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/"
@ -4681,6 +4685,138 @@ install_amazon_linux_ami_git_deps() {
return 0
}
install_amazon_linux_ami_2_git_deps() {
if [ "$_INSECURE_DL" -eq $BS_FALSE ] && [ "${_SALT_REPO_URL%%://*}" = "https" ]; then
yum -y install ca-certificates || return 1
fi
PIP_EXE='pip'
if __check_command_exists python2.7; then
if ! __check_command_exists pip2.7; then
__yum_install_noinput python2-pip
fi
PIP_EXE='/bin/pip'
_PY_EXE='python2.7'
fi
install_amazon_linux_ami_2_deps || return 1
if ! __check_command_exists git; then
__yum_install_noinput git || return 1
fi
__git_clone_and_checkout || return 1
__PACKAGES=""
__PIP_PACKAGES=""
if [ "$_INSTALL_CLOUD" -eq $BS_TRUE ]; then
__check_pip_allowed "You need to allow pip based installations (-P) in order to install apache-libcloud"
__PACKAGES="${__PACKAGES} python27-pip"
__PIP_PACKAGES="${__PIP_PACKAGES} apache-libcloud>=$_LIBCLOUD_MIN_VERSION"
fi
if [ -f "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt" ]; then
# We're on the develop branch, install whichever tornado is on the requirements file
__REQUIRED_TORNADO="$(grep tornado "${_SALT_GIT_CHECKOUT_DIR}/requirements/base.txt")"
if [ "${__REQUIRED_TORNADO}" != "" ]; then
__PACKAGES="${__PACKAGES} ${pkg_append}-tornado"
fi
fi
if [ "${__PACKAGES}" != "" ]; then
# shellcheck disable=SC2086
__yum_install_noinput ${__PACKAGES} || return 1
fi
if [ "${__PIP_PACKAGES}" != "" ]; then
# shellcheck disable=SC2086
${PIP_EXE} install ${__PIP_PACKAGES} || return 1
fi
# Let's trigger config_salt()
if [ "$_TEMP_CONFIG_DIR" = "null" ]; then
_TEMP_CONFIG_DIR="${_SALT_GIT_CHECKOUT_DIR}/conf/"
CONFIG_SALT_FUNC="config_salt"
fi
return 0
}
install_amazon_linux_ami_2_deps() {
# Shim to figure out if we're using old (rhel) or new (aws) rpms.
_USEAWS=$BS_FALSE
pkg_append="python"
if [ "$ITYPE" = "stable" ]; then
repo_rev="$STABLE_REV"
else
repo_rev="latest"
fi
if echo $repo_rev | grep -E -q '^archive'; then
year=$(echo "$repo_rev" | cut -d '/' -f 2 | cut -c1-4)
else
year=$(echo "$repo_rev" | cut -c1-4)
fi
if echo "$repo_rev" | grep -E -q '^(latest|2016\.11)$' || \
[ "$year" -gt 2016 ]; then
_USEAWS=$BS_TRUE
pkg_append="python"
fi
# We need to install yum-utils before doing anything else when installing on
# Amazon Linux ECS-optimized images. See issue #974.
__yum_install_noinput yum-utils
# Do upgrade early
if [ "$_UPGRADE_SYS" -eq $BS_TRUE ]; then
yum -y update || return 1
fi
if [ $_DISABLE_REPOS -eq $BS_FALSE ] || [ "$_CUSTOM_REPO_URL" != "null" ]; then
__REPO_FILENAME="saltstack-repo.repo"
base_url="$HTTP_VAL://${_REPO_URL}/yum/redhat/7/\$basearch/$repo_rev/"
base_url="$HTTP_VAL://${_REPO_URL}/yum/amazon/2/\$basearch/latest/"
gpg_key="${base_url}SALTSTACK-GPG-KEY.pub
${base_url}base/RPM-GPG-KEY-CentOS-7"
repo_name="SaltStack repo for Amazon Linux 2.0"
# This should prob be refactored to use __install_saltstack_rhel_repository()
# With args passed in to do the right thing. Reformatted to be more like the
# amazon linux yum file.
if [ ! -s "/etc/yum.repos.d/${__REPO_FILENAME}" ]; then
cat <<_eof > "/etc/yum.repos.d/${__REPO_FILENAME}"
[saltstack-repo]
name=$repo_name
failovermethod=priority
priority=10
gpgcheck=1
gpgkey=$gpg_key
baseurl=$base_url
_eof
fi
fi
# Package python-ordereddict-1.1-2.el6.noarch is obsoleted by python26-2.6.9-2.88.amzn1.x86_64
# which is already installed
__PACKAGES="m2crypto ${pkg_append}-crypto ${pkg_append}-jinja2 PyYAML"
__PACKAGES="${__PACKAGES} ${pkg_append}-msgpack ${pkg_append}-requests ${pkg_append}-zmq"
__PACKAGES="${__PACKAGES} ${pkg_append}-futures"
# shellcheck disable=SC2086
__yum_install_noinput ${__PACKAGES} || return 1
if [ "${_EXTRA_PACKAGES}" != "" ]; then
echoinfo "Installing the following extra packages as requested: ${_EXTRA_PACKAGES}"
# shellcheck disable=SC2086
__yum_install_noinput ${_EXTRA_PACKAGES} || return 1
fi
}
install_amazon_linux_ami_stable() {
install_centos_stable || return 1
return 0
@ -4715,6 +4851,41 @@ install_amazon_linux_ami_testing_post() {
install_centos_testing_post || return 1
return 0
}
install_amazon_linux_ami_2_stable() {
install_centos_stable || return 1
return 0
}
install_amazon_linux_ami_2_stable_post() {
install_centos_stable_post || return 1
return 0
}
install_amazon_linux_ami_2_restart_daemons() {
install_centos_restart_daemons || return 1
return 0
}
install_amazon_linux_ami_2_git() {
install_centos_git || return 1
return 0
}
install_amazon_linux_ami_2_git_post() {
install_centos_git_post || return 1
return 0
}
install_amazon_linux_ami_2_testing() {
install_centos_testing || return 1
return 0
}
install_amazon_linux_ami_2_testing_post() {
install_centos_testing_post || return 1
return 0
}
#
# Ended Amazon Linux AMI Install Functions
#
@ -5336,7 +5507,8 @@ install_openbsd_restart_daemons() {
# SmartOS Install Functions
#
install_smartos_deps() {
pkgin -y install zeromq py27-crypto py27-m2crypto py27-msgpack py27-yaml py27-jinja2 py27-zmq py27-requests || return 1
smartos_deps="$(pkgin show-deps salt | grep '^\s' | grep -v '\snot' | xargs) py27-m2crypto"
pkgin -y install "${smartos_deps}" || return 1
# Set _SALT_ETC_DIR to SmartOS default if they didn't specify
_SALT_ETC_DIR=${BS_SALT_ETC_DIR:-/opt/local/etc/salt}

2
salt/config/__init__.py
View File

@ -136,7 +136,7 @@ VALID_OPTS = {
# a master fingerprint with `salt-key -F master`
'master_finger': six.string_types,
# Deprecated in Fluorine. Use 'random_master' instead.
# Deprecated in 2019.2.0. Use 'random_master' instead.
# Do not remove! Keep as an alias for usability.
'master_shuffle': bool,

2
salt/engines/libvirt_events.py
View File

@ -62,7 +62,7 @@ A polkit rule like the following one will allow `salt` user to connect to libvir
:depends: libvirt 1.0.0+ python binding
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
from __future__ import absolute_import, unicode_literals, print_function

2
salt/executors/docker.py
View File

@ -2,7 +2,7 @@
'''
Docker executor module
.. versionadded: Fluorine
.. versionadded: 2019.2.0
Used with the docker proxy minion.
'''

5
salt/grains/core.py
View File

@ -784,7 +784,10 @@ def _virtual(osdata):
grains['virtual'] = 'LXC'
break
elif command == 'virt-what':
output = output.splitlines()[-1]
try:
output = output.splitlines()[-1]
except IndexError:
pass
if output in ('kvm', 'qemu', 'uml', 'xen', 'lxc'):
grains['virtual'] = output
break

2
salt/modules/aptpkg.py
View File

@ -2664,7 +2664,7 @@ def owner(*paths):
def show(*names, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Runs an ``apt-cache show`` on the passed package names, and returns the
results in a nested dictionary. The top level of the return data will be

2
salt/modules/arista_pyeapi.py
View File

@ -3,7 +3,7 @@
Arista pyeapi
=============
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execution module to interface the connection with Arista switches, connecting to
the remote network device using the

36
salt/modules/azurearm_compute.py
View File

@ -2,7 +2,7 @@
'''
Azure (ARM) Compute Execution Module
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:maintainer: <devops@decisionlab.io>
:maturity: new
@ -79,7 +79,7 @@ def __virtual__():
def availability_set_create_or_update(name, resource_group, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update an availability set.
@ -147,7 +147,7 @@ def availability_set_create_or_update(name, resource_group, **kwargs): # pylint
def availability_set_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete an availability set.
@ -180,7 +180,7 @@ def availability_set_delete(name, resource_group, **kwargs):
def availability_set_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get a dictionary representing an availability set's properties.
@ -213,7 +213,7 @@ def availability_set_get(name, resource_group, **kwargs):
def availability_sets_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all availability sets within a resource group.
@ -247,7 +247,7 @@ def availability_sets_list(resource_group, **kwargs):
def availability_sets_list_available_sizes(name, resource_group, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all available virtual machine sizes that can be used to
to create a new virtual machine in an existing availability set.
@ -286,7 +286,7 @@ def availability_sets_list_available_sizes(name, resource_group, **kwargs): # p
def virtual_machine_capture(name, destination_name, resource_group, prefix='capture-', overwrite=False, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Captures the VM by copying virtual hard disks of the VM and outputs
a template that can be used to create similar VMs.
@ -338,7 +338,7 @@ def virtual_machine_capture(name, destination_name, resource_group, prefix='capt
def virtual_machine_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Retrieves information about the model view or the instance view of a
virtual machine.
@ -375,7 +375,7 @@ def virtual_machine_get(name, resource_group, **kwargs):
def virtual_machine_convert_to_managed_disks(name, resource_group, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Converts virtual machine disks from blob-based to managed disks. Virtual
machine must be stop-deallocated before invoking this operation.
@ -411,7 +411,7 @@ def virtual_machine_convert_to_managed_disks(name, resource_group, **kwargs): #
def virtual_machine_deallocate(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Power off a virtual machine and deallocate compute resources.
@ -446,7 +446,7 @@ def virtual_machine_deallocate(name, resource_group, **kwargs):
def virtual_machine_generalize(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Set the state of a virtual machine to 'generalized'.
@ -478,7 +478,7 @@ def virtual_machine_generalize(name, resource_group, **kwargs):
def virtual_machines_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all virtual machines within a resource group.
@ -511,7 +511,7 @@ def virtual_machines_list(resource_group, **kwargs):
def virtual_machines_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all virtual machines within a subscription.
@ -539,7 +539,7 @@ def virtual_machines_list_all(**kwargs):
def virtual_machines_list_available_sizes(name, resource_group, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Lists all available virtual machine sizes to which the specified virtual
machine can be resized.
@ -576,7 +576,7 @@ def virtual_machines_list_available_sizes(name, resource_group, **kwargs): # py
def virtual_machine_power_off(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Power off (stop) a virtual machine.
@ -611,7 +611,7 @@ def virtual_machine_power_off(name, resource_group, **kwargs):
def virtual_machine_restart(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Restart a virtual machine.
@ -646,7 +646,7 @@ def virtual_machine_restart(name, resource_group, **kwargs):
def virtual_machine_start(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Power on (start) a virtual machine.
@ -681,7 +681,7 @@ def virtual_machine_start(name, resource_group, **kwargs):
def virtual_machine_redeploy(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Redeploy a virtual machine.

124
salt/modules/azurearm_network.py
View File

@ -2,7 +2,7 @@
'''
Azure (ARM) Network Execution Module
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:maintainer: <devops@decisionlab.io>
:maturity: new
@ -86,7 +86,7 @@ def __virtual__():
def check_dns_name_availability(name, region, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Check whether a domain name in the current zone is available for use.
@ -118,7 +118,7 @@ def check_dns_name_availability(name, region, **kwargs):
def check_ip_address_availability(ip_address, virtual_network, resource_group,
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Check that a private ip address is available within the specified
virtual network.
@ -154,7 +154,7 @@ def check_ip_address_availability(ip_address, virtual_network, resource_group,
def default_security_rule_get(name, security_group, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a default security rule within a security group.
@ -203,7 +203,7 @@ def default_security_rule_get(name, security_group, resource_group, **kwargs):
def default_security_rules_list(security_group, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List default security rules within a security group.
@ -243,7 +243,7 @@ def default_security_rules_list(security_group, resource_group, **kwargs):
def security_rules_list(security_group, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List security rules within a network security group.
@ -279,7 +279,7 @@ def security_rule_create_or_update(name, access, direction, priority, protocol,
destination_address_prefixes=None, source_port_ranges=None,
destination_port_ranges=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a security rule within a specified network security group.
@ -412,7 +412,7 @@ def security_rule_create_or_update(name, access, direction, priority, protocol,
def security_rule_delete(security_rule, security_group, resource_group,
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a security rule within a specified security group.
@ -449,7 +449,7 @@ def security_rule_delete(security_rule, security_group, resource_group,
def security_rule_get(security_rule, security_group, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get a security rule within a specified network security group.
@ -485,7 +485,7 @@ def security_rule_get(security_rule, security_group, resource_group, **kwargs):
def network_security_group_create_or_update(name, resource_group, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a network security group.
@ -541,7 +541,7 @@ def network_security_group_create_or_update(name, resource_group, **kwargs): #
def network_security_group_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a network security group within a resource group.
@ -574,7 +574,7 @@ def network_security_group_delete(name, resource_group, **kwargs):
def network_security_group_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a network security group within a resource group.
@ -606,7 +606,7 @@ def network_security_group_get(name, resource_group, **kwargs):
def network_security_groups_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all network security groups within a resource group.
@ -639,7 +639,7 @@ def network_security_groups_list(resource_group, **kwargs):
def network_security_groups_list_all(**kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all network security groups within a subscription.
@ -667,7 +667,7 @@ def network_security_groups_list_all(**kwargs): # pylint: disable=invalid-name
def subnets_list(virtual_network, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all subnets within a virtual network.
@ -704,7 +704,7 @@ def subnets_list(virtual_network, resource_group, **kwargs):
def subnet_get(name, virtual_network, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific subnet.
@ -741,7 +741,7 @@ def subnet_get(name, virtual_network, resource_group, **kwargs):
def subnet_create_or_update(name, address_prefix, virtual_network, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a subnet.
@ -818,7 +818,7 @@ def subnet_create_or_update(name, address_prefix, virtual_network, resource_grou
def subnet_delete(name, virtual_network, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a subnet.
@ -855,7 +855,7 @@ def subnet_delete(name, virtual_network, resource_group, **kwargs):
def virtual_networks_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all virtual networks within a subscription.
@ -882,7 +882,7 @@ def virtual_networks_list_all(**kwargs):
def virtual_networks_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all virtual networks within a resource group.
@ -920,7 +920,7 @@ def virtual_network_create_or_update(name,
resource_group,
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a virtual network.
@ -996,7 +996,7 @@ def virtual_network_create_or_update(name,
def virtual_network_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a virtual network.
@ -1029,7 +1029,7 @@ def virtual_network_delete(name, resource_group, **kwargs):
def virtual_network_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific virtual network.
@ -1061,7 +1061,7 @@ def virtual_network_get(name, resource_group, **kwargs):
def load_balancers_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all load balancers within a subscription.
@ -1088,7 +1088,7 @@ def load_balancers_list_all(**kwargs):
def load_balancers_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all load balancers within a resource group.
@ -1122,7 +1122,7 @@ def load_balancers_list(resource_group, **kwargs):
def load_balancer_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific load balancer.
@ -1154,7 +1154,7 @@ def load_balancer_get(name, resource_group, **kwargs):
def load_balancer_create_or_update(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a load balancer within a specified resource group.
@ -1328,7 +1328,7 @@ def load_balancer_create_or_update(name, resource_group, **kwargs):
def load_balancer_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a load balancer.
@ -1361,7 +1361,7 @@ def load_balancer_delete(name, resource_group, **kwargs):
def usages_list(location, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List subscription network usage for a location.
@ -1386,7 +1386,7 @@ def usages_list(location, **kwargs):
def network_interface_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a network interface.
@ -1420,7 +1420,7 @@ def network_interface_delete(name, resource_group, **kwargs):
def network_interface_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific network interface.
@ -1454,7 +1454,7 @@ def network_interface_get(name, resource_group, **kwargs):
def network_interface_create_or_update(name, ip_configurations, subnet, virtual_network,
resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a network interface within a specified resource group.
@ -1575,7 +1575,7 @@ def network_interface_create_or_update(name, ip_configurations, subnet, virtual_
def network_interfaces_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all network interfaces within a subscription.
@ -1602,7 +1602,7 @@ def network_interfaces_list_all(**kwargs):
def network_interfaces_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all network interfaces within a resource group.
@ -1637,7 +1637,7 @@ def network_interfaces_list(resource_group, **kwargs):
# pylint: disable=invalid-name
def network_interface_get_effective_route_table(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get all route tables for a specific network interface.
@ -1673,7 +1673,7 @@ def network_interface_get_effective_route_table(name, resource_group, **kwargs):
# pylint: disable=invalid-name
def network_interface_list_effective_network_security_groups(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get all network security groups applied to a specific network interface.
@ -1712,7 +1712,7 @@ def list_virtual_machine_scale_set_vm_network_interfaces(scale_set,
resource_group,
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get information about all network interfaces in a specific virtual machine within a scale set.
@ -1753,7 +1753,7 @@ def list_virtual_machine_scale_set_vm_network_interfaces(scale_set,
# pylint: disable=invalid-name
def list_virtual_machine_scale_set_network_interfaces(scale_set, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get information about all network interfaces within a scale set.
@ -1791,7 +1791,7 @@ def list_virtual_machine_scale_set_network_interfaces(scale_set, resource_group,
# pylint: disable=invalid-name
def get_virtual_machine_scale_set_network_interface(name, scale_set, vm_index, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get information about a specfic network interface within a scale set.
@ -1833,7 +1833,7 @@ def get_virtual_machine_scale_set_network_interface(name, scale_set, vm_index, r
def public_ip_address_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a public IP address.
@ -1866,7 +1866,7 @@ def public_ip_address_delete(name, resource_group, **kwargs):
def public_ip_address_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific public IP address.
@ -1902,7 +1902,7 @@ def public_ip_address_get(name, resource_group, **kwargs):
def public_ip_address_create_or_update(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a public IP address within a specified resource group.
@ -1958,7 +1958,7 @@ def public_ip_address_create_or_update(name, resource_group, **kwargs):
def public_ip_addresses_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all public IP addresses within a subscription.
@ -1985,7 +1985,7 @@ def public_ip_addresses_list_all(**kwargs):
def public_ip_addresses_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all public IP addresses within a resource group.
@ -2019,7 +2019,7 @@ def public_ip_addresses_list(resource_group, **kwargs):
def route_filter_rule_delete(name, route_filter, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a route filter rule.
@ -2055,7 +2055,7 @@ def route_filter_rule_delete(name, route_filter, resource_group, **kwargs):
def route_filter_rule_get(name, route_filter, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific route filter rule.
@ -2092,7 +2092,7 @@ def route_filter_rule_get(name, route_filter, resource_group, **kwargs):
def route_filter_rule_create_or_update(name, access, communities, route_filter, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a rule within a specified route filter.
@ -2171,7 +2171,7 @@ def route_filter_rule_create_or_update(name, access, communities, route_filter,
def route_filter_rules_list(route_filter, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all routes within a route filter.
@ -2208,7 +2208,7 @@ def route_filter_rules_list(route_filter, resource_group, **kwargs):
def route_filter_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a route filter.
@ -2241,7 +2241,7 @@ def route_filter_delete(name, resource_group, **kwargs):
def route_filter_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific route filter.
@ -2277,7 +2277,7 @@ def route_filter_get(name, resource_group, **kwargs):
def route_filter_create_or_update(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a route filter within a specified resource group.
@ -2333,7 +2333,7 @@ def route_filter_create_or_update(name, resource_group, **kwargs):
def route_filters_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all route filters within a resource group.
@ -2367,7 +2367,7 @@ def route_filters_list(resource_group, **kwargs):
def route_filters_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all route filters within a subscription.
@ -2394,7 +2394,7 @@ def route_filters_list_all(**kwargs):
def route_delete(name, route_table, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a route from a route table.
@ -2430,7 +2430,7 @@ def route_delete(name, route_table, resource_group, **kwargs):
def route_get(name, route_table, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific route.
@ -2468,7 +2468,7 @@ def route_get(name, route_table, resource_group, **kwargs):
def route_create_or_update(name, address_prefix, next_hop_type, route_table, resource_group,
next_hop_ip_address=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a route within a specified route table.
@ -2530,7 +2530,7 @@ def route_create_or_update(name, address_prefix, next_hop_type, route_table, res
def routes_list(route_table, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all routes within a route table.
@ -2567,7 +2567,7 @@ def routes_list(route_table, resource_group, **kwargs):
def route_table_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a route table.
@ -2600,7 +2600,7 @@ def route_table_delete(name, resource_group, **kwargs):
def route_table_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific route table.
@ -2636,7 +2636,7 @@ def route_table_get(name, resource_group, **kwargs):
def route_table_create_or_update(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a route table within a specified resource group.
@ -2692,7 +2692,7 @@ def route_table_create_or_update(name, resource_group, **kwargs):
def route_tables_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all route tables within a resource group.
@ -2726,7 +2726,7 @@ def route_tables_list(resource_group, **kwargs):
def route_tables_list_all(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all route tables within a subscription.

58
salt/modules/azurearm_resource.py
View File

@ -2,7 +2,7 @@
'''
Azure (ARM) Resource Execution Module
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:maintainer: <devops@decisionlab.io>
:maturity: new
@ -80,7 +80,7 @@ def __virtual__():
def resource_groups_list(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all resource groups within a subscription.
@ -107,7 +107,7 @@ def resource_groups_list(**kwargs):
def resource_group_check_existence(name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Check for the existence of a named resource group in the current subscription.
@ -133,7 +133,7 @@ def resource_group_check_existence(name, **kwargs):
def resource_group_get(name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get a dictionary representing a resource group's properties.
@ -161,7 +161,7 @@ def resource_group_get(name, **kwargs):
def resource_group_create_or_update(name, location, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a resource group in a given location.
@ -196,7 +196,7 @@ def resource_group_create_or_update(name, location, **kwargs): # pylint: disabl
def resource_group_delete(name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a resource group from the subscription.
@ -223,7 +223,7 @@ def resource_group_delete(name, **kwargs):
def deployment_operation_get(operation, deployment, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get a deployment operation within a deployment.
@ -259,7 +259,7 @@ def deployment_operation_get(operation, deployment, resource_group, **kwargs):
def deployment_operations_list(name, resource_group, result_limit=10, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all deployment operations within a deployment.
@ -300,7 +300,7 @@ def deployment_operations_list(name, resource_group, result_limit=10, **kwargs):
def deployment_delete(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a deployment.
@ -333,7 +333,7 @@ def deployment_delete(name, resource_group, **kwargs):
def deployment_check_existence(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Check the existence of a deployment.
@ -367,7 +367,7 @@ def deployment_create_or_update(name, resource_group, deploy_mode='incremental',
parameters_link=None, deploy_template=None,
template_link=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Deploys resources to a resource group.
@ -472,7 +472,7 @@ def deployment_create_or_update(name, resource_group, deploy_mode='incremental',
def deployment_get(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific deployment.
@ -504,7 +504,7 @@ def deployment_get(name, resource_group, **kwargs):
def deployment_cancel(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Cancel a deployment if in 'Accepted' or 'Running' state.
@ -542,7 +542,7 @@ def deployment_validate(name, resource_group, deploy_mode=None,
parameters_link=None, deploy_template=None,
template_link=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Validates whether the specified template is syntactically correct
and will be accepted by Azure Resource Manager.
@ -642,7 +642,7 @@ def deployment_validate(name, resource_group, deploy_mode=None,
def deployment_export_template(name, resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Exports the template used for the specified deployment.
@ -674,7 +674,7 @@ def deployment_export_template(name, resource_group, **kwargs):
def deployments_list(resource_group, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all deployments within a resource group.
@ -705,7 +705,7 @@ def deployments_list(resource_group, **kwargs):
def subscriptions_list_locations(subscription_id=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all locations for a subscription.
@ -744,7 +744,7 @@ def subscriptions_list_locations(subscription_id=None, **kwargs):
def subscription_get(subscription_id=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a subscription.
@ -780,7 +780,7 @@ def subscription_get(subscription_id=None, **kwargs):
def subscriptions_list(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all subscriptions for a tenant.
@ -807,7 +807,7 @@ def subscriptions_list(**kwargs):
def tenants_list(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all tenants for your account.
@ -834,7 +834,7 @@ def tenants_list(**kwargs):
def policy_assignment_delete(name, scope, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a policy assignment.
@ -867,7 +867,7 @@ def policy_assignment_delete(name, scope, **kwargs):
def policy_assignment_create(name, scope, definition_name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a policy assignment.
@ -945,7 +945,7 @@ def policy_assignment_create(name, scope, definition_name, **kwargs):
def policy_assignment_get(name, scope, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific policy assignment.
@ -977,7 +977,7 @@ def policy_assignment_get(name, scope, **kwargs):
def policy_assignments_list_for_resource_group(resource_group, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all policy assignments for a resource group.
@ -1011,7 +1011,7 @@ def policy_assignments_list_for_resource_group(resource_group, **kwargs): # pyl
def policy_assignments_list(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all policy assignments for a subscription.
@ -1038,7 +1038,7 @@ def policy_assignments_list(**kwargs):
def policy_definition_create_or_update(name, policy_rule, **kwargs): # pylint: disable=invalid-name
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create or update a policy definition.
@ -1093,7 +1093,7 @@ def policy_definition_create_or_update(name, policy_rule, **kwargs): # pylint:
def policy_definition_delete(name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete a policy definition.
@ -1122,7 +1122,7 @@ def policy_definition_delete(name, **kwargs):
def policy_definition_get(name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get details about a specific policy definition.
@ -1150,7 +1150,7 @@ def policy_definition_get(name, **kwargs):
def policy_definitions_list(hide_builtin=False, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
List all policy definitions for a subscription.

14
salt/modules/cimc.py
View File

@ -261,7 +261,7 @@ def get_hostname():
'''
Retrieves the hostname from the device.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -395,7 +395,7 @@ def get_power_configuration():
Get the configuration of the power settings from the device. This is only available
on some C-Series servers.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -461,7 +461,7 @@ def get_syslog_settings():
'''
Get the Syslog configuration settings from the system.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -633,7 +633,7 @@ def set_hostname(hostname=None):
'''
Sets the hostname on the server.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
hostname(str): The new hostname to set.
@ -668,7 +668,7 @@ def set_logging_levels(remote=None, local=None):
the following options: emergency, alert, critical, error, warning, notice,
informational, debug.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
remote(str): The logging level for SYSLOG logs.
@ -751,7 +751,7 @@ def set_power_configuration(policy=None, delayType=None, delayValue=None):
Sets the power configuration on the device. This is only available for some
C-Series servers.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
policy(str): The action to be taken when chassis power is restored after
@ -861,7 +861,7 @@ def set_user(uid=None, username=None, password=None, priv=None, status=None):
'''
Sets a CIMC user with specified configurations.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
uid(int): The user ID slot to create the user account in.

2
salt/modules/ciscoconfparse_mod.py
View File

@ -2,7 +2,7 @@
'''
Execution module for `ciscoconfparse <http://www.pennington.net/py/ciscoconfparse/index.html>`_
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
This module can be used for basic configuration parsing, audit or validation
for a variety of network platforms having Cisco IOS style configuration (one

46
salt/modules/cmdmod.py
View File

@ -1091,13 +1091,13 @@ def run(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1343,13 +1343,13 @@ def shell(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1568,13 +1568,13 @@ def run_stdout(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1776,13 +1776,13 @@ def run_stderr(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2008,13 +2008,13 @@ def run_all(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2207,13 +2207,13 @@ def retcode(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2456,13 +2456,13 @@ def script(source,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2703,13 +2703,13 @@ def script_retcode(source,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -3025,7 +3025,7 @@ def run_chroot(root,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -3508,13 +3508,13 @@ def powershell(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:returns:
:dict: A dictionary of data returned by the powershell command.
@ -3810,13 +3810,13 @@ def powershell_all(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:return: A dictionary with the following entries:
@ -4079,13 +4079,13 @@ def run_bg(cmd,
return code returned from the run matches any in the provided list,
the return code will be overridden with zero.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param bool stdin_raw_newlines: False
If ``True``, Salt will not automatically convert the characters ``\\n``
present in the ``stdin`` value to newlines.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:

2
salt/modules/disk.py
View File

@ -85,7 +85,7 @@ def usage(args=None):
'''
Return usage information for volumes mounted on this minion
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Default for SunOS changed to 1 kilobyte blocks

8
salt/modules/dockermod.py
View File

@ -2106,7 +2106,7 @@ def port(name, private_port=None):
name
Container name or ID
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
This value can now be a pattern expression (using the
pattern-matching characters defined in fnmatch_). If a pattern
expression is used, this function will return a dictionary mapping
@ -5928,7 +5928,7 @@ def wait(name, ignore_already_stopped=False, fail_on_exit_status=False):
def prune(containers=False, networks=False, images=False,
build=False, volumes=False, system=None, **filters):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Prune Docker's various subsystems
@ -6724,7 +6724,7 @@ def call(name, function, *args, **kwargs):
def apply_(name, mods=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Apply states! This function will call highstate or state.sls based on the
arguments passed in, ``apply`` is intended to be the main gateway for
@ -6864,7 +6864,7 @@ def highstate(name, saltenv='base', **kwargs):
'''
Apply a highstate to the running container
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
The container does not need to have Salt installed, but Python is required.

2
salt/modules/file.py
View File

@ -2526,7 +2526,7 @@ def blockreplace(path,
.. versionadded:: 2016.3.4
.. versionchanged:: 2017.7.5,2018.3.1
New behavior added when value is ``None``.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
The default value of this argument will change to ``None`` to match
the behavior of the :py:func:`file.blockreplace state
<salt.states.file.blockreplace>`

4
salt/modules/git.py
View File

@ -1964,7 +1964,7 @@ def discard_local_changes(cwd,
ignore_retcode=False,
output_encoding=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Runs a ``git checkout -- <path>`` from the directory specified by ``cwd``.
@ -3829,7 +3829,7 @@ def remote_refs(url,
to make this function run faster on repositories with many
branches/tags.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
heads : False
Restrict output to heads. Can be combined with ``tags``.

10
salt/modules/glusterfs.py
View File

@ -244,7 +244,7 @@ def create_volume(name, bricks, stripe=False, replica=False, device_vg=False,
Gluster documentation. Every third brick in the brick list \
is used as an arbiter brick.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
device_vg
If true, specifies volume should use block backend instead of regular \
@ -718,7 +718,7 @@ def list_quota_volume(name):
def get_op_version(name):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Returns the glusterfs volume op-version
@ -753,7 +753,7 @@ def get_op_version(name):
def get_max_op_version():
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Returns the glusterfs volume's max op-version value
Requires Glusterfs version > 3.9
@ -787,7 +787,7 @@ def get_max_op_version():
def set_op_version(version):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Set the glusterfs volume op-version
@ -812,7 +812,7 @@ def set_op_version(version):
def get_version():
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Returns the version of glusterfs.
CLI Example:

2
salt/modules/google_chat.py
View File

@ -2,7 +2,7 @@
'''
Module for sending messages to google chat.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
To use this module you need to configure a webhook in the google chat room
where you would like the message to be sent, see:

2
salt/modules/hadoop.py
View File

@ -90,7 +90,7 @@ def dfs(command=None, *args):
def dfsadmin_report(arg=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Reports basic filesystem information and statistics. Optional flags may be used to filter the list of displayed DataNodes.

2
salt/modules/iosconfig.py
View File

@ -2,7 +2,7 @@
'''
Cisco IOS configuration manipulation helpers
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
This module provides a collection of helper functions for Cisco IOS style
configuration manipulation. This module does not have external dependencies

2
salt/modules/jira_mod.py
View File

@ -3,7 +3,7 @@
JIRA Execution module
=====================
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execution module to manipulate JIRA tickets via Salt.

4
salt/modules/kapacitor.py
View File

@ -16,7 +16,7 @@ Kapacitor execution module.
kapacitor.unsafe_ssl: 'false'
kapacitor.protocol: 'http'
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
This data can also be passed into pillar. Options passed into opts will
overwrite options passed into pillar.
@ -149,7 +149,7 @@ def define_task(name,
to fetch data from. For backward compatibility, the value of
'database' and 'retention_policy' will be merged as part of dbrps.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
database
Which database to fetch data from.

4
salt/modules/kubernetes.py
View File

@ -24,11 +24,11 @@ provided `kubeconfig` entry is preferred.
salt '*' kubernetes.nodes kubeconfig=/etc/salt/k8s/kubeconfig context=minikube
.. versionadded: 2017.7.0
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
.. warning::
Configuration options changed in Fluorine. The following configuration options have been removed:
Configuration options changed in 2019.2.0. The following configuration options have been removed:
- kubernetes.user
- kubernetes.password

2
salt/modules/lxd.py
View File

@ -2,7 +2,7 @@
'''
Module for managing the LXD daemon and its containers.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
`LXD(1)`__ is a container "hypervisor". This execution module provides
several functions to help manage it and its containers.

10
salt/modules/mac_service.py
View File

@ -13,11 +13,11 @@ This module has support for services in the following locations.
/Library/LaunchDaemons/
/Library/LaunchAgents/
# As of version "Fluorine" support for user-specific services were added.
# As of version "2019.2.0" support for user-specific services were added.
/Users/foo/Library/LaunchAgents/
.. note::
As of the Fluorine release, if a service is located in a ``LaunchAgent``
As of the 2019.2.0 release, if a service is located in a ``LaunchAgent``
path and a ``runas`` user is NOT specified, the current console user will
be used to properly interact with the service.
@ -157,7 +157,7 @@ def _always_running_service(name):
:rtype: bool
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
# get all the info from the launchctl service
@ -201,7 +201,7 @@ def _get_domain_target(name, service_target=False):
:rtype: tuple
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
# Get service information
@ -236,7 +236,7 @@ def _launch_agent(name):
:rtype: bool
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
# Get the path to the service.

2
salt/modules/mine.py
View File

@ -369,7 +369,7 @@ def get_docker(interfaces=None, cidrs=None, with_container_id=False):
When :conf_minion:`docker.update_mine` is set to ``False`` for a given
minion, no mine data will be populated for that minion, and thus none
will be returned for it.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
:conf_minion:`docker.update_mine` now defaults to ``False``
Get all mine data for :py:func:`docker.ps <salt.modules.dockermod.ps_>` and

2
salt/modules/mod_random.py
View File

@ -179,7 +179,7 @@ def rand_int(start=1, end=10, seed=None):
seed :
Optional hashable object
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Added seed argument. Will return the same result when run with the same seed.

4
salt/modules/mysql.py
View File

@ -58,7 +58,7 @@ try:
import MySQLdb.cursors
import MySQLdb.converters
from MySQLdb.constants import FIELD_TYPE, FLAG
from MySQLdb.connections import OperationalError
from MySQLdb import OperationalError
except ImportError:
try:
# MySQLdb import failed, try to import PyMySQL
@ -68,7 +68,7 @@ except ImportError:
import MySQLdb.cursors
import MySQLdb.converters
from MySQLdb.constants import FIELD_TYPE, FLAG
from MySQLdb.err import OperationalError
from MySQLdb import OperationalError
except ImportError:
MySQLdb = None

2
salt/modules/napalm_formula.py
View File

@ -3,7 +3,7 @@
NAPALM Formula helpers
======================
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
This is an Execution Module providing helpers for various NAPALM formulas,
e.g., napalm-interfaces-formula, napalm-bgp-formula, napalm-ntp-formula etc.,

78
salt/modules/napalm_mod.py
View File

@ -292,9 +292,9 @@ def compliance_report(filepath=None,
filepath
The absolute path to the validation file.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Beginning with release codename ``Fluorine``, this function has been
Beginning with release codename ``2019.2.0``, this function has been
enhanced, to be able to leverage the multi-engine template rendering
of Salt, besides the possibility to retrieve the file source from
remote systems, the URL schemes supported being:
@ -314,20 +314,20 @@ def compliance_report(filepath=None,
(including pure Python).
string
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
The compliance report send as inline string, to be used as the file to
send through the renderer system. Note, not all renderer modules can
work with strings; the 'py' renderer requires a file, for example.
renderer: ``jinja|yaml``
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
The renderer pipe to send the file through; this is overridden by a
"she-bang" at the top of the file.
kwargs
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Keyword args to pass to Salt's compile_template() function.
@ -420,7 +420,7 @@ def compliance_report(filepath=None,
@proxy_napalm_wrap
def netmiko_args(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the key-value arguments used for the authentication arguments for
the netmiko module.
@ -491,7 +491,7 @@ def netmiko_args(**kwargs):
@proxy_napalm_wrap
def netmiko_fun(fun, *args, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Call an arbitrary function from the :mod:`Netmiko<salt.modules.netmiko_mod>`
module, passing the authentication details from the existing NAPALM
@ -525,7 +525,7 @@ def netmiko_fun(fun, *args, **kwargs):
@proxy_napalm_wrap
def netmiko_call(method, *args, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute an arbitrary Netmiko method, passing the authentication details from
the existing NAPALM connection.
@ -554,7 +554,7 @@ def netmiko_call(method, *args, **kwargs):
@proxy_napalm_wrap
def netmiko_multi_call(*methods, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute a list of arbitrary Netmiko methods, passing the authentication
details from the existing NAPALM connection.
@ -581,7 +581,7 @@ def netmiko_multi_call(*methods, **kwargs):
@proxy_napalm_wrap
def netmiko_commands(*commands, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Invoke one or more commands to be executed on the remote device, via Netmiko.
Returns a list of strings, with the output from each command.
@ -631,7 +631,7 @@ def netmiko_commands(*commands, **kwargs):
@proxy_napalm_wrap
def netmiko_config(*config_commands, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Load a list of configuration commands on the remote device, via Netmiko.
@ -702,7 +702,7 @@ def netmiko_config(*config_commands, **kwargs):
@proxy_napalm_wrap
def netmiko_conn(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the connection object with the network device, over Netmiko, passing
the authentication details from the existing NAPALM connection.
@ -728,7 +728,7 @@ def netmiko_conn(**kwargs):
@proxy_napalm_wrap
def junos_rpc(cmd=None, dest=None, format=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute an RPC request on the remote Junos device.
@ -788,7 +788,7 @@ def junos_rpc(cmd=None, dest=None, format=None, **kwargs):
@proxy_napalm_wrap
def junos_commit(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Commit the changes loaded in the candidate configuration.
@ -837,7 +837,7 @@ def junos_commit(**kwargs):
@proxy_napalm_wrap
def junos_install_os(path=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Installs the given image on the device.
@ -876,7 +876,7 @@ def junos_install_os(path=None, **kwargs):
@proxy_napalm_wrap
def junos_facts(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
The complete list of Junos facts collected by ``junos-eznc``.
@ -905,7 +905,7 @@ def junos_facts(**kwargs):
@proxy_napalm_wrap
def junos_cli(command, format=None, dev_timeout=None, dest=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute a CLI command and return the output in the specified format.
@ -942,7 +942,7 @@ def junos_cli(command, format=None, dev_timeout=None, dest=None, **kwargs):
@proxy_napalm_wrap
def junos_copy_file(src, dst, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Copies the file on the remote Junos device.
@ -969,7 +969,7 @@ def junos_copy_file(src, dst, **kwargs):
@proxy_napalm_wrap
def junos_call(fun, *args, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute an arbitrary function from the
:mod:`junos execution module <salt.module.junos>`. To check what ``args``
@ -1010,7 +1010,7 @@ def junos_call(fun, *args, **kwargs):
def pyeapi_nxos_api_args(**prev_kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the key-value arguments used for the authentication arguments for the
:mod:`pyeapi execution module <salt.module.arista_pyeapi>`.
@ -1064,7 +1064,7 @@ def pyeapi_run_commands(*commands, **kwargs):
@proxy_napalm_wrap
def pyeapi_call(method, *args, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Invoke an arbitrary method from the ``pyeapi`` library.
This function forwards the existing connection details to the
@ -1091,7 +1091,7 @@ def pyeapi_call(method, *args, **kwargs):
@proxy_napalm_wrap
def pyeapi_conn(**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the connection object with the Arista switch, over ``pyeapi``,
passing the authentication details from the existing NAPALM connection.
@ -1122,7 +1122,7 @@ def pyeapi_config(commands=None,
saltenv='base',
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Configures the Arista switch with the specified commands, via the ``pyeapi``
library. This function forwards the existing connection details to the
@ -1184,7 +1184,7 @@ def nxos_api_rpc(commands,
method='cli',
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute an arbitrary RPC request via the Nexus API.
@ -1214,7 +1214,7 @@ def nxos_api_config(commands=None,
saltenv='base',
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Configures the Nexus switch with the specified commands, via the NX-API.
@ -1272,7 +1272,7 @@ def nxos_api_config(commands=None,
@proxy_napalm_wrap
def nxos_api_show(commands, raw_text=True, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execute one or more show (non-configuration) commands.
@ -1298,7 +1298,7 @@ def nxos_api_show(commands, raw_text=True, **kwargs):
@proxy_napalm_wrap
def rpc(command, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
This is a wrapper to execute RPC requests on various network operating
systems supported by NAPALM, invoking the following functions for the NAPALM
@ -1355,7 +1355,7 @@ def rpc(command, **kwargs):
@depends(HAS_CISCOCONFPARSE)
def config_find_lines(regex, source='running'):
r'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the configuration lines that match the regular expressions from the
``regex`` argument. The configuration is read from the network device
@ -1382,7 +1382,7 @@ def config_find_lines(regex, source='running'):
@depends(HAS_CISCOCONFPARSE)
def config_lines_w_child(parent_regex, child_regex, source='running'):
r'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the configuration lines that match the regular expressions from the
``parent_regex`` argument, having child lines matching ``child_regex``.
@ -1421,7 +1421,7 @@ def config_lines_w_child(parent_regex, child_regex, source='running'):
@depends(HAS_CISCOCONFPARSE)
def config_lines_wo_child(parent_regex, child_regex, source='running'):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the configuration lines that match the regular expressions from the
``parent_regex`` argument, having the child lines *not* matching
@ -1461,7 +1461,7 @@ def config_lines_wo_child(parent_regex, child_regex, source='running'):
@depends(HAS_CISCOCONFPARSE)
def config_filter_lines(parent_regex, child_regex, source='running'):
r'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return a list of detailed matches, for the configuration blocks (parent-child
relationship) whose parent respects the regular expressions configured via
@ -1507,7 +1507,7 @@ def config_filter_lines(parent_regex, child_regex, source='running'):
def config_tree(source='running', with_tags=False):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Transform Cisco IOS style configuration to structured Python dictionary.
Depending on the value of the ``with_tags`` argument, this function may
@ -1535,7 +1535,7 @@ def config_merge_tree(source='running',
merge_path=None,
saltenv='base'):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the merge tree of the ``initial_config`` with the ``merge_config``,
as a Python dictionary.
@ -1576,7 +1576,7 @@ def config_merge_text(source='running',
merge_path=None,
saltenv='base'):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the merge result of the configuration from ``source`` with the
merge configuration, as plain text (without loading the config on the
@ -1618,7 +1618,7 @@ def config_merge_diff(source='running',
merge_path=None,
saltenv='base'):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the merge diff, as text, after merging the merge config into the
configuration source requested (without loading the config on the device).
@ -1659,7 +1659,7 @@ def config_diff_tree(source1='candidate',
source2='running',
running_path=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the diff, as Python dictionary, between two different sources.
The sources can be either specified using the ``source1`` and ``source2``
@ -1722,7 +1722,7 @@ def config_diff_text(source1='candidate',
source2='running',
running_path=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return the diff, as text, between the two different configuration sources.
The sources can be either specified using the ``source1`` and ``source2``
@ -1780,7 +1780,7 @@ def scp_get(remote_path,
preserve_times=False,
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Transfer files and directories from remote network device to the localhost
of the Minion.
@ -1863,7 +1863,7 @@ def scp_put(files,
saltenv='base',
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Transfer files and directories to remote network device.

32
salt/modules/napalm_network.py
View File

@ -1378,7 +1378,7 @@ def load_config(filename=None,
applies a manual configuration change, or a different process or
command changes the configuration in the meanwhile).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
commit_at: ``None``
Commit the changes at a specific time. Example of accepted formats:
@ -1402,7 +1402,7 @@ def load_config(filename=None,
applies a manual configuration change, or a different process or
command changes the configuration in the meanwhile).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
revert_in: ``None``
Commit and revert the changes in a specific number of minutes / hours.
@ -1433,7 +1433,7 @@ def load_config(filename=None,
commit and till the changes are reverted), these changes would be
equally reverted, as Salt cannot be aware of them.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
revert_at: ``None``
Commit and revert the changes at a specific time. Example of accepted
@ -1463,7 +1463,7 @@ def load_config(filename=None,
commit and till the changes are reverted), these changes would be
equally reverted, as Salt cannot be aware of them.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
saltenv: ``base``
Specifies the Salt environment name.
@ -1616,7 +1616,7 @@ def load_template(template_name=None,
- ``https:/example.com/template.mako``
- ``ftp://example.com/template.py``
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
This argument can now support a list of templates to be rendered.
The resulting configuration text is loaded at once, as a single
configuration chunk.
@ -1632,7 +1632,7 @@ def load_template(template_name=None,
context: None
Overrides default context variables passed to the template.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
template_hash_name: None
When ``template_hash`` refers to a remote file,
@ -1707,7 +1707,7 @@ def load_template(template_name=None,
applies a manual configuration change, or a different process or
command changes the configuration in the meanwhile).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
commit_at: ``None``
Commit the changes at a specific time. Example of accepted formats:
@ -1731,7 +1731,7 @@ def load_template(template_name=None,
applies a manual configuration change, or a different process or
command changes the configuration in the meanwhile).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
revert_in: ``None``
Commit and revert the changes in a specific number of minutes / hours.
@ -1762,7 +1762,7 @@ def load_template(template_name=None,
commit and till the changes are reverted), these changes would be
equally reverted, as Salt cannot be aware of them.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
revert_at: ``None``
Commit and revert the changes at a specific time. Example of accepted
@ -1792,7 +1792,7 @@ def load_template(template_name=None,
commit and till the changes are reverted), these changes would be
equally reverted, as Salt cannot be aware of them.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
defaults: None
Default variables/context passed to the template.
@ -2237,7 +2237,7 @@ def config_control(inherit_napalm_device=None, **kwargs): # pylint: disable=unu
def cancel_commit(jid):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Cancel a commit scheduled to be executed via the ``commit_in`` and
``commit_at`` arguments from the
@ -2264,7 +2264,7 @@ def cancel_commit(jid):
def confirm_commit(jid):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Confirm a commit scheduled to be reverted via the ``revert_in`` and
``revert_at`` arguments from the
@ -2294,7 +2294,7 @@ def confirm_commit(jid):
def save_config(source=None,
path=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Save the configuration to a file on the local file system.
@ -2348,7 +2348,7 @@ def replace_pattern(pattern,
debug=False,
commit=True):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Replace occurrences of a pattern in the configuration source. If
``show_changes`` is ``True``, then a diff of what changed will be returned,
@ -2487,7 +2487,7 @@ def blockreplace(marker_start,
debug=False,
replace=True):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Replace content of the configuration source, delimited by the line markers.
@ -2594,7 +2594,7 @@ def patch(patchfile,
debug=False,
replace=True):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Apply a patch to the configuration source, and load the result into the
running config of the device.

52
salt/modules/netbox.py
View File

@ -196,7 +196,7 @@ def get_(app, endpoint, id=None, **kwargs):
def create_manufacturer(name):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a device manufacturer.
@ -223,7 +223,7 @@ def create_manufacturer(name):
def create_device_type(model, manufacturer):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a device type. If the manufacturer doesn't exist, create a new manufacturer.
@ -258,7 +258,7 @@ def create_device_type(model, manufacturer):
def create_device_role(role, color):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a device role
@ -285,7 +285,7 @@ def create_device_role(role, color):
def create_platform(platform):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a new device platform
@ -312,7 +312,7 @@ def create_platform(platform):
def create_site(site):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a new device site
@ -343,7 +343,7 @@ def create_device(name,
manufacturer,
site):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a new device with a name, role, model, manufacturer and site.
All these components need to be already in Netbox.
@ -393,7 +393,7 @@ def create_device(name,
def update_device(name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Add attributes to an existing device, identified by name.
@ -427,7 +427,7 @@ def create_inventory_item(device_name,
part_id='',
description=''):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Add an inventory item to an existing device.
@ -475,7 +475,7 @@ def create_inventory_item(device_name,
def delete_inventory_item(item_id):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Remove an item from a devices inventory. Identified by the netbox id
@ -495,7 +495,7 @@ def delete_inventory_item(item_id):
def create_interface_connection(interface_a, interface_b):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create an interface connection between 2 interfaces
@ -521,7 +521,7 @@ def create_interface_connection(interface_a, interface_b):
def get_interfaces(device_name=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Returns interfaces for a specific device using arbitrary netbox filters
@ -548,7 +548,7 @@ def get_interfaces(device_name=None, **kwargs):
def openconfig_interfaces(device_name=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return a dictionary structured as standardised in the
`openconfig-interfaces <http://ops.openconfig.net/branches/master/openconfig-interfaces.html>`_
@ -643,7 +643,7 @@ def openconfig_interfaces(device_name=None):
def openconfig_lacp(device_name=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Return a dictionary structured as standardised in the
`openconfig-lacp <http://ops.openconfig.net/branches/master/openconfig-lacp.html>`_
@ -706,7 +706,7 @@ def create_interface(device_name,
lag_parent=None,
form_factor=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Attach an interface to a device. If not all arguments are provided,
they will default to Netbox defaults.
@ -768,7 +768,7 @@ def create_interface(device_name,
def update_interface(device_name, interface_name, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Update an existing interface with new attributes.
@ -804,7 +804,7 @@ def update_interface(device_name, interface_name, **kwargs):
def delete_interface(device_name, interface_name):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete an interface from a device.
@ -830,7 +830,7 @@ def delete_interface(device_name, interface_name):
def make_interface_lag(device_name, interface_name):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Update an interface to be a LAG.
@ -851,7 +851,7 @@ def make_interface_lag(device_name, interface_name):
def make_interface_child(device_name, interface_name, parent_name):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Set an interface as part of a LAG.
@ -880,7 +880,7 @@ def make_interface_child(device_name, interface_name, parent_name):
def get_ipaddresses(device_name=None, **kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Filters for an IP address using specified filters
@ -906,7 +906,7 @@ def get_ipaddresses(device_name=None, **kwargs):
def create_ipaddress(ip_address, family, device=None, interface=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Add an IP address, and optionally attach it to an interface.
@ -949,7 +949,7 @@ def create_ipaddress(ip_address, family, device=None, interface=None):
def delete_ipaddress(ipaddr_id):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Delete an IP address. IP addresses in Netbox are a combination of address
and the interface it is assigned to.
@ -973,7 +973,7 @@ def delete_ipaddress(ipaddr_id):
def create_circuit_provider(name, asn=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a new Netbox circuit provider
@ -1015,7 +1015,7 @@ def create_circuit_provider(name, asn=None):
def get_circuit_provider(name, asn=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get a circuit provider with a given name and optional ASN.
@ -1039,7 +1039,7 @@ def get_circuit_provider(name, asn=None):
def create_circuit_type(name):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a new Netbox circuit type.
@ -1069,7 +1069,7 @@ def create_circuit_type(name):
def create_circuit(name, provider_id, circuit_type, description=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Create a new Netbox circuit
@ -1115,7 +1115,7 @@ def create_circuit(name, provider_id, circuit_type, description=None):
def create_circuit_termination(circuit, interface, device, speed, xconnect_id=None, term_side='A'):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Terminate a circuit on an interface

2
salt/modules/netmiko_mod.py
View File

@ -3,7 +3,7 @@
Netmiko Execution Module
========================
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execution module to interface the connection with a remote network device. It is
flexible enough to execute the commands both when running under a Netmiko Proxy

2
salt/modules/nxos_api.py
View File

@ -2,7 +2,7 @@
'''
Execution module to manage Cisco Nexus Switches (NX-OS) over the NX-API
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execution module used to interface the interaction with a remote or local Nexus
switch whether we're running in a Proxy Minion or regular Minion (or regular

4
salt/modules/openbsdpkg.py
View File

@ -348,7 +348,7 @@ def upgrade_available(name):
'''
Check whether or not an upgrade is available for a given package
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -369,7 +369,7 @@ def upgrade(name=None,
Returns a dictionary containing the changes:
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. code-block:: python

4
salt/modules/opkg.py
View File

@ -512,12 +512,12 @@ def remove(name=None, pkgs=None, **kwargs): # pylint: disable=unused-argument
remove_dependencies
Remove package and all dependencies
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
auto_remove_deps
Remove packages that were installed automatically to satisfy dependencies
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Returns a dict containing the changes.

2
salt/modules/peeringdb.py
View File

@ -3,7 +3,7 @@
PeeringDB Module
================
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Execution module for the basic interaction with the
`PeeringDB <https://www.peeringdb.com/>`_ API.

2
salt/modules/pf.py
View File

@ -4,7 +4,7 @@ Control the OpenBSD packet filter (PF).
:codeauthor: Jasper Lievisse Adriaanse <j@jasper.la>
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
from __future__ import absolute_import, print_function, unicode_literals

4
salt/modules/pip.py
View File

@ -1457,11 +1457,11 @@ def list_all_versions(pkg,
index_url
Base URL of Python Package Index
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
extra_index_url
Additional URL of Python Package Index
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:

4
salt/modules/postgres.py
View File

@ -3127,14 +3127,14 @@ def datadir_init(name,
The transaction log (WAL) directory (default is to keep WAL
inside the data directory)
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
checksums
If True, the cluster will be created with data page checksums.
.. note:: Data page checksums are supported since PostgreSQL 9.3.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
runas
The system user the operation should be performed on behalf of

18
salt/modules/purefb.py
View File

@ -47,7 +47,7 @@ Installation Prerequisites
:requires: purestorage
:platform: all
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
@ -170,7 +170,7 @@ def snap_create(name, suffix=None):
Will return False if filesystem selected to snap does not exist.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem to snapshot
@ -211,7 +211,7 @@ def snap_delete(name, suffix=None, eradicate=False):
Will return False if selected snapshot does not exist.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem
@ -255,7 +255,7 @@ def snap_eradicate(name, suffix=None):
Will return False if snapshot is not in a deleted state.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem
@ -288,7 +288,7 @@ def fs_create(name, size=None, proto='NFS', nfs_rules='*(rw,no_root_squash)', sn
Will return False if filesystem already exists.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem (truncated to 63 characters)
@ -360,7 +360,7 @@ def fs_delete(name, eradicate=False):
Will return False if filesystem doesn't exist or is already in a deleted state.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem
@ -404,7 +404,7 @@ def fs_eradicate(name):
Will return False is filesystem is not in a deleted state.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem
@ -434,7 +434,7 @@ def fs_extend(name, size):
Will return False if new size is less than or equal to existing size.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem
@ -475,7 +475,7 @@ def fs_update(name, rules, snapshot=False):
Allows for change of NFS export rules and enabling/disabled
of snapshotting capability.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
name : string
name of filesystem

4
salt/modules/saltutil.py
View File

@ -549,7 +549,7 @@ def sync_proxymodules(saltenv=None, refresh=False, extmod_whitelist=None, extmod
def sync_matchers(saltenv=None, refresh=False, extmod_whitelist=None, extmod_blacklist=None):
'''
.. versionadded:: Flourine
.. versionadded:: 2019.2.0
Sync engine modules from ``salt://_matchers`` to the minion
@ -777,7 +777,7 @@ def sync_utils(saltenv=None, refresh=True, extmod_whitelist=None, extmod_blackli
def sync_serializers(saltenv=None, refresh=True, extmod_whitelist=None, extmod_blacklist=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Sync serializers from ``salt://_serializers`` to the minion

2
salt/modules/scp_mod.py
View File

@ -3,7 +3,7 @@
SCP Module
==========
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Module to copy files via `SCP <https://man.openbsd.org/scp>`_
'''

18
salt/modules/selinux.py
View File

@ -390,7 +390,7 @@ def _validate_filetype(filetype):
def _parse_protocol_port(name, protocol, port):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Validates and parses the protocol and port/port range from the name
if both protocol and port are not provided.
@ -505,7 +505,7 @@ def fcontext_get_policy(name, filetype=None, sel_type=None, sel_user=None, sel_l
def fcontext_add_policy(name, filetype=None, sel_type=None, sel_user=None, sel_level=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Adds the SELinux policy for a given filespec and other optional parameters.
@ -544,7 +544,7 @@ def fcontext_add_policy(name, filetype=None, sel_type=None, sel_user=None, sel_l
def fcontext_delete_policy(name, filetype=None, sel_type=None, sel_user=None, sel_level=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Deletes the SELinux policy for a given filespec and other optional parameters.
@ -598,7 +598,7 @@ def fcontext_add_or_delete_policy(action, name, filetype=None, sel_type=None, se
Use :mod:`selinux.fcontext_add_policy()<salt.modules.selinux.fcontext_add_policy>`,
or :mod:`selinux.fcontext_delete_policy()<salt.modules.selinux.fcontext_delete_policy>`.
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
action
The action to perform. Either ``add`` or ``delete``.
@ -639,7 +639,7 @@ def fcontext_add_or_delete_policy(action, name, filetype=None, sel_type=None, se
def _fcontext_add_or_delete_policy(action, name, filetype=None, sel_type=None, sel_user=None, sel_level=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Performs the action as called from ``fcontext_add_policy`` or ``fcontext_delete_policy``.
@ -736,7 +736,7 @@ def fcontext_apply_policy(name, recursive=False):
def port_get_policy(name, sel_type=None, protocol=None, port=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Returns the current entry in the SELinux policy list as a
dictionary. Returns None if no exact match was found.
@ -788,7 +788,7 @@ def port_get_policy(name, sel_type=None, protocol=None, port=None):
def port_add_policy(name, sel_type=None, protocol=None, port=None, sel_range=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Adds the SELinux policy for a given protocol and port.
@ -821,7 +821,7 @@ def port_add_policy(name, sel_type=None, protocol=None, port=None, sel_range=Non
def port_delete_policy(name, protocol=None, port=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Deletes the SELinux policy for a given protocol and port.
@ -848,7 +848,7 @@ def port_delete_policy(name, protocol=None, port=None):
def _port_add_or_delete_policy(action, name, sel_type=None, protocol=None, port=None, sel_range=None):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Performs the action as called from ``port_add_policy`` or ``port_delete_policy``.

2
salt/modules/slsutil.py
View File

@ -56,7 +56,7 @@ def merge(obj_a, obj_b, strategy='smart', renderer='yaml', merge_lists=False):
def merge_all(lst, strategy='smart', renderer='yaml', merge_lists=False):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Merge a list of objects into each other in order

10
salt/modules/smartos_imgadm.py
View File

@ -157,7 +157,7 @@ def docker_to_uuid(uuid):
'''
Get the image uuid from an imported docker image
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
if _is_uuid(uuid):
return uuid
@ -232,7 +232,7 @@ def list_installed(verbose=False):
verbose : boolean (False)
toggle verbose output
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Docker images are now also listed
@ -422,7 +422,7 @@ def sources(verbose=False):
verbose : boolean (False)
toggle verbose output
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -455,7 +455,7 @@ def source_delete(source):
source : string
source url to delete
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -483,7 +483,7 @@ def source_add(source, source_type='imgapi'):
source_trype : string (imgapi)
source type, either imgapi or docker
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:

2
salt/modules/solarisips.py
View File

@ -338,7 +338,7 @@ def latest_version(*names, **kwargs):
Please use pkg.latest_version as pkg.available_version is being deprecated.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Support for multiple package names added.
CLI Example:

12
salt/modules/state.py
View File

@ -772,7 +772,7 @@ def apply_(mods=None, **kwargs):
:ref:`highstate <running-highstate>` automatically syncs all custom
module types.
.. versionadded:: 2017.7.8,2018.3.3,Fluorine
.. versionadded:: 2017.7.8,2018.3.3,2019.2.0
'''
if mods:
return sls(mods, **kwargs)
@ -1199,7 +1199,7 @@ def sls(mods, test=None, exclude=None, queue=False, sync_mods=None, **kwargs):
salt '*' state.sls stuff sync_mods=states,modules
salt '*' state.sls stuff sync_mods=all
.. versionadded:: 2017.7.8,2018.3.3,Fluorine
.. versionadded:: 2017.7.8,2018.3.3,2019.2.0
CLI Example:
@ -1603,7 +1603,7 @@ def show_states(queue=False, **kwargs):
salt '*' state.show_states
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
conflict = _check_queue(queue, kwargs)
@ -1945,7 +1945,7 @@ def sls_exists(mods, test=None, queue=False, **kwargs):
rather than returning state details, returns True or False. The default
environment is ``base``, use ``saltenv`` to specify a different environment.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
saltenv
Specify a salt fileserver environment from which to look for the SLS files
@ -1970,7 +1970,7 @@ def id_exists(ids, mods, test=None, queue=False, **kwargs):
<salt.modules.state.sls_exists>`, returns True or False. The default
environment is base``, use ``saltenv`` to specify a different environment.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
saltenv
Specify a salt fileserver environment from which to look for the SLS files
@ -2362,7 +2362,7 @@ def event(tagmatch='*',
Watch Salt's event bus and block until the given tag is matched
.. versionadded:: 2016.3.0
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
``tagmatch`` can now be either a glob or regular expression.
This is useful for utilizing Salt's event bus from shell scripts or for

2
salt/modules/tls.py
View File

@ -585,7 +585,7 @@ def _get_expiration_date(cert):
def get_expiration_date(cert, date_format='%Y-%m-%d'):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Get a certificate's expiration date

326
salt/modules/virt.py
View File

@ -45,7 +45,7 @@ the remote libvirt machine.
Per call connection setup
-------------------------
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
All the calls requiring the libvirt connection configuration as mentioned above can
override this configuration using ``connection``, ``username`` and ``password`` parameters.
@ -1162,7 +1162,7 @@ def init(name,
These data are merged with the ones from the nic profile. The structure of
each dictionary is documented in :ref:`init-nic-def`.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param hypervisor: the virtual machine type. By default the value will be computed according
to the virtual host capabilities.
:param start: ``True`` to start the virtual machine after having defined it (Default: ``True``)
@ -1171,7 +1171,7 @@ def init(name,
These data are merged with the ones from the disk profile. The structure of
each dictionary is documented in :ref:`init-disk-def`.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param saltenv: Fileserver environment (Default: ``'base'``).
See :mod:`cp module for more details <salt.modules.cp>`
:param seed: ``True`` to seed the disk image. Only used when the ``image`` parameter is provided.
@ -1190,22 +1190,22 @@ def init(name,
graphics={'type': 'vnc'}
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
:param graphics:
Dictionary providing details on the graphics device to create. (Default: ``None``)
See :ref:`init-graphics-def` for more details on the possible values.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param os_type:
type of virtualization as found in the ``//os/type`` element of the libvirt definition.
The default value is taken from the host capabilities, with a preference for ``hvm``.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param arch:
architecture of the virtual machine. The default value is taken from the host capabilities,
but ``x86_64`` is prefed over ``i686``.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param enable_qcow:
``True`` to create a QCOW2 overlay image, rather than copying the image
(Default: ``False``).
@ -1221,7 +1221,7 @@ def init(name,
'overlay_image': True
}
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
:param pool:
Path of the folder where the image files are located for vmware/esx hypervisors.
@ -1250,7 +1250,7 @@ def init(name,
'mac': 'MY:MA:CC:ADD:RE:SS'
}
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
:param config: minion configuration to use when seeding.
See :mod:`seed module for more details <salt.modules.seed>`
:param boot_dev: String of space-separated devices to boot from (Default: ``'hd'``)
@ -1259,13 +1259,13 @@ def init(name,
:param console: ``True`` to add a console device along with serial one (Default: ``True``)
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. _init-nic-def:
@ -1745,7 +1745,7 @@ def update(name,
'errors': ['error messages for failures']
}
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1878,13 +1878,13 @@ def list_domains(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1906,13 +1906,13 @@ def list_active_vms(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1934,13 +1934,13 @@ def list_inactive_vms(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1964,13 +1964,13 @@ def vm_info(vm_=None, **kwargs):
:param vm_: name of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. code-block:: python
@ -2032,13 +2032,13 @@ def vm_state(vm_=None, **kwargs):
:param vm_: name of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2087,13 +2087,13 @@ def node_info(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2114,13 +2114,13 @@ def get_nics(vm_, **kwargs):
:param vm_: name of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2141,13 +2141,13 @@ def get_macs(vm_, **kwargs):
:param vm_: name of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2166,13 +2166,13 @@ def get_graphics(vm_, **kwargs):
:param vm_: name of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2193,13 +2193,13 @@ def get_disks(vm_, **kwargs):
:param vm_: name of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2223,13 +2223,13 @@ def setmem(vm_, memory, config=False, **kwargs):
:param config: if True then libvirt will be asked to modify the config as well
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2272,13 +2272,13 @@ def setvcpus(vm_, vcpus, config=False, **kwargs):
:param config: if True then libvirt will be asked to modify the config as well
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2326,13 +2326,13 @@ def freemem(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2364,13 +2364,13 @@ def freecpu(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2390,13 +2390,13 @@ def full_info(**kwargs):
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2420,13 +2420,13 @@ def get_xml(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2452,13 +2452,13 @@ def get_profiles(hypervisor=None, **kwargs):
:param hypervisor: override the default machine type.
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2505,13 +2505,13 @@ def shutdown(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2533,13 +2533,13 @@ def pause(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2561,13 +2561,13 @@ def resume(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2589,13 +2589,13 @@ def start(name, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2616,13 +2616,13 @@ def stop(name, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2643,13 +2643,13 @@ def reboot(name, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2670,13 +2670,13 @@ def reset(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2702,13 +2702,13 @@ def ctrl_alt_del(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2730,13 +2730,13 @@ def create_xml_str(xml, **kwargs): # pylint: disable=redefined-outer-name
:param xml: libvirt XML definition of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2757,13 +2757,13 @@ def create_xml_path(path, **kwargs):
:param path: path to a file containing the libvirt XML definition of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2788,13 +2788,13 @@ def define_xml_str(xml, **kwargs): # pylint: disable=redefined-outer-name
:param xml: libvirt XML definition of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2815,13 +2815,13 @@ def define_xml_path(path, **kwargs):
:param path: path to a file containing the libvirt XML definition of the domain
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2847,13 +2847,13 @@ def define_vol_xml_str(xml, **kwargs): # pylint: disable=redefined-outer-name
:param xml: libvirt XML definition of the storage volume
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -2894,13 +2894,13 @@ def define_vol_xml_path(path, **kwargs):
:param path: path to a file containing the libvirt XML definition of the volume
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -3071,13 +3071,13 @@ def set_autostart(vm_, state='on', **kwargs):
pool not to be started when the host boots
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -3109,13 +3109,13 @@ def undefine(vm_, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -3148,16 +3148,16 @@ def purge(vm_, dirs=False, removables=None, **kwargs):
:param dirs: pass True to remove containing directories
:param removables: pass True to remove removable devices
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -3233,7 +3233,7 @@ def is_kvm_hyper():
salt '*' virt.is_kvm_hyper
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
'''
salt.utils.versions.warn_until(
'Sodium',
@ -3273,7 +3273,7 @@ def is_xen_hyper():
salt '*' virt.is_xen_hyper
.. deprecated:: Fluorine
.. deprecated:: 2019.2.0
'''
salt.utils.versions.warn_until(
'Sodium',
@ -3298,7 +3298,7 @@ def get_hypervisor():
salt '*' virt.get_hypervisor
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
the function and the ``kvm`` and ``xen`` hypervisors support
'''
# To add a new 'foo' hypervisor, add the _is_foo_hyper function,
@ -3331,13 +3331,13 @@ def vm_cputime(vm_=None, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. code-block:: python
@ -3394,13 +3394,13 @@ def vm_netstats(vm_=None, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. code-block:: python
@ -3475,13 +3475,13 @@ def vm_diskstats(vm_=None, **kwargs):
:param vm_: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. code-block:: python
@ -3576,13 +3576,13 @@ def list_snapshots(domain=None, **kwargs):
:param domain: domain name
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. versionadded:: 2016.3.0
@ -3614,13 +3614,13 @@ def snapshot(domain, name=None, suffix=None, **kwargs):
can be distinguished from manually created.
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. versionadded:: 2016.3.0
@ -3660,13 +3660,13 @@ def delete_snapshots(name, *names, **kwargs):
:param names: names of the snapshots to remove
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. versionadded:: 2016.3.0
@ -3701,13 +3701,13 @@ def revert_snapshot(name, vm_snapshot=None, cleanup=False, **kwargs):
:param cleanup: Remove all newer than reverted snapshots. Values: True or False (default False).
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. versionadded:: 2016.3.0
@ -3992,7 +3992,7 @@ def capabilities(**kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4098,7 +4098,7 @@ def domain_capabilities(emulator=None, arch=None, machine=None, domain=None, **k
'''
Return the domain capabilities given an emulator, architecture, machine or virtualization type.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param emulator: return the capabilities for the given emulator binary
:param arch: return the capabilities for the given CPU architecture
@ -4175,13 +4175,13 @@ def cpu_baseline(full=False, migratable=False, out='libvirt', **kwargs):
:param out: 'libvirt' (default) for usable libvirt XML definition, 'salt' for nice dict
:param connection: libvirt connection URI, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param username: username to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4269,7 +4269,7 @@ def network_define(name, bridge, forward, **kwargs):
salt '*' virt.network_define network main bridge openvswitch
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
conn = __get_conn(**kwargs)
vport = kwargs.get('vport', None)
@ -4322,7 +4322,7 @@ def list_networks(**kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4348,7 +4348,7 @@ def network_info(name=None, **kwargs):
If no name is provided, return the infos for all defined virtual networks.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4398,7 +4398,7 @@ def network_start(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4423,7 +4423,7 @@ def network_stop(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4448,7 +4448,7 @@ def network_undefine(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4476,7 +4476,7 @@ def network_set_autostart(name, state='on', **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4623,7 +4623,7 @@ def pool_define(name,
salt '*' virt.pool_define myshare netfs source_format=cifs \
source_dir=samba_share source_hosts="['example.com']" target=/mnt/cifs
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
'''
conn = __get_conn(**kwargs)
pool_xml = _gen_pool_xml(
@ -4663,7 +4663,7 @@ def list_pools(**kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4689,7 +4689,7 @@ def pool_info(name=None, **kwargs):
If no name is provided, return the infos for all defined storage pools.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4742,7 +4742,7 @@ def pool_start(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4767,7 +4767,7 @@ def pool_build(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4792,7 +4792,7 @@ def pool_stop(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4817,7 +4817,7 @@ def pool_undefine(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4844,7 +4844,7 @@ def pool_delete(name, fast=True, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4872,7 +4872,7 @@ def pool_refresh(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4900,7 +4900,7 @@ def pool_set_autostart(name, state='on', **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -4925,7 +4925,7 @@ def pool_list_volumes(name, **kwargs):
:param username: username to connect with, overriding defaults
:param password: password to connect with, overriding defaults
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:

2
salt/modules/vmctl.py
View File

@ -2,7 +2,7 @@
'''
Manage vms running on the OpenBSD VMM hypervisor using vmctl(8).
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:codeauthor: ``Jasper Lievisse Adriaanse <jasper@openbsd.org>``

14
salt/modules/win_firewall.py
View File

@ -351,7 +351,7 @@ def get_settings(profile, section, store='local'):
as returned by ``netsh advfirewall``.
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
@ -409,7 +409,7 @@ def get_all_settings(domain, store='local'):
Gets all the properties for the specified profile in the specified store
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
@ -452,7 +452,7 @@ def get_all_profiles(store='local'):
Gets all properties for all profiles in the specified store
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
@ -489,7 +489,7 @@ def set_firewall_settings(profile, inbound=None, outbound=None, store='local'):
store
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
@ -564,7 +564,7 @@ def set_logging_settings(profile, setting, value, store='local'):
Configure logging settings for the Windows firewall.
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
@ -658,7 +658,7 @@ def set_settings(profile, setting, value, store='local'):
Configure firewall settings.
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:
@ -725,7 +725,7 @@ def set_state(profile, state, store='local'):
Configure the firewall state.
.. versionadded:: 2018.3.4
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Args:

8
salt/modules/win_network.py
View File

@ -363,13 +363,13 @@ def ip_addrs(interface=None, include_loopback=False, cidr=None, type=None):
Describes subnet using CIDR notation and only IPv4 addresses that belong
to this subnet will be returned.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
type
If option set to 'public' then only public addresses will be returned.
Ditto for 'private'.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
CLI Example:
@ -409,7 +409,7 @@ def ip_addrs6(interface=None, include_loopback=False, cidr=None):
Describes subnet using CIDR notation and only IPv6 addresses that belong
to this subnet will be returned.
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
CLI Example:
@ -525,7 +525,7 @@ def is_private(ip_addr):
'''
Check if the given IP address is a private address
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:

16
salt/modules/yumpkg.py
View File

@ -812,7 +812,7 @@ def list_repo_pkgs(*args, **kwargs):
be expanded and ``--setopt`` prepended to each in the yum/dnf command
that is run.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Examples:
@ -1084,7 +1084,7 @@ def refresh_db(**kwargs):
be expanded and ``--setopt`` prepended to each in the yum/dnf command
that is run.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
CLI Example:
@ -1249,7 +1249,7 @@ def install(name=None,
salt '*' pkg.install foo setopt='obsoletes=0,plugins=0'
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Repository Options:
@ -1745,7 +1745,7 @@ def upgrade(name=None,
.. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html
.. _`systemd.kill(5)`: https://www.freedesktop.org/software/systemd/man/systemd.kill.html
.. versionchanged:: Fluorine
.. versionchanged:: 2019.2.0
Added ``obsoletes`` and ``minimal`` arguments
Returns a dictionary containing the changes:
@ -1838,7 +1838,7 @@ def upgrade(name=None,
salt '*' pkg.upgrade minimal=True
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
obsoletes : True
Controls wether yum/dnf should take obsoletes into account and remove them.
@ -1849,14 +1849,14 @@ def upgrade(name=None,
salt '*' pkg.upgrade obsoletes=False
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
setopt
A comma-separated or Python list of key=value options. This list will
be expanded and ``--setopt`` prepended to each in the yum/dnf command
that is run.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
.. note::
To add extra arguments to the ``yum upgrade`` command, pass them as key
@ -1929,7 +1929,7 @@ def update(name=None,
obsoletes=False,
**kwargs):
'''
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Calls :py:func:`pkg.upgrade <salt.modules.yumpkg.upgrade>` with
``obsoletes=False``. Mirrors the CLI behavior of ``yum update``.

4
salt/modules/zabbix.py
View File

@ -1323,7 +1323,7 @@ def host_inventory_get(hostids, **connection_args):
Retrieve host inventory according to the given parameters.
See: https://www.zabbix.com/documentation/2.4/manual/api/reference/host/object#host_inventory
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param hostids: Return only host interfaces used by the given hosts.
:param _connection_user: Optional - zabbix user (can also be set in opts or pillar, see module's docstring)
@ -1360,7 +1360,7 @@ def host_inventory_set(hostid, **connection_args):
NOTE: This function accepts all standard host: keyword argument names for inventory
see: https://www.zabbix.com/documentation/2.4/manual/api/reference/host/object#host_inventory
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
:param hostid: ID of the host to update
:param clear_old: Set to True in order to remove all existing inventory items before setting the specified items

2
salt/modules/zfs.py
View File

@ -451,7 +451,7 @@ def mount(name=None, **kwargs):
if name == '-a':
salt.utils.versions.warn_until(
'Sodium',
'Passing \'-a\' as name is deprecated as of Salt Fluorine. This '
'Passing \'-a\' as name is deprecated as of Salt 2019.2.0. This '
'warning will be removed in Salt Sodium. Please pass name as '
'\'None\' instead to mount all filesystems.')
flags.append('-a')

2
salt/pillar/netbox.py
View File

@ -2,7 +2,7 @@
'''
A module that adds data to the Pillar structure from a NetBox API.
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Configuring the NetBox ext_pillar
---------------------------------

2
salt/proxy/arista_pyeapi.py
View File

@ -3,7 +3,7 @@
Arista pyeapi
=============
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Proxy module for managing Arista switches via the eAPI using the
`pyeapi <http://pyeapi.readthedocs.io/en/master/index.html>`_ library.

2
salt/proxy/docker.py
View File

@ -2,7 +2,7 @@
'''
Docker Proxy Minion
.. versionadded: Fluorine
.. versionadded: 2019.2.0
:depends: docker

2
salt/proxy/napalm.py
View File

@ -135,7 +135,7 @@ Example using a user-specific library, extending NAPALM's capabilities, e.g. ``c
- :mod:`Users configuration management <salt.modules.napalm_users>`
.. note::
Beginning with release codename Fluorine, any NAPALM command executed when
Beginning with release codename 2019.2.0, any NAPALM command executed when
running under a NAPALM Proxy Minion supports the ``force_reconnect``
magic argument.

2
salt/proxy/netmiko_px.py
View File

@ -3,7 +3,7 @@
Netmiko
=======
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Proxy module for managing network devices via
`Netmiko <https://github.com/ktbyers/netmiko>`_.

2
salt/proxy/nxos_api.py
View File

@ -2,7 +2,7 @@
'''
Proxy Minion to manage Cisco Nexus Switches (NX-OS) over the NX-API
.. versionadded:: Fluorine
.. versionadded:: 2019.2.0
Proxy module for managing Cisco Nexus switches via the NX-API.

Some files were not shown because too many files have changed in this diff Show More