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

Clean up Ansible 2.0 release notes in CHANGELOG.md.

Browse source
This commit is contained in:
Jeff Geerling 2015-09-11 21:08:01 -05:00
parent 03758151e4
commit 0857e29e77
1 changed files with 247 additions and 240 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

69
CHANGELOG.md
View file

@ -4,31 +4,29 @@ Ansible Changes By Release
## 2.0 "Over the Hills and Far Away" - ACTIVE DEVELOPMENT ## 2.0 "Over the Hills and Far Away" - ACTIVE DEVELOPMENT
Major Changes: Major Changes:
* Introducing the new block/rescue/always directives, allow for making task blocks and introducing exception like semantics
* New strategy plugins, allow to control the flow of execution of tasks per play, the default will be the same as before * The new block/rescue/always directives allow for making task blocks and exception-like semantics
* Improved error handling, now you get much more detailed parser messages. General exception handling and display has been revamped. * New strategy plugins (e.g. `free`) allow control over the flow of task execution per play. The default (`linear`) will be the same as before.
* Task includes now get evaluated during execution, end behaviour will be the same but it now allows for more dynamic includes and options. * Improved error handling, with more detailed parser messages. General exception handling and display has been revamped.
* First feature of the more dynamic includes is that "with\_<lookup>" loops are now usable with them. * Task includes are now evaluated during execution, allowing more dynamic includes and options.
* callback, connection and lookup plugin APIs have changed, some will require modification to work with new version * "with\_<lookup>" loops can now be used with includes since they are dynamic.
* callbacks are now shipped in the active directory and don't need to be copied, just whitelisted in ansible.cfg * Callback, connection and lookup plugin APIs have changed. Some projects will require modification to work with the new versions.
* Many API changes, this will break those currently using it directly, but the new API is much easier to use and test * Callbacks are now shipped in the active directory and don't need to be copied, just whitelisted in ansible.cfg.
* Settings are now more inheritable, what you set at play, block or role will be automatically inhertited by the contained. * Many API changes. Those integrating directly with Ansible's API will encounter breaking changes, but the new API is much easier to use and test.
This allows for new features to automatically be settable at all levels, previously we had to manually code this * Settings are now more inheritable; what you set at play, block or role will be automatically inhertited by the contained. This allows for new features to automatically be settable at all levels, previously we had to manually code this.
* template code now retains types for bools and numbers instead of turning them into strings. * Template code now retains types for bools and numbers instead of turning them into strings.
If you need the old behaviour, quote the value and it will get passed around as a string If you need the old behaviour, quote the value and it will get passed around as a string
* added meta: refresh_inventory to force rereading the inventory in a play * Added `meta: refresh_inventory` to force rereading the inventory in a play.
* vars are now settable at play, block, role and task level * Vars are now settable at play, block, role and task level.
* template code now retains types for bools, and Numbers instead of turning them into strings
If you need the old behaviour, quote the value and it will get passed around as a string. In the
case of nulls, the output used to be an empty string.
* Empty variables and variables set to null in yaml will no longer be converted to empty strings. * Empty variables and variables set to null in yaml will no longer be converted to empty strings.
They will retain the value of `None`. To go back to the old behaviour, you can override They will retain the value of `None`. To go back to the old behaviour, you can override
the `null_representation` setting to an empty string in your config file or by setting the the `null_representation` setting to an empty string in your config file or by setting the
`ANSIBLE_NULL_REPRESENTATION` environment variable. `ANSIBLE_NULL_REPRESENTATION` environment variable.
* backslashes used when specifying parameters in jinja2 expressions in YAML * Backslashes used when specifying parameters in jinja2 expressions in YAML
dicts sometimes needed to be escaped twice. This has been fixed so that dicts sometimes needed to be escaped twice. This has been fixed so that
escaping once works. Here's an example of how playbooks need to be modified:: escaping once works. Here's an example of how playbooks need to be modified:
```
# Syntax in 1.9.x # Syntax in 1.9.x
- debug: - debug:
msg: "{{ 'test1_junk 1\\\\3' | regex_replace('(.*)_junk (.*)', '\\\\1 \\\\2') }}" msg: "{{ 'test1_junk 1\\\\3' | regex_replace('(.*)_junk (.*)', '\\\\1 \\\\2') }}"
@ -38,13 +36,15 @@ Major Changes:
# Output: # Output:
"msg": "test1 1\\3" "msg": "test1 1\\3"
```
* When a string with a trailing newline was specified in the playbook via yaml * When a string with a trailing newline was specified in the playbook via yaml
dict format, the trailing newline was stripped. When specified in key=value dict format, the trailing newline was stripped. When specified in key=value
format the trailing newlines were kept. In v2, both methods of specifying the format the trailing newlines were kept. In v2, both methods of specifying the
string will keep the trailing newlines. If you relied on the trailing string will keep the trailing newlines. If you relied on the trailing
newline being stripped you can change your playbook like this:: newline being stripped you can change your playbook like this:
```
# Syntax in 1.9.2 # Syntax in 1.9.2
vars: vars:
message: > message: >
@ -53,6 +53,7 @@ Major Changes:
tasks: tasks:
- debug: - debug:
msg: "{{ message }}" msg: "{{ message }}"
# Syntax in 2.0.x # Syntax in 2.0.x
vars: vars:
old_message: > old_message: >
@ -63,8 +64,10 @@ Major Changes:
msg: "{{ message }}" msg: "{{ message }}"
# Output # Output
"msg": "Testing some things" "msg": "Testing some things"
```
Deprecated Modules (new ones in parens): Deprecated Modules (new ones in parens):
* ec2_ami_search (ec2_ami_find) * ec2_ami_search (ec2_ami_find)
* quantum_network (os_network) * quantum_network (os_network)
* glance_image * glance_image
@ -72,6 +75,7 @@ Deprecated Modules (new ones in parens):
* quantum_floating_ip (os_floating_ip) * quantum_floating_ip (os_floating_ip)
New Modules: New Modules:
* amazon: ec2_ami_copy * amazon: ec2_ami_copy
* amazon: ec2_ami_find * amazon: ec2_ami_find
* amazon: ec2_elb_facts * amazon: ec2_elb_facts
@ -221,6 +225,7 @@ New Modules:
* znode * znode
New Inventory scripts: New Inventory scripts:
* cloudstack * cloudstack
* fleetctl * fleetctl
* openvz * openvz
@ -229,40 +234,42 @@ New Inventory scripts:
* serf * serf
New Lookups: New Lookups:
* credstash * credstash
* hashi_vault * hashi_vault
* ini * ini
* shelvefile * shelvefile
New filters: New filters:
* combine * combine
New Connection Methods: New Connection Methods:
* Added a connection plugin for talking to docker containers on the ansible controller machine without using ssh
* Added a connection plugin for talking to docker containers on the ansible controller machine without using ssh.
Minor changes: Minor changes:
* Many more tests, new API makes things more testable and we took advantage of it * Many more tests. The new API makes things more testable and we took advantage of it.
* big_ip modules now support turning off ssl certificate validation (use only for self signed) * big_ip modules now support turning off ssl certificate validation (use only for self-signed certificates).
* Use "pattern1:pattern2" to combine host matching patterns. The undocumented * Use "pattern1:pattern2" to combine host matching patterns. The undocumented
use of semicolons or commas to combine patterns is no longer supported. use of semicolons or commas to combine patterns is no longer supported.
* Use ``hosts: groupname[x:y]`` to select a subset of hosts in a group; the * Use ``hosts: groupname[x:y]`` to select a subset of hosts in a group; the
``[x-y]`` range syntax is no longer supported. Note that ``[0:1]`` matches ``[x-y]`` range syntax is no longer supported. Note that ``[0:1]`` matches
two hosts, i.e. the range is inclusive of its endpoints. two hosts, i.e. the range is inclusive of its endpoints.
* Now when you delegate a action that returns ansible_facts, these facts will now be applied to the delegated host, * Now when you delegate an action that returns ansible_facts, these facts will be applied to the delegated host, unlike before when they were applied to the current host.
unlike before which they were applied to the current host. * Consolidated code from modules using urllib2 to normalize features, TLS and SNI support.
* Consolidated code from modules using urllib2 to normalize features, TLS and SNI support * synchronize module's dest_port parameter now takes precedence over the ansible_ssh_port inventory setting.
* synchronize module's dest_port parameter now takes precedence over the ansible_ssh_port inventory setting * Play output is now dynamically sized to terminal with a minimum of 80 coluumns (old default).
* play output is now dynamically sized to terminal with a minimal of 80 coluumns (old default) * vars_prompt and pause are now skipped with a warning if the play is called non interactively (i.e. pull from cron).
* vars_prompt and pause are now skipped with a warning if the play is called non interactively (i.e. pull from cron)
* Support for OpenBSD's 'doas' privilege escalation method. * Support for OpenBSD's 'doas' privilege escalation method.
* most vault operations can now be done over multilple files * Most vault operations can now be done over multilple files.
* ansible-vault encrypt/decrypt read from stdin if no other input file is given, * ansible-vault encrypt/decrypt read from stdin if no other input file is given,
and can write to a given ``--output file`` (including stdout, '-'). This lets and can write to a given ``--output file`` (including stdout, '-'). This lets
you avoid ever writing sensitive plaintext to disk. you avoid ever writing sensitive plaintext to disk.
* ansible-vault rekey accepts the --new-vault-password-file option. * ansible-vault rekey accepts the --new-vault-password-file option.
* configuration items defined as paths (local only) will now all support shell style interpolations * Configuration items defined as paths (local only) now all support shell style interpolations.
* many fixes and new options added to modules, too many to list here. * Many fixes and new options added to modules, too many to list here.
## 1.9.2 "Dancing In the Street" - Jun 26, 2015 ## 1.9.2 "Dancing In the Street" - Jun 26, 2015