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

Document , instead of : in intro_patterns, update changelog

Browse source
This commit is contained in:
Abhijit Menon-Sen 2015-09-17 16:34:45 +05:30
parent abd006657b
commit b47bc343ea
2 changed files with 11 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
CHANGELOG.md
View file

@ -22,6 +22,10 @@ Major Changes:
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.
* Use "pattern1,pattern2" to combine host matching patterns. The use of
':' as a separator is deprecated (accepted with a warning) because it
conflicts with IPv6 addresses. The undocumented use of ';' as a
separator is no longer supported.
* 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:
@ -252,8 +256,6 @@ Minor changes:
* Many more tests. The 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 certificates). * 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 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.

14
docsite/rst/intro_patterns.rst
View file

@ -27,7 +27,7 @@ The following patterns are equivalent and target all hosts in the inventory::
It is also possible to address a specific host or set of hosts by name:: It is also possible to address a specific host or set of hosts by name::
one.example.com one.example.com
one.example.com:two.example.com one.example.com, two.example.com
192.168.1.50 192.168.1.50
192.168.1.* 192.168.1.*
@ -35,20 +35,20 @@ The following patterns address one or more groups. Groups separated by a colon
This means the host may be in either one group or the other:: This means the host may be in either one group or the other::
webservers webservers
webservers:dbservers webservers,dbservers
You can exclude groups as well, for instance, all machines must be in the group webservers but not in the group phoenix:: You can exclude groups as well, for instance, all machines must be in the group webservers but not in the group phoenix::
webservers:!phoenix webservers,!phoenix
You can also specify the intersection of two groups. This would mean the hosts must be in the group webservers and You can also specify the intersection of two groups. This would mean the hosts must be in the group webservers and
the host must also be in the group staging:: the host must also be in the group staging::
webservers:&staging webservers,&staging
You can do combinations:: You can do combinations::
webservers:dbservers:&staging:!phoenix webservers,dbservers,&staging,!phoenix
The above configuration means "all machines in the groups 'webservers' and 'dbservers' are to be managed if they are in The above configuration means "all machines in the groups 'webservers' and 'dbservers' are to be managed if they are in
the group 'staging' also, but the machines are not to be managed if they are in the group 'phoenix' ... whew! the group 'staging' also, but the machines are not to be managed if they are in the group 'phoenix' ... whew!
@ -56,7 +56,7 @@ the group 'staging' also, but the machines are not to be managed if they are in
You can also use variables if you want to pass some group specifiers via the "-e" argument to ansible-playbook, but this You can also use variables if you want to pass some group specifiers via the "-e" argument to ansible-playbook, but this
is uncommonly used:: is uncommonly used::
webservers:!{{excluded}}:&{{required}} webservers,!{{excluded}},&{{required}}
You also don't have to manage by strictly defined groups. Individual host names, IPs and groups, can also be referenced using You also don't have to manage by strictly defined groups. Individual host names, IPs and groups, can also be referenced using
wildcards:: wildcards::
@ -66,7 +66,7 @@ wildcards::
It's also ok to mix wildcard patterns and groups at the same time:: It's also ok to mix wildcard patterns and groups at the same time::
one*.com:dbservers one*.com,dbservers
You can select a host or subset of hosts from a group by their position. For example, given the following group:: You can select a host or subset of hosts from a group by their position. For example, given the following group::