cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Document deprecation of fetch module validate_md5 and update --tags merging deprecation (#24022)

Browse source 
* Document deprecation of fetch module validate_md5 and update --tags merging deprecation

Update the default of --tags merging config option to merge by default

* Update CHANGELOG.md

Minor edit
This commit is contained in:
Toshio Kuratomi 2017-04-26 19:57:21 -07:00 committed by GitHub
parent a5d6d3b9af
commit 51e3390333
4 changed files with 20 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
CHANGELOG.md
View file

@ -13,6 +13,15 @@ Ansible Changes By Release
Python-2.5 you'll need to install Python-2.6 or better there or run Python-2.5 you'll need to install Python-2.6 or better there or run
Ansible-2.3 until you can upgrade the system. Ansible-2.3 until you can upgrade the system.
### Deprecations
* The behaviour when specifying --tags (or --skip-tags) multiple times on the command line
has changed so that the tags are merged together by default. See the
documentation for how to temporarily use the old behaviour if needed:
https://docs.ansible.com/ansible/intro_configuration.html#merge-multiple-cli-tags
* The fetch module's validate_md5 parameter has been deprecated and will be
removed in 2.8. If you wish to disable post-validation of the downloaded
file, use validate_checksum instead.
### Minor Changes ### Minor Changes
* removed previously deprecated config option 'hostfile' and env var 'ANSIBLE_HOSTS' * removed previously deprecated config option 'hostfile' and env var 'ANSIBLE_HOSTS'
* removed unused and deprecated config option 'pattern' * removed unused and deprecated config option 'pattern'

15
docs/docsite/rst/intro_configuration.rst
View file

@ -607,15 +607,16 @@ merge_multiple_cli_tags
.. versionadded:: 2.3 .. versionadded:: 2.3
This allows changing how multiple --tags and --skip-tags arguments are handled This allows changing how multiple :option:`--tags` and :option:`--skip-tags`
on the command line. In Ansible up to and including 2.3, specifying --tags arguments are handled on the command line. Specifying :option:`--tags` more
more than once will only take the last value of --tags. Setting this config than once merges all of the :option:`--tags` options together. If you want
value to True will mean that all of the --tags options will be merged the pre-2.4.x behaviour where only the last value of :option:`--tags` is used,
together. The same holds true for --skip-tags. then set this to False. The same holds true for :option:`--skip-tags`.
.. note:: The default value for this in 2.3 is False. In 2.4, the .. note:: The default value for this in 2.3 is False. In 2.4, the
default value will be True. After 2.4, the option is going away. default value is True. After 2.8, the option will be removed.
Multiple --tags and multiple --skip-tags will always be merged together. Multiple :option:`--tags` and multiple :option:`--skip-tags` will always
be merged together.
.. _module_lang: .. _module_lang:

3
examples/ansible.cfg
View file

@ -276,7 +276,8 @@
# This controls how ansible handles multiple --tags and --skip-tags arguments # This controls how ansible handles multiple --tags and --skip-tags arguments
# on the CLI. If this is True then multiple arguments are merged together. If # on the CLI. If this is True then multiple arguments are merged together. If
# it is False, then the last specified argument is used and the others are ignored. # it is False, then the last specified argument is used and the others are ignored.
#merge_multiple_cli_flags = False # This option will be removed in 2.8.
#merge_multiple_cli_flags = True
# Controls showing custom stats at the end, off by default # Controls showing custom stats at the end, off by default
#show_custom_stats = True #show_custom_stats = True

2
lib/ansible/constants.py
View file

@ -190,7 +190,7 @@ DEFAULTS='defaults'
# True, merge the lists of tags together. If False, let the last argument # True, merge the lists of tags together. If False, let the last argument
# overwrite any previous ones. Behaviour is overwrite through 2.2. 2.3 # overwrite any previous ones. Behaviour is overwrite through 2.2. 2.3
# overwrites but prints deprecation. 2.4 the default is to merge. # overwrites but prints deprecation. 2.4 the default is to merge.
MERGE_MULTIPLE_CLI_TAGS = get_config(p, DEFAULTS, 'merge_multiple_cli_tags', 'ANSIBLE_MERGE_MULTIPLE_CLI_TAGS', False, value_type='boolean') MERGE_MULTIPLE_CLI_TAGS = get_config(p, DEFAULTS, 'merge_multiple_cli_tags', 'ANSIBLE_MERGE_MULTIPLE_CLI_TAGS', True, value_type='boolean')
#### GENERALLY CONFIGURABLE THINGS #### #### GENERALLY CONFIGURABLE THINGS ####
DEFAULT_DEBUG = get_config(p, DEFAULTS, 'debug', 'ANSIBLE_DEBUG', False, value_type='boolean') DEFAULT_DEBUG = get_config(p, DEFAULTS, 'debug', 'ANSIBLE_DEBUG', False, value_type='boolean')