CHANGELOG.md 99.6 KB
Newer Older
Michael DeHaan committed
1 2 3
Ansible Changes By Release
==========================

4
## 2.0 "Over the Hills and Far Away" - ACTIVE DEVELOPMENT
James Cammarata committed
5

6
Major Changes:
7

8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
* The new block/rescue/always directives allow for making task blocks and exception-like semantics
* 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.
* Improved error handling, with more detailed parser messages. General exception handling and display has been revamped.
* Task includes are now evaluated during execution, allowing more dynamic includes and options.
* "with\_<lookup>" loops can now be used with includes since they are dynamic.
* Callback, connection and lookup plugin APIs have changed. Some projects will require modification to work with the new versions.
* Callbacks are now shipped in the active directory and don't need to be copied, just whitelisted in ansible.cfg.
* 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.
* 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.
 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.
* Vars are now settable at play, block, role and task level.
* 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
the `null_representation` setting to an empty string in your config file or by setting the
`ANSIBLE_NULL_REPRESENTATION` environment variable.
25 26 27 28 29 30
* The `ansible_ssh_common_args` inventory variable now provides a
  convenient way to configure a per-group or per-host ssh ProxyCommand
  or set any other ssh options. Also, `ansible_ssh_extra_args` can be
  used to set options that are accepted only by ssh (not sftp or scp,
  which have their own analogous settings).
* Use `pattern1,pattern2` to combine host matching patterns. The use of
31 32 33
  ':' 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.
34 35 36
* Backslashes used when specifying parameters in jinja2 expressions in YAML
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:
37

38 39 40 41 42 43 44
    ```
    # Syntax in 1.9.x
    - debug:
        msg: "{{ 'test1_junk 1\\\\3' | regex_replace('(.*)_junk (.*)', '\\\\1 \\\\2') }}"
    # Syntax in 2.0.x
    - debug:
        msg: "{{ 'test1_junk 1\\3' | regex_replace('(.*)_junk (.*)', '\\1 \\2') }}"
45

46 47 48
    # Output:
    "msg": "test1 1\\3"
    ```
James Cammarata committed
49

50 51 52 53 54
* 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
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
newline being stripped you can change your playbook like this:
55

56 57 58 59 60 61 62 63 64
    ```
    # Syntax in 1.9.2
    vars:
      message: >
        Testing
        some things
    tasks:
    - debug:
        msg: "{{ message }}"
65

66 67 68 69 70 71 72 73 74 75 76
    # Syntax in 2.0.x
    vars:
      old_message: >
        Testing
        some things
      message: "{{ old_messsage[:-1] }}"
    - debug:
        msg: "{{ message }}"
    # Output
    "msg": "Testing some things"
    ```
77

78
Deprecated Modules (new ones in parens):
79 80 81 82 83 84

* ec2_ami_search (ec2_ami_find)
* quantum_network (os_network)
* glance_image
* nova_compute   (os_server)
* quantum_floating_ip (os_floating_ip)
85 86 87
* quantum_router (os_router)
* quantum_router_gateway (os_router)
* quantum_router_interface (os_router)
88

89
New Modules:
90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105

* amazon: ec2_ami_copy
* amazon: ec2_ami_find
* amazon: ec2_elb_facts
* amazon: ec2_eni
* amazon: ec2_eni_facts
* amazon: ec2_remote_facts
* amazon: ec2_vpc_net
* amazon: ec2_vpc_route_table
* amazon: ec2_vpc_route_table_facts
* amazon: ec2_vpc_subnet
* amazon: ec2_win_password
* amazon: elasticache_subnet_group
* amazon: iam
* amazon: iam_policy
* amazon: route53_zone
106
* amazon: route53_health_check
107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
* amazon: sts_assume_role
* amazon: s3_bucket
* amazon: s3_lifecycle
* amazon: s3_logging
* apk
* bundler
* centurylink: clc_blueprint_package
* centurylink: clc_firewall_policy
* centurylink: clc_loadbalancer
* centurylink: clc_modify_server
* centurylink: clc_publicip
* centurylink: clc_server
* circonus_annotation
* consul
* consul_acl
* consul_kv
* consul_session
* cloudtrail
* cloudstack: cs_account
* cloudstack: cs_affinitygroup
* cloudstack: cs_domain
* cloudstack: cs_facts
* cloudstack: cs_firewall
* cloudstack: cs_iso
* cloudstack: cs_instance
* cloudstack: cs_instancegroup
* cloudstack: cs_ip_address
* cloudstack: cs_network
* cloudstack: cs_portforward
* cloudstack: cs_project
* cloudstack: cs_sshkeypair
* cloudstack: cs_securitygroup
* cloudstack: cs_securitygroup_rule
* cloudstack: cs_staticnat
* cloudstack: cs_template
142
* cloudstack: cs_user
143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160
* cloudstack: cs_vmsnapshot
* datadog_monitor
* dpkg_selections
* elasticsearch_plugin
* expect
* find
* hall
* libvirt: virt_net
* libvirt: virt_pool
* maven_artifact
* openstack: os_ironic
* openstack: os_ironic_node
* openstack: os_client_config
* openstack: os_floating_ip
* openstack: os_image
* openstack: os_network
* openstack: os_nova_flavor
* openstack: os_object
161
* openstack: os_router
162 163 164 165 166 167 168
* openstack: os_security_group
* openstack: os_security_group_rule
* openstack: os_server
* openstack: os_server_actions
* openstack: os_server_facts
* openstack: os_server_volume
* openstack: os_subnet
169
* openstack: os_user_group
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227
* openstack: os_volume
* openvswitch_db.
* osx_defaults
* pagerduty_alert
* pam_limits
* pear
* profitbricks: profitbricks
* profitbricks: profitbricks_datacenter
* profitbricks: profitbricks_nic
* profitbricks: profitbricks_snapshot
* profitbricks: profitbricks_volume
* profitbricks: profitbricks_volume_attachments
* proxmox
* proxmox_template
* puppet
* pushover
* pushbullet
* rax: rax_mon_alarm
* rax: rax_mon_check
* rax: rax_mon_entity
* rax: rax_mon_notification
* rax: rax_mon_notification_plan
* rabbitmq_binding
* rabbitmq_exchange
* rabbitmq_queue
* selinux_permissive
* sensu_check
* sensu_subscription
* seport
* slackpkg
* solaris_zone
* vertica_configuration
* vertica_facts
* vertica_role
* vertica_schema
* vertica_user
* vmware: vmware_datacenter
* vmware: vmware_cluster
* vmware: vmware_dns_config
* vmware: vmware_dvs_host
* vmware: vmware_dvs_portgroup
* vmware: vmware_dvswitch
* vmware: vmware_host
* vmware: vmware_vmkernel_ip_config
* vmware: vmware_portgroup
* vmware: vmware_vm_facts
* vmware: vmware_vmkernel
* vmware: vmware_vsan_cluster
* vmware: vmware_vswitch
* vmware: vca_fw
* vmware: vca_nat
* vmware: vsphere_copy
* webfaction_app
* webfaction_db
* webfaction_domain
* webfaction_mailbox
* webfaction_site
* win_environment
228
* win_firewall_rule
229 230 231 232 233 234 235 236 237 238 239 240 241 242
* win_package
* win_scheduled_task
* win_iis_virtualdirectory
* win_iis_webapplication
* win_iis_webapppool
* win_iis_webbinding
* win_iis_website
* win_regedit
* win_unzip
* xenserver_facts
* zabbix_host
* zabbix_hostmacro
* zabbix_screen
* znode
243

244
New Inventory scripts:
245 246 247 248 249 250 251

* cloudstack
* fleetctl
* openvz
* nagios_ndo
* proxmox
* serf
252

Brian Coca committed
253
New Lookups:
254 255 256 257 258

* credstash
* hashi_vault
* ini
* shelvefile
Brian Coca committed
259

260
New filters:
261 262

* combine
263

264
New Connection Methods:
265 266

* Added a connection plugin for talking to docker containers on the ansible controller machine without using ssh.
267

268 269
Minor changes:

270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287
* 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).
* 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
two hosts, i.e. the range is inclusive of its endpoints.
* 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.
* 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.
* Play output is now dynamically sized to terminal with a minimum 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).
* Support for OpenBSD's 'doas' privilege escalation method.
* Most vault operations can now be done over multilple files.
* 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
you avoid ever writing sensitive plaintext to disk.
* ansible-vault rekey accepts the --new-vault-password-file option.
* 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.
288

289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316
## 1.9.2 "Dancing In the Street" - Jun 26, 2015

* Security fixes to check that hostnames match certificates with https urls (CVE-2015-3908)
  - get_url and uri modules
  - url and etcd lookup plugins
* Security fixes to the zone (Solaris containers), jail (bsd containers),
  and chroot connection plugins.  These plugins can be used to connect to
  their respective container types in leiu of the standard ssh connection.
  Prior to this fix being applied these connection plugins didn't properly
  handle symlinks within the containers which could lead to files intended to
  be written to or read from the container being written to or read from the
  host system instead. (CVE pending)
* Fixed a bug in the service module where init scripts were being incorrectly used instead of upstart/systemd.
* Fixed a bug where sudo/su settings were not inherited from ansible.cfg correctly.
* Fixed a bug in the rds module where a traceback may occur due to an unbound variable.
* Fixed a bug where certain remote file systems where the SELinux context was not being properly set.
* Re-enabled several windows modules which had been partially merged (via action plugins):
  - win_copy.ps1
  - win_copy.py
  - win_file.ps1
  - win_file.py
  - win_template.py
* Fix bug using with_sequence and a count that is zero.  Also allows counting backwards isntead of forwards
* Fix get_url module bug preventing use of custom ports with https urls
* Fix bug disabling repositories in the yum module.
* Fix giving yum module a url to install a package from on RHEL/CENTOS5
* Fix bug in dnf module preventing it from working when yum-utils was not already installed

317 318 319 320 321 322 323 324 325 326 327 328
## 1.9.1 "Dancing In the Street" - Apr 27, 2015

* Fixed a bug related to Kerberos auth when using winrm with a domain account.
* Fixing several bugs in the s3 module.
* Fixed a bug with upstart service detection in the service module.
* Fixed several bugs with the user module when used on OSX.
* Fixed unicode handling in some module situations (assert and shell/command execution).
* Fixed a bug in redhat_subscription when using the activationkey parameter.
* Fixed a traceback in the gce module on EL6 distros when multiple pycrypto installations are available.
* Added support for PostgreSQL 9.4 in rds_param_group
* Several other minor fixes.

329
## 1.9 "Dancing In the Street" - Mar 25, 2015
Brian Coca committed
330

331 332 333
Major changes:

* Added kerberos support to winrm connection plugin.
Brian Coca committed
334
* Tags rehaul: added 'all', 'always', 'untagged' and 'tagged' special tags and normalized
335
  tag resolution. Added tag information to --list-tasks and new --list-tags option.
Toshio Kuratomi committed
336
* Privilege Escalation generalization, new 'Become' system and variables  now will
337 338 339 340 341 342
  handle existing and new methods. Sudo and su have been kept for backwards compatibility.
  New methods pbrun and pfexec in 'alpha' state, planned adding 'runas' for winrm connection plugin.
* Improved ssh connection error reporting, now you get back the specific message from ssh.
* Added facility to document task module return values for registered vars, both for
  ansible-doc and the docsite. Documented copy, stats and acl modules, the rest must be
  updated individually (we will start doing so incrementally).
343 344
* Optimize the plugin loader to cache available plugins much more efficiently.
  For some use cases this can lead to dramatic improvements in startup time.
345
* Overhaul of the checksum system, now supports more systems and more cases more reliably and uniformly.
346
* Fix skipped tasks to not display their parameters if no_log is specified.
Andrew Murray committed
347
* Many fixes to unicode support, standarized functions to make it easier to add to input/output boundaries.
348
* Added travis integration to github for basic tests, this should speed up ticket triage and merging.
349
* environment: directive now can also be applied to play and is inhertited by tasks, which can still override it.
Brian Coca committed
350
* expanded facts and OS/distribution support for existing facts and improved performance with pypy.
yunano committed
351
* new 'wantlist' option to lookups allows for selecting a list typed variable vs a comma delimited string as the return.
352
* the shared module code for file backups now uses a timestamp resolution of seconds (previouslly minutes).
Brian Coca committed
353 354 355
* allow for empty inventories, this is now a warning and not an error (for those using localhost and cloud modules).
* sped up YAML parsing in ansible by up to 25% by switching to CParser loader.

356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373
New Modules:

* cryptab: manages linux encrypted block devices
* gce_img:  for utilizing GCE image resources
* gluster_volume: manage glusterfs volumes
* haproxy: for the load balancer of same name
* known_hosts: manages the ssh known_hosts file
* lxc_container: manage lxc containers
* patch: allows for patching files on target systems
* pkg5:  installing and uninstalling packages on Solaris
* pkg5_publisher: manages Solaris pkg5 repository configuration
* postgresql_ext: manage postgresql extensions
* snmp_facts: gather facts via snmp
* svc: manages daemontools based services
* uptimerobot: manage monitoring with this service

New Filters:

374 375
* ternary: allows for trueval/falseval assignment dependent on conditional
* cartesian: returns the Cartesian product of 2 lists
376 377 378 379 380 381 382 383 384 385 386
* to_uuid: given a string it will return an ansible domain specific UUID
* checksum: uses the ansible internal checksum to return a hash from a string
* hash: get a hash from a string (md5, sha1, etc)
* password_hash: get a hash form as string that can be used as a password in the user module (and others)
* A whole set of ip/network manipulation filters: ipaddr,ipwrap,ipv4,ipv6ipsubnet,nthhost,hwaddr,macaddr

Other Notable Changes:

* New lookup plugins:
  * dig: does dns resolution and returns IPs.
  * url: allows pulling data from a url.
387

388
* New callback plugins:
389
  * syslog_json: allows logging play output to a syslog network server using json format
390

391 392 393 394 395 396 397 398 399 400 401 402 403 404 405
* Many new enhancements to the amazon web service modules:
  * ec2 now applies all specified security groups when creating a new instance.  Previously it was only applying one
  * ec2_vol gained the ability to specify the EBS volume type
  * ec2_vol can now detach volumes by specifying instance=None
  * Fix ec2_group to purge specific grants rather than whole rules
  * Added tenancy support for the ec2 module
  * rds module has gained the ability to manage tags and set charset and public accessibility
  * ec2_snapshot module gained the capability to remove snapshots
  * Add alias support for route53
  * Add private_zones support to route53
  * ec2_asg: Add wait_for_instances parameter that waits until an instance is ready before ending the ansible task
* Many new docker improvements:
  * restart_policy parameters to configure when the container automatically restarts
  * If the docker client or server doesn't support an option, the task will now fail instead of silently ignoring the option
  * Add insecure_registry parameter for connecting to registries via http
406
  * New parameter to set a container's domain name
407 408 409 410 411 412
  * Undeprecated docker_image module until there's replacement functionality
  * Allow setting the container's pid namespace
  * Add a pull parameter that chooses when ansible will look for more recent images in the registry
  * docker module states have been greatly enhanced.  The reworked and new states are:
    * present now creates but does not start containers
    * restarted always restarts a container
413
    * reloaded restarts a container if ansible detects that the configuration is different than what is specified
414 415 416 417 418 419 420 421 422 423 424 425
      * reloaded accounts for exposed ports, env vars, and volumes
  * Can now connect to the docker server using TLS
* Several source control modules had force parameters that defaulted to true.
  These have been changed to default to false so as not to accidentally lose
  work.  Playbooks that depended on the former behaviour simply need to add
  force=True to the task that needs it.  Affected modules:
  * bzr: When local modifications exist in a checkout, the bzr module used to
    default to removing the modifications on any operation.  Now the module
    will not remove the modifications unless force=yes is specified.
    Operations that depend on a clean working tree may fail unless force=yes is
    added.
  * git: When local modifications exist in a checkout, the git module will now
426
    fail unless force is explicitly specified.  Specifying force=yes will allow
427 428 429 430 431 432 433 434
    the module to revert and overwrite local modifications to make git actions
    succeed.
  * hg: When local modifications exist in a checkout, the hg module used to
    default to removing the modifications on any operation.  Now the module
    will not remove the modifications unless force=yes is specified.
  * subversion: When updating a checkout with local modifications, you now need
    to add force=yes so the module will revert the modifications before updating.
* New inventory scripts:
Brian Coca committed
435 436
  * vbox: virtualbox
  * consul: use consul as an inventory source
437 438 439 440 441 442 443 444 445 446 447
* gce gained the ip_forward parameter to forward ip packets
* disk_auto_delete parameter to gce that will remove the boot disk after an instance is destroyed
* gce can now spawn instances with no external ip
* gce_pd gained the ability to choose a disk type
* gce_net gained target_tags parameter for creating firewall rules
* rax module has new parameters for making use of a boot volume
* Add scheduler_hints to the nova_compute module for optional parameters
* vsphere_guest now supports deploying guests from a template
* Many fixes for hardlink and softlink handling in file-related modules
* Implement user, group, mode, and selinux parameters for the unarchive module
* authorized_keys can now use url as a key source
448
* authorized_keys has a new exclusive parameter that determines if keys that weren't specified in the task
449 450 451 452 453 454 455 456 457
* The selinux module now sets the current running state to permissive if state='disabled'
* Can now set accounts to expire via the user module
* Overhaul of the service module to make code simpler and behave better for systems running several popular init systems
* yum module now has a parameter to refresh its cache of package metadata
* apt module gained a build_dep parameter to install a package's build dependencies
* Add parameters to the postgres modules to specify a unix socket to connect to the db
* The mount module now supports bind mounts
* Add a clone parameter to git module that allows you to get information about a remote repo even if it doesn't exist locally.
* Add a refspec argument to the git module that allows pulling commits that aren't part of a branch
458 459
* Many documentation additions and fixes.

460 461 462 463 464 465
## 1.8.4 "You Really Got Me" - Feb 19, 2015

* Fixed regressions in ec2 and mount modules, introduced in 1.8.3

## 1.8.3 "You Really Got Me" - Feb 17, 2015

Andrew Murray committed
466
* Fixing a security bug related to the default permissions set on a temporary file created when using "ansible-vault view <filename>".
467 468 469 470 471 472 473 474 475 476
* Many bug fixes, for both core code and core modules.

## 1.8.2 "You Really Got Me" - Dec 04, 2014

* Various bug fixes for packaging issues related to modules.
* Various bug fixes for lookup plugins.
* Various bug fixes for some modules (continued cleanup of postgresql issues, etc.).

* Add a clone parameter to git module that allows you to get information about a remote repo even if it doesn't exist locally.

477 478 479 480 481 482 483
## 1.8.1 "You Really Got Me" - Nov 26, 2014

* Various bug fixes in postgresql and mysql modules.
* Fixed a bug related to lookup plugins used within roles not finding files based on the relative paths to the roles files/ directory.
* Fixed a bug related to vars specified in plays being templated too early, resulting in incorrect variable interpolation.
* Fixed a bug related to git submodules in bare repos.

James Cammarata committed
484
## 1.8 "You Really Got Me" - Nov 25, 2014
Michael DeHaan committed
485

486
Major changes:
487

488 489 490 491 492
* fact caching support, pluggable, initially supports Redis (DOCS pending)
* 'serial' size in a rolling update can be specified as a percentage
* added new Jinja2 filters, 'min' and 'max' that take lists
* new 'ansible_version' variable available contains a dictionary of version info
* For ec2 dynamic inventory, ec2.ini can has various new configuration options
Michael DeHaan committed
493
* 'ansible vault view filename.yml' opens filename.yml decrypted in a pager.
494
* no_log parameter now surpressess data from callbacks/output as well as syslog
Michael DeHaan committed
495
* ansible-galaxy install -f requirements.yml allows advanced options and installs from non-galaxy SCM sources and tarballs.
496
* command_warnings feature will warn about when usage of the shell/command module can be simplified to use core modules - this can be enabled in ansible.cfg
Michael DeHaan committed
497
* new omit value can be used to leave off a parameter when not set, like so module_name: a=1 b={{ c | default(omit) }}, would not pass value for b (not even an empty value) if c was not set.
498
* developers: 'baby JSON' in module responses, originally intended for writing modules in bash, is removed as a feature to simplify logic, script module remains available for running bash scripts.
499
* async jobs started in "fire & forget" mode can now be checked on at a later time.
Michael DeHaan committed
500 501 502
* added ability to subcategorize modules for docs.ansible.com
* added ability for shipped modules to have aliases with symlinks
* added ability to deprecate older modules by starting with "_" and including "deprecated: message why" in module docs
503 504 505

New Modules:

506 507 508 509 510
* cloud: rax_cdb - manages Rackspace Cloud Database instances
* cloud: rax_cdb_database - manages Rackspace Cloud Databases
* cloud: rax_cdb_user - manages Rackspace Cloud Database users
* monitoring: zabbix_maintaince - handles outage windows with Zabbix
* monitoring: bigpanda - support for bigpanda
511 512 513
* net_infrastructure: a10_server - manages server objects on A10 devices
* net_infrastructure: a10_service_group - manages service group objects on A10 devices
* net_infrastructure: a10_virtual_server - manages virtual server objects on A10 devices
514 515 516 517
* system: getent - read getent databases

Some other notable changes:

518
* added the ability to set "instance filters" in the ec2.ini to limit results from the inventory plugin.
Michael DeHaan committed
519
* upgrades for various variable precedence items and parsing related items
520
* added a new "follow" parameter to the file and copy modules, which allows actions to be taken on the target of a symlink rather than the symlink itself.
521
* if a module should ever traceback, it will return a standard error, catchable by ignore_errors, versus an 'unreachable'
522 523
* ec2_lc: added support for multiple new parameters like kernel_id, ramdisk_id and ebs_optimized.
* ec2_elb_lb: added support for the connection_draining_timeout and cross_az_load_balancing options.
524
* support for symbolic representations (ie. u+rw) for file permission modes (file/copy/template modules etc.).
525 526 527 528 529 530 531 532 533 534 535 536 537 538
* docker: Added support for specifying the net type of the container.
* docker: support for specifying read-only volumes.
* docker: support for specifying the API version to use for the remote connection.
* openstack modules: various improvements
* irc: ssl support for the notification module
* npm: fix flags passed to package installation
* windows: improved error handling
* setup: additional facts on System Z
* apt_repository: certificate validation can be disabled if requested
* pagerduty module: misc improvements
* ec2_lc: public_ip boolean configurable in launch configurations
* ec2_asg: fixes related to proper termination of an autoscaling group
* win_setup: total memory fact correction
* ec2_vol: ability to list existing volumes
Drew Blas committed
539
* ec2: can set optimized flag
540 541
* various parser improvements
* produce a friendly error message if the SSH key is too permissive
542
* ec2_ami_search: support for SSD and IOPS provisioned EBS images
543 544
* can set ansible_sudo_exe as an inventory variable which allows specifying
  a different sudo (or equivalent) command
545 546 547 548 549 550 551 552
* git module: Submodule handling has changed.  Previously if you used the
  ``recursive`` parameter to handle submodules, ansible would track the
  submodule upstream's head revision.  This has been changed to checkout the
  version of the submodule specified in the superproject's git repository.
  This is inline with what git submodule update does.  If you want the old
  behaviour use the new module parameter track_submodules=yes
* Checksumming of transferred files has been made more portable and now uses
  the sha1 algorithm instead of md5 to be compatible with FIPS-140.
553 554 555
  - As a small side effect, the fetch module no longer returns a useful value
    in remote_md5.  If you need a replacement, switch to using remote_checksum
    which returns the sha1sum of the remote file.
Michael DeHaan committed
556
* ansible-doc CLI tool contains various improvements for working with different terminals
557 558

And various other bug fixes and improvements ...
559

Michael DeHaan committed
560

561 562 563 564 565 566
## 1.7.2 "Summer Nights" - Sep 24, 2014

- Fixes a bug in accelerate mode which caused a traceback when trying to use that connection method.
- Fixes a bug in vault where the password file option was not being used correctly internally.
- Improved multi-line parsing when using YAML literal blocks (using > or |).
- Fixed a bug with the file module and the creation of relative symlinks.
567
- Fixed a bug where checkmode was not being honoured during the templating of files.
568 569 570 571 572 573 574 575 576 577 578
- Other various bug fixes.

## 1.7.1 "Summer Nights" - Aug 14, 2014

- Security fix to disallow specifying 'args:' as a string, which could allow the insertion of extra module parameters through variables.
- Performance enhancements related to previous security fixes, which could cause slowness when modules returned very large JSON results. This specifically impacted the unarchive module frequently, which returns the details of all unarchived files in the result.
- Docker module bug fixes:
  * Fixed support for specifying rw/ro bind modes for volumes
  * Fixed support for allowing the tag in the image parameter
- Various other bug fixes

James Cammarata committed
579
## 1.7 "Summer Nights" - Aug 06, 2014
Michael DeHaan committed
580

Michael DeHaan committed
581 582 583
Major new features:

* Windows support (alpha) using native PowerShell remoting
584
* Tasks can now specify `run_once: true`, meaning they will be executed exactly once. This can be combined with delegate_to to trigger actions you want done just the one time versus for every host in inventory.
Michael DeHaan committed
585

Michael DeHaan committed
586 587 588 589 590
New inventory scripts:

* SoftLayer
* Windows Azure

591 592
New Modules:

593
* cloud: azure
594
* cloud: rax_meta
595 596
* cloud: rax_scaling_group
* cloud: rax_scaling_policy
Michael DeHaan committed
597 598 599 600 601 602 603
* windows: version of setup module
* windows: version of slurp module
* windows: win_feature
* windows: win_get_url
* windows: win_msi
* windows: win_ping
* windows: win_user
Michael DeHaan committed
604 605
* windows: win_service
* windows: win_group
Michael DeHaan committed
606

607 608
Other notable changes:

James Cammarata committed
609
* Security fixes
610
  - Prevent the use of lookups when using legacy "{{ }}" syntax around variables and with_* loops.
James Cammarata committed
611
  - Remove relative paths in TAR-archived file names used by ansible-galaxy.
612 613 614
* Inventory speed improvements for very large inventories.
* Vault password files can now be executable, to support scripts that fetch the vault password.

615 616 617 618 619 620 621 622 623 624

## 1.6.10 "And the Cradle Will Rock" - Jul 25, 2014

- Fixes an issue with the copy module when copying a directory that fails when changing file attributes and the target file already exists
- Improved unicode handling when splitting args

## 1.6.9 "And the Cradle Will Rock" - Jul 24, 2014

- Further improvements to module parameter parsing to address additional regressions caused by security fixes

625 626 627 628 629 630 631 632 633 634 635 636
## 1.6.8 "And the Cradle Will Rock" - Jul 22, 2014

- Corrects a regression in the way shell and command parameters were being parsed

## 1.6.7 "And the Cradle Will Rock" - Jul 21, 2014

- Security fixes:
  * Strip lookup calls out of inventory variables and clean unsafe data
    returned from lookup plugins (CVE-2014-4966)
  * Make sure vars don't insert extra parameters into module args and prevent
    duplicate params from superseding previous params (CVE-2014-4967)

637 638 639 640
## 1.6.6 "And the Cradle Will Rock" - Jul 01, 2014

- Security updates to further protect against the incorrect execution of untrusted data

Michael DeHaan committed
641 642 643 644
## 1.6.4, 1.6.5 "And the Cradle Will Rock" - Jun 25, 2014

- Security updates related to evaluation of untrusted remote inputs

645 646 647 648 649 650 651 652 653 654 655 656 657 658 659
## 1.6.3 "And the Cradle Will Rock" - Jun 09, 2014

- Corrects a regression where handlers were run across all hosts, not just those that triggered the handler.
- Fixed a bug in which modules did not support properly moving a file atomically when su was in use.
- Fixed two bugs related to symlinks with directories when using the file module.
- Fixed a bug related to MySQL master replication syntax.
- Corrects a regression in the order of variable merging done by the internal runner code.
- Various other minor bug fixes.

## 1.6.2 "And the Cradle Will Rock" - May 23, 2014

- If an improper locale is specified, core modules will now automatically revert to using the 'C' locale.
- Modules using the fetch_url utility will now obey proxy environment variables.
- The SSL validation step in fetch_url will likewise obey proxy settings, however only proxies using the http protocol are supported.
- Fixed multiple bugs in docker module related to version changes upstream.
660 661 662 663 664 665 666 667 668 669 670 671 672
- Fixed a bug in the ec2_group module where egress rules were lost when a VPC was specified.
- Fixed two bugs in the synchronize module:
  * a trailing slash might be lost when calculating relative paths, resulting in an incorrect destination.
  * the sync might use the inventory directory incorrectly instead of the playbook or role directory.
- Files will now only be chown'd on an atomic move if the src/dest uid/gid do not match.

## 1.6.1 "And the Cradle Will Rock" - May 7, 2014

- Fixed a bug in group_by, where systems were being grouped incorrectly.
- Fixed a bug where file descriptors may leak to a child process when using accelerate.
- Fixed a bug in apt_repository triggered when python-apt not being installed/available.
- Fixed a bug in the apache2_module module, where modules were not being disabled correctly.

Michael DeHaan committed
673
## 1.6 "And the Cradle Will Rock" - May 5, 2014
Michael DeHaan committed
674 675 676 677

Major features/changes:

* The deprecated legacy variable templating system has been finally removed.  Use {{ foo }} always not $foo or ${foo}.
678
* Any data file can also be JSON.  Use sparingly -- with great power comes great responsibility.  Starting file with "{" or "[" denotes JSON.
679
* Added 'gathering' param for ansible.cfg to change the default gather_facts policy.
680 681 682
* Accelerate improvements:
  - multiple users can connect with different keys, when `accelerate_multi_key = yes` is specified in the ansible.cfg.
  - daemon lifetime is now based on the time from the last activity, not the time from the daemon's launch.
683 684
* ansible-playbook now accepts --force-handlers to run handlers even if tasks result in failures.
* Added VMWare support with the vsphere_guest module.
Michael DeHaan committed
685

686
New Modules:
Michael DeHaan committed
687

688
* files: replace
Michael DeHaan committed
689
* packaging: cpanm (Perl)
690
* packaging: portage
Michael DeHaan committed
691
* packaging: composer (PHP)
692
* packaging: homebrew_tap (OS X)
693
* packaging: homebrew_cask (OS X) 
694
* packaging: apt_rpm
695
* packaging: layman
696
* monitoring: logentries
697
* monitoring: rollbar_deployment
698
* monitoring: librato_annotation
Michael DeHaan committed
699
* notification: nexmo (SMS)
700
* notification: twilio (SMS)
Michael DeHaan committed
701
* notification: slack (Slack.com)
702
* notification: typetalk (Typetalk.in)
Michael DeHaan committed
703
* notification: sns (Amazon)
704
* system: debconf
705 706
* system: ufw
* system: locale_gen
707
* system: alternatives
708
* system: capabilities
709
* net_infrastructure: bigip_facts
Michael DeHaan committed
710
* net_infrastructure: dnssimple
Michael DeHaan committed
711
* net_infrastructure: lldp
712
* web_infrastructure: apache2_module
713 714 715
* cloud: digital_ocean_domain
* cloud: digital_ocean_sshkey 
* cloud: rax_identity
716 717
* cloud: rax_cbs (cloud block storage)
* cloud: rax_cbs_attachments
718
* cloud: ec2_asg (configure autoscaling groups)
719
* cloud: ec2_scaling_policy
Michael DeHaan committed
720
* cloud: ec2_metric_alarm
721
* cloud: vsphere_guest
Michael DeHaan committed
722 723 724

Other notable changes:

Michael DeHaan committed
725
* example callback plugin added for hipchat
Michael DeHaan committed
726
* added example inventory plugin for vcenter/vsphere
Michael DeHaan committed
727
* added example inventory plugin for doing really trivial inventory from SSH config files
728 729 730
* libvirt module now supports destroyed and paused as states
* s3 module can specify metadata
* security token additions to ec2 modules
Michael DeHaan committed
731
* setup module code moved into module_utils/, facts now accessible by other modules  
732
* synchronize module sets relative dirs based on inventory or role path
733
* misc bugfixes and other parameters
734
* the ec2_key module now has wait/wait_timeout parameters
Michael DeHaan committed
735 736
* added version_compare filter (see docs)
* added ability for module documentation YAML to utilize shared module snippets for common args
Michael DeHaan committed
737 738
* apt module now accepts "deb" parameter to install local dpkg files
* regex_replace filter plugin added
739 740
* added an inventory script for Docker
* added an inventory script for Abiquo
741 742
* the get_url module now accepts url_username and url_password as parameters, so sites which require
  authentication no longer need to have them embedded in the url
Michael DeHaan committed
743
* ... to be filled in from changelogs ...
Michael DeHaan committed
744 745
* 

746 747 748 749 750
## 1.5.5 "Love Walks In" - April 18, 2014

- Security fix for vault, to ensure the umask is set to a restrictive mode before creating/editing vault files.
- Backported apt_repository security fixes relating to filename/mode upon sources list file creation.

Michael DeHaan committed
751 752 753
## 1.5.4 "Love Walks In" - April 1, 2014

- Security fix for safe_eval, which further hardens the checking of the evaluation function.
Andrew Murray committed
754
- Changing order of variable precedence for system facts, to ensure that inventory variables take precedence over any facts that may be set on a host.
Michael DeHaan committed
755

756 757 758 759 760 761 762 763 764
## 1.5.3 "Love Walks In" - March 13, 2014

- Fix validate_certs and run_command errors from previous release
- Fixes to the git module related to host key checking

## 1.5.2 "Love Walks In" - March 11, 2014

- Fix module errors in airbrake and apt from previous release

765 766 767 768 769 770 771
## 1.5.1 "Love Walks In" - March 10, 2014

- Force command action to not be executed by the shell unless specifically enabled.
- Validate SSL certs accessed through urllib*.
- Implement new default cipher class AES256 in ansible-vault.
- Misc bug fixes.

772
## 1.5 "Love Walks In" - February 28, 2014
773

774 775 776 777 778
Major features/changes:

* when_foo which was previously deprecated is now removed, use "when:" instead.  Code generates appropriate error suggestion.
* include + with_items which was previously deprecated is now removed, ditto.  Use with_nested / with_together, etc.
* only_if, which is much older than when_foo and was deprecated, is similarly removed.
Michael DeHaan committed
779
* ssh connection plugin is now more efficient if you add 'pipelining=True' in ansible.cfg under [ssh_connection], see example.cfg
Michael DeHaan committed
780
* localhost/127.0.0.1 is not required to be in inventory if referenced, if not in inventory, it does not implicitly appear in the 'all' group.
781
* git module has new parameters (accept_hostkey, key_file, ssh_opts) to ease the usage of git and ssh protocols. 
782
* when using accelerate mode, the daemon will now be restarted when specifying a different remote_user between plays.
783
* added no_log: option for tasks. When used, no logging information will be sent to syslog during the module execution.
784
* acl module now handles 'default' and allows for either shorthand entry or specific fields per entry section
785
* play_hosts is a new magic variable to provide a list of hosts in scope for the current play.
786
* ec2 module now accepts 'exact_count' and 'count_tag' as a way to enforce a running number of nodes by tags.
787
* all ec2 modules that work with Eucalyptus also now support a 'validate_certs' option, which can be set to 'off' for installations using self-signed certs.
788
* Start of new integration test infrastructure (WIP, more details TBD)
Andrew Murray committed
789
* if repoquery is unavailable, the yum module will automatically attempt to install yum-utils
Michael DeHaan committed
790
* ansible-vault: a framework for encrypting your playbooks and variable files 
791
* added support for privilege escalation via 'su' into bin/ansible and bin/ansible-playbook and associated keywords 'su', 'su_user', 'su_pass' for tasks/plays
792 793 794

New modules:

795 796
* cloud: ec2_elb_lb
* cloud: ec2_key
797
* cloud: ec2_snapshot
798 799 800 801 802 803
* cloud: rax_dns
* cloud: rax_dns_record
* cloud: rax_files
* cloud: rax_files_objects
* cloud: rax_keypair
* cloud: rax_queue
Michael DeHaan committed
804
* cloud: docker_image
805
* messaging: rabbitmq_policy
806
* system: at
807
* utilities: assert
808

809
Other notable changes (many new module params & bugfixes may not be listed):
810

811
* no_reboot is now defaulted to "no" in the ec2_ami module to ensure filesystem consistency in the resulting AMI.
Michael DeHaan committed
812 813 814 815 816 817 818 819 820 821 822 823 824 825
* sysctl module overhauled
* authorized_key module overhauled
* synchronized module now handles local transport better
* apt_key module now ignores case on keys
* zypper_repository now skips on check mode
* file module now responds to force behavior when dealing with hardlinks
* new lookup plugin 'csvfile'
* fixes to allow hash_merge behavior to work with dynamic inventory
* mysql module will use port argument on dump/import
* subversion module now ignores locale to better intercept status messages
* rax api_key argument is no longer logged
* backwards/forwards compatibility for OpenStack modules, 'quantum' modules grok neutron renaming
* hosts properly uniqueified if appearing in redundant groups
* hostname module support added for ScientificLinux
826 827 828 829 830
* ansible-pull can now show live stdout and pass verbosity levels to ansible-playbook
* ec2 instances can now be stopped or started
* additional volumes can be created when creating new ec2 instances
* user module can move a home directory
* significant enhancement and cleanup of rackspace modules
831
* ansible_ssh_private_key_file can be templated
832
* docker module updated to support docker-py 0.3.0
Michael DeHaan committed
833
* various other bug fixes
Michael DeHaan committed
834 835 836
* md5 logic improved during sudo operation
* support for ed25519 keys in authorized_key module
* ability to set directory permissions during a recursive copy (directory_mode parameter)
837

838 839 840 841
## 1.4.5 "Could This Be Magic" - February 12, 2014

- fixed issue with permissions being incorrect on fireball/accelerate keys when the umask setting was too loose.

842 843 844 845
## 1.4.4 "Could This Be Magic" - January 6, 2014

- fixed a minor issue with newer versions of pip dropping the "use-mirrors" parameter.

846 847 848 849 850
## 1.4.3 "Could This Be Magic" - December 20, 2013

- Fixed role_path parsing from ansible.cfg
- Fixed default role templates

Rene Moser committed
851
## 1.4.2 "Could This Be Magic" - December 18, 2013
852

Rene Moser committed
853 854 855 856
* Fixed a few bugs related to unicode
* Fixed errors in the ssh connection method with large data returns
* Miscellaneous fixes for a few modules
* Add the ansible-galaxy command
857

858
## 1.4.1 "Could This Be Magic" - November 27, 2013
859 860 861

* Misc fixes to accelerate mode and various modules.

862
## 1.4 "Could This Be Magic" - November 21, 2013
Michael DeHaan committed
863 864 865

Highlighted new features:

866
* Added do-until feature, which can be used to retry a failed task a specified number of times with a delay in-between the retries.
867
* Added failed_when option for tasks, which can be used to specify logical statements that make it easier to determine when a task has failed, or to make it easier to ignore certain non-zero return codes for some commands.
868
* Added the "subelement" lookup plugin, which allows iteration of the keys of a dictionary or items in a list.
869
* Added the capability to use either paramiko or ssh for the initial setup connection of an accelerated playbook.
870
* Automatically provide advice on common parser errors users encounter.
871 872 873 874
* Deprecation warnings are now shown for legacy features: when_integer/etc, only_if, include+with_items, etc.  Can be disabled in ansible.cfg
* The system will now provide helpful tips around possible YAML syntax errors increasing ease of use for new users.
* warnings are now shown for using {{ foo }} in loops and conditionals, and suggest leaving the variable expressions bare as per docs.
* The roles search path is now configurable in ansible.cfg.  'roles_path' in the config setting.
875
* Includes with parameters can now be done like roles for consistency:  - { include: song.yml, year:1984, song:'jump' }
876
* The name of each role is now shown before each task if roles are being used
877
* Adds a "var=" option to the debug module for debugging variable data.  "debug: var=hostvars['hostname']" and "debug: var=foo" are all valid syntax.
Michael DeHaan committed
878
* Variables in {{ format }} can be used as references even if they are structured data
879
* Can force binding of accelerate to ipv6 ports.
880 881 882
* the apt module will auto-install python-apt if not present rather than requiring a manual installation
* the copy module is now recursive if the local 'src' parameter is a directory.
* syntax checks now scan included task and variable files as well as main files
883

884
New modules and plugins.
Michael DeHaan committed
885

886 887 888 889 890 891 892 893 894
* cloud: ec2_eip -- manage AWS elastic IPs
* cloud: ec2_vpc -- manage ec2 virtual private clouds
* cloud: elasticcache -- Manages clusters in Amazon Elasticache
* cloud: rax_network -- sets up Rackspace networks
* cloud: rax_facts: retrieve facts about a Rackspace Cloud Server
* cloud: rax_clb_nodes -- manage Rackspace cloud load balanced nodes
* cloud: rax_clb -- manages Rackspace cloud load balancers
* cloud: docker - instantiates/removes/manages docker containers
* cloud: ovirt -- VM lifecycle controls for ovirt
895
* files: acl -- set or get acls on a file
896
* files: unarchive: pushes and extracts tarballs
Michael DeHaan committed
897
* files: synchronize: a useful wraper around rsyncing trees of files
James Cammarata committed
898
* system: firewalld -- manage the firewalld configuration
899
* system: modprobe -- manage kernel modules on systems that support modprobe/rmmod
900
* system: open_iscsi -- manage targets on an initiator using open-iscsi
901 902
* system: blacklist: add or remove modules from the kernel blacklist
* system: hostname - sets the systems hostname
Michael DeHaan committed
903
* utilities: include_vars -- dynamically load variables based on conditions.
904 905 906 907 908 909 910
* packaging: zypper_repository - adds or removes Zypper repositories
* packaging: urpmi - work with urpmi packages
* packaging: swdepot - a module for working with swdepot
* notification: grove - notifies to Grove hosted IRC channels
* web_infrastructure: ejabberd_user: add and remove users to ejabberd
* web_infrastructure: jboss: deploys or undeploys apps to jboss
* source_control: github_hooks: manages GitHub service hooks 
911
* net_infrastructure: bigip_monitor_http: manages F5 BIG-IP LTM http monitors
912 913 914 915 916
* net_infrastructure: bigip_monitor_tcp: manages F5 BIG-IP LTM TCP monitors
* net_infrastructure: bigip_pool_member: manages F5 BIG-IP LTM pool members
* net_infrastructure: bigip_node: manages F5 BIG-IP LTM nodes
* net_infrastructure: openvswitch_port
* net_infrastructure: openvswitch_bridge
Michael DeHaan committed
917

918 919 920 921 922 923 924 925
Plugins:

* jail connection module (FreeBSD)
* lxc connection module
* added inventory script for listing FreeBSD jails 
* added md5 as a Jinja2 filter:  {{ path | md5 }}
* added a fileglob filter that will return files matching a glob pattern.  with_items: "/foo/pattern/*.txt | fileglob"
* 'changed' filter returns whether a previous step was changed easier.  when: registered_result | changed
926 927 928
* DOCS NEEDED: 'unique' and 'intersect' filters are added for dealing with lists.
* DOCS NEEDED: new lookup plugin added for etcd
* a 'func' connection type to help people migrating from func/certmaster.
929

930
Misc changes (all module additions/fixes may not listed):
Michael DeHaan committed
931

932
* (docs pending) New features for accelerate mode: configurable timeouts and a keepalives for long running tasks.
933
* Added a `delimiter` field to the assemble module.
934 935
* Added `ansible_env` to the list of facts returned by the setup module.
* Added `state=touch` to the file module, which functions similarly to the command-line version of `touch`.
936
* Added a -vvvv level, which will show SSH client debugging information in the event of a failure.
937
* Includes now support the more standard syntax, similar to that of role includes and dependencies. 
Michael DeHaan committed
938
* Changed the `user:` parameter on plays to `remote_user:` to prevent confusion with the module of the same name.  Still backwards compatible on play parameters.
939
* Added parameter to allow the fetch module to skip the md5 validation step ('validate_md5=false'). This is useful when fetching files that are actively being written to, such as live log files.
940 941
* Inventory hosts are used in the order they appear in the inventory.
* in hosts: foo[2-5] type syntax, the iterators now are zero indexed and the last index is non-inclusive, to match Python standards.
942
* There is now a way for a callback plugin to disable itself.  See osx_say example code for an example.
943 944
* Many bugfixes to modules of all types.
* Complex arguments now can be used with async tasks
945
* SSH ControlPath is now configurable in ansible.cfg.  There is a limit to the lengths of these paths, see how to shorten them in ansible.cfg.
946 947 948 949 950
* md5sum support on AIX with csum.
* Extremely large documentation refactor into subchapters
* Added 'append_privs' option to the mysql_user module
* Can now update (temporarily change) host variables using the "add_host" module for existing hosts.
* Fixes for IPv6 addresses in inventory text files
Michael DeHaan committed
951 952
* name of executable can be passed to pip/gem etc, for installing under *different* interpreters
* copy of ./hacking/env-setup added for fish users, ./hacking/env-setup.fish
953 954 955
* file module more tolerant of non-absolute paths in softlinks.
* miscellaneous fixes/upgrades to async polling logic.
* conditions on roles now pass to dependent roles
956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971
* ansible_sudo_pass can be set in a host variable if desired
* misc fixes for the pip an easy_install modules
* support for running handlers that have parameterized names based on role parameters
* added support for compressing MySQL dumps and extracting during import
* Boto version compatibility fixes for the EC2 inventory script
* in the EC2 inventory script, a group 'EC2' and 'RDS' contains EC2 and RDS hosts.
* umask is enforced by the cron module
* apt packages that are not-removed and not-upgraded do not count as changes
* the assemble module can now use src files from the local server and copy them over dynamically
* authorization code has been standardized between Amazon cloud modules
* the wait_for module can now also wait for files to exist or a regex string to exist in a file
* leading ranges are now allowed in ranged hostname patterns, ex: [000-250].example.com
* pager support added to ansible-doc (so it will auto-invoke less, etc)
* misc fixes to the cron module
* get_url module now understands content-disposition headers for deciding filenames
* it is possible to have subdirectories in between group_vars/ and host_vars/ and the final filename, like host_vars/rack42/asdf for the variables for host 'asdf'.  The intermediate directories are ignored, and do not put a file in there twice.
Michael DeHaan committed
972

973
## 1.3.4 "Top of the World" (reprise) - October 29, 2013
974

975 976
* Fixed a bug in the copy module, where a filename containing the string "raw" was handled incorrectly
* Fixed a bug in accelerate mode, where copying a zero-length file out would fail
977

978
## 1.3.3 "Top of the World" (reprise) - October 9, 2013
979 980 981

Additional fixes for accelerate mode.

982
## 1.3.2 "Top of the World" (reprise) - September 19th, 2013
983 984

Multiple accelerate mode fixes:
985 986 987 988 989 990 991 992 993

* Make packet reception less greedy, so multiple frames of data are not consumed by one call.
* Adding two timeout values (one for connection and one for data reception timeout).
* Added keepalive packets, so async mode is no longer required for long-running tasks.
* Modified accelerate daemon to use the verbose logging level of the ansible command that started it.
* Fixed bug where accelerate would not work in check-mode.
* Added a -vvvv level, which will show SSH client debugging information in the event of a failure.
* Fixed bug in apt_repository module where the repository cache was not being updated.
* Fixed bug where "too many open files" errors would be encountered due to pseudo TTY's not being closed properly.
994

995
## 1.3.1 "Top of the World" (reprise) - September 16th, 2013
996 997 998

Fixing a bug in accelerate mode whereby the gather_facts step would always be run via sudo regardless of the play settings.

999
## 1.3 "Top of the World" - September 13th, 2013
1000

Michael DeHaan committed
1001
Highlighted new features:
1002

1003 1004
* accelerated mode: An enhanced fireball mode that requires zero bootstrapping and fewer requirements plus adds capabilities like sudo commands.
* role defaults: Allows roles to define a set of variables at the lowest priority. These variables can be overridden by any other variable.
1005 1006 1007 1008
* new /etc/ansible/facts.d allows JSON or INI-style facts to be provided from the remote node, and supports executable fact programs in this dir. Files must end in *.fact.
* added the ability to make undefined template variables raise errors (see ansible.cfg)
* (DOCS PENDING) sudo: True/False and sudo_user: True/False can be set at include and role level
* added changed_when: (expression) which allows overriding whether a result is changed or not and can work with registered expressions
1009
* --extra-vars can now take a file as input, e.g., "-e @filename" and can also be formatted as YAML
1010
* external inventory scripts may now return host variables in one pass, which allows them to be much more efficient for large numbers of hosts
1011 1012 1013
* if --forks exceeds the numbers of hosts, it will be automatically reduced. Set forks to 0 and you get "as many forks as I have hosts" out of the box.
* enabled error_on_undefined_vars by default, which will make errors in playbooks more obvious
* role dependencies -- one role can now pull in another, with parameters of its own.
1014 1015
* added the ability to have tasks execute even during a check run (always_run).
* added the ability to set the maximum failure percentage for a group of hosts.
1016 1017 1018

New modules:

Michael DeHaan committed
1019
* notifications: datadog_event -- send data to datadog
1020 1021 1022
* cloud: digital_ocean -- module for DigitalOcean provisioning that also includes inventory support
* cloud: rds -- Amazon Relational Database Service
* cloud: linode -- modules for Linode provisioning that also includes inventory support
Michael DeHaan committed
1023
* cloud: route53 -- manage Amazon DNS entries 
1024
* cloud: ec2_ami -- manages (and creates!) ec2 AMIs
1025 1026 1027
* database: mysql_replication -- manages mysql replication settings for masters/slaves
* database: mysql_variables -- manages mysql runtime variables
* database: redis -- manages redis databases (slave mode and flushing data)
Michael DeHaan committed
1028 1029 1030 1031
* net_infrastructure: arista_interface
* net_infrastructure: arista_lag
* net_infrastructure: arista_l2interface
* net_infrastructure: arista_vlan
Michael DeHaan committed
1032
* system: stat -- reports on stat(istics) of remote files, for use with 'register'
Michael DeHaan committed
1033 1034
* web_infrastructure: htpasswd -- manipulate htpasswd files
* packaging: rpm_key -- adds or removes RPM signing keys
1035
* packaging: apt_repository -- rewritten to remove dependencies 
Michael DeHaan committed
1036
* monitoring: boundary_meter -- adds or removes boundary.com meters
1037
* net_infrastructure: dnsmadeeasy - manipulate DNS Made Easy records
1038
* files: xattr -- manages extended attributes on files
1039 1040 1041

Misc changes:

1042
* return 3 when there are hosts that were unreachable during a run
1043 1044 1045
* the yum module now supports wildcard values for the enablerepo argument
* added an inventory script to pull host information from Zabbix
* async mode no longer allows with_* lookup plugins due to incompatibilities
1046 1047 1048
* Added OpenRC support (Gentoo) to the service module
* ansible_ssh_user value is available to templates
* added placement_group parameter to ec2 module
1049
* new sha256sum parameter added to get_url module for checksum validation
1050 1051 1052 1053
* search for mount binaries in system path and sbin vs assuming path
* allowed inventory file to be read from a pipe
* added Solaris distribution facts
* fixed bug along error path in quantum_network module
1054
* user password update mode is controllable in user module now (at creation vs. every time)
1055 1056 1057 1058 1059
* added check mode support to the OpenBSD package module
* Fix for MySQL 5.6 compatibility
* HP UX virtualization facts
* fixed some executable bits in git
* made rhn_register module compatible with EL5
1060 1061 1062 1063
* fix for setup module epoch time on Solaris
* sudo_user is now expanded later, allowing it to be set at inventory scope
* mongodb_user module changed to also support MongoDB 2.2
* new state=hard option added to the file module for hardlinks vs softlinks
Michael DeHaan committed
1064 1065
* fixes to apt module purging option behavior
* fixes for device facts with multiple PCI domains
1066
* added "with_inventory_hostnames" lookup plugin, which can take a pattern and loop over hostnames matching the pattern and is great for use with delegate_to and so on
Michael DeHaan committed
1067
* ec2 module supports adding to multiple security groups
1068
* cloudformation module includes fixes for the error path, and the 'wait_for' parameter was removed
Michael DeHaan committed
1069 1070 1071 1072 1073 1074 1075 1076 1077
* added --only-if-changed to ansible-pull, which runs only if the repo has changes (not default)
* added 'mandatory', a Jinja2 filter that checks if a variable is defined: {{ foo|mandatory }}
* added support for multiple size formats to the lvol module
* timing reporting on wait_for module now includes the delay time
* IRC module can now send a server password
* "~" now expanded on each component of configured plugin paths
* fix for easy_install module when dealing with virtualenv
* rackspace module now explicitly indicates rackspace vs vanilla openstack
* add_host module does not report changed=True any longer
1078
* explanatory error message when using fireball with sudo has been improved
Michael DeHaan committed
1079
* git module now automatically pulls down git submodules
1080
* negated patterns do not require "all:!foo", you can just say "!foo" now to select all not foos
Michael DeHaan committed
1081
* fix for Debian services always reporting changed when toggling enablement bit
1082
* roles files now tolerate files named 'main.yaml' and 'main' in addition to main.yml
Michael DeHaan committed
1083
* some help cleanup to command line flags on scripts
1084
* force option reinstated for file module so it can create symlinks to non-existent files, etc.
Michael DeHaan committed
1085 1086
* added termination support to ec2 module
* --ask-sudo-pass or --sudo-user does not enable all options to use sudo in ansible-playbook
Michael DeHaan committed
1087 1088 1089 1090 1091
* include/role conditionals are added ahead of task conditionals so they can short circuit properly
* added pipes.quote in various places so paths with spaces are better tolerated
* error handling while executing Jinja2 filters has been improved
* upgrades to atomic replacement logic when copying files across partitions/etc
* mysql user module can try to login before requiring explicit password
1092
* various additional options added to supervisorctl module
Michael DeHaan committed
1093
* only add non unique parameter on group creation when required
1094 1095
* allow rabbitmq_plugin to specify a non-standard RabbitMQ path
* authentication fixes to keystone_user module
Michael DeHaan committed
1096 1097 1098
* added IAM role support to EC2 module
* fixes for OpenBSD package module to avoid shell expansion
* git module upgrades to allow --depth and --version to be used together
1099
* new lookup plugin, "with_flattened"
Michael DeHaan committed
1100 1101 1102
* extra vars (-e) variables can be used in playbook include paths
* improved reporting for invalid sudo passwords
* improved reporting for inability to find a suitable tmp location
1103
* require libselinux-python to perform file operations if SELinux is operational
Michael DeHaan committed
1104 1105 1106 1107 1108 1109 1110 1111 1112 1113
* ZFS module fixes for byte display constants and handling paths with spaces
* setup module more tolerant of gathering facts against things it does not have permission to read
* can specify name=* state=latest to update all yum modules
* major speedups to the yum module for default cases
* ec2_facts module will now run in check mode
* sleep option on service module for sleeping between stop/restart
* fix for IPv6 facts on BSD
* added Jinja2 filters: skipped, whether a result was skipped
* added Jinja2 filters: quote, quotes a string if it needs to be quoted
* allow force=yes to affect apt upgrades
1114
* fix for saving conditionals in variable names
1115
* support for multiple host ranges in INI inventory, e.g., db[01:10:3]node-[01:10]
Michael DeHaan committed
1116
* fixes/improvements to cron module
Michael DeHaan committed
1117
* add user_install=no option to gem module to install gems system wide
Michael DeHaan committed
1118
* added raw=yes to allow copying without python on remote machines
Michael DeHaan committed
1119 1120 1121 1122
* added with_indexed_items lookup plugin
* Linode inventory plugin now significantly faster
* added recurse=yes parameter to pacman module for package removal
* apt_key module can now target specific keyrings (keyring=filename)
1123
* ec2 module change reporting improved
Michael DeHaan committed
1124
* hg module now expands user paths (~)
1125
* SSH connection type known host checking now can process hashed known_host files
Michael DeHaan committed
1126
* lvg module now checks for executables in more correct locations
1127
* copy module now works correctly with sudo_user
Michael DeHaan committed
1128
* region parameter added to ec2_elb module
1129 1130
* better default XMPP module message types
* fixed conditional tests against raw booleans
Michael DeHaan committed
1131
* mysql module grant removal is now smarter
1132 1133 1134 1135
* apt-remove is now forced to be non-interactive
* support ; comments in INI file module
* fixes to callbacks WRT async output (fire and forget tasks now trigger callbacks!)
* folder support for s3 module
Michael DeHaan committed
1136
* added new example inventory plugin for Red Hat OpenShift
1137
* and other misc. bugfixes
1138

1139
## 1.2.3 "Hear About It Later" (reprise) -- Aug 21, 2013
Michael DeHaan committed
1140 1141 1142 1143

* Local security fixes for predictable file locations for ControlPersist and retry file paths on shared machines
on operating systems without kernel symlink/hardlink protections.

1144
## 1.2.2 "Hear About It Later" (reprise) -- July 4, 2013
Michael DeHaan committed
1145 1146 1147 1148 1149 1150 1151

* Added a configuration file option [paramiko_connection] record_host_keys which allows the code that paramiko uses
to update known_hosts to be disabled.  This is done because paramiko can be very slow at doing this if you have a
large number of hosts and some folks may not want this behavior.  This can be toggled independently of host key checking
and does not affect the ssh transport plugin.  Use of the ssh transport plugin is preferred if you have ControlPersist
capability, and Ansible by default in 1.2.1 and later will autodetect.

1152
## 1.2.1 "Hear About It Later" -- July 4, 2013
1153 1154 1155 1156 1157 1158 1159 1160

* Connection default is now "smart", which discovers if the system openssh can support ControlPersist, and uses
  it if so, if not falls back to paramiko.
* Host key checking is on by default.  Disable it if you like by adding host_key_checking=False in the [default]
  section of /etc/ansible/ansible.cfg or ~/ansible.cfg or by exporting ANSIBLE_HOST_KEY_CHECKING=False
* Paramiko now records host keys it was in contact with host key checking is on.  It is somewhat sluggish when doing this,
  so switch to the 'ssh' transport if this concerns you.

1161
## 1.2 "Right Now" -- June 10, 2013
Michael DeHaan committed
1162

Michael DeHaan committed
1163 1164
Core Features:

Michael DeHaan committed
1165 1166 1167
* capability to set 'all_errors_fatal: True' in a playbook to force any error to stop execution versus
  a whole group or serial block needing to fail
  usable, without breaking the ability to override in ansible
1168 1169 1170
* ability to use variables from {{ }} syntax in mainline playbooks, new 'when' conditional, as detailed
  in documentation.  Can disable old style replacements in ansible.cfg if so desired, but are still active
  by default.
1171
* can set ansible_ssh_private_key_file as an inventory variable (similar to ansible_ssh_host, etc)
Michael DeHaan committed
1172 1173
* 'when' statement can be affixed to task includes to auto-affix the conditional to each task therein
* cosmetic: "*****" banners in ansible-playbook output are now constant width
Michael DeHaan committed
1174 1175
* --limit can now be given a filename (--limit @filename) to constrain a run to a host list on disk
* failed playbook runs will create a retry file in /var/tmp/ansible usable with --limit
Michael DeHaan committed
1176
* roles allow easy arrangement of reusable tasks/handlers/files/templates
1177
* pre_tasks and post_tasks allow for separating tasks into blocks where handlers will fire around them automatically
Michael DeHaan committed
1178 1179
* "meta: flush_handler" task capability added for when you really need to force handlers to run
* new --start-at-task option to ansible playbook allows starting at a specific task name in a long playbook
1180
* added a log file for ansible/ansible-playbook, set 'log_path' in the configuration file or ANSIBLE_LOG_PATH in environment
Michael DeHaan committed
1181 1182
* debug mode always outputs debug in playbooks, without needing to specify -v
* external inventory script added for Spacewalk / Red Hat Satellite servers
Michael DeHaan committed
1183
* It is now possible to feed JSON structures to --extra-vars.  Pass in a JSON dictionary/hash to feed in complex data.
Michael DeHaan committed
1184
* group_vars/ and host_vars/ directories can now be kept alongside the playbook as well as inventory (or both!)
1185 1186
* more filters: ability to say {{ foo|success }} and {{ foo|failed }} and when: foo|success and when: foo|failed
* more filters: {{ path|basename }} and {{ path|dirname }}
Michael DeHaan committed
1187
* lookup plugins now use the basedir of the file they have included from, avoiding needs of ../../../ in places and
Michael DeHaan committed
1188
increasing the ease at which things can be reorganized.
Michael DeHaan committed
1189

Michael DeHaan committed
1190
Modules added:
Michael DeHaan committed
1191

Michael DeHaan committed
1192 1193 1194
* cloud: rax: module for creating instances in the rackspace cloud (uses pyrax)
* packages: npm: node.js package management
* packages: pkgng: next-gen package manager for FreeBSD
1195 1196
* packages: redhat_subscription: manage Red Hat subscription usage
* packages: rhn_register: basic RHN registration
Michael DeHaan committed
1197
* packages: zypper (SuSE)
1198
* database: postgresql_priv: manages postgresql privileges
Michael DeHaan committed
1199 1200 1201 1202 1203 1204 1205 1206 1207 1208
* networking: bigip_pool: load balancing with F5s
* networking: ec2_elb: add and remove machines from ec2 elastic load balancers
* notification: hipchat: send notification events to hipchat
* notification: flowdock: send messages to flowdock during playbook runs
* notification: campfire: send messages to campfire during playbook runs
* notification: mqtt: send messages to the Mosquitto message bus
* notification: irc: send messages to IRC channels
* notification: filesystem - a wrapper around mkfs
* notification: jabber: send jabber chat messages
* notification: osx_say: make OS X say things out loud
Michael DeHaan committed
1209 1210 1211 1212 1213 1214 1215 1216 1217
* openstack: keystone_user
* openstack: glance_image
* openstack: nova_compute
* openstack: nova_keypair
* openstack: quantum_floating_ip
* openstack: quantum_floating_ip_associate
* openstack: quantum_network
* openstack: quantum_router
* openstack: quantum_router_gateway
1218
* openstack: quantum_router_interface
Michael DeHaan committed
1219
* openstack: quantum_subnet
Michael DeHaan committed
1220 1221 1222 1223 1224 1225
* monitoring: newrelic_deployment: notifies newrelic of new deployments
* monitoring: airbrake_deployment - notify airbrake of new deployments
* monitoring: pingdom
* monitoring: pagerduty
* monitoring: monit
* utility: set_fact: sets a variable, which can be the result of a template evaluation
Michael DeHaan committed
1226 1227 1228 1229 1230

Modules removed

* vagrant -- can't be compatible with both versions at once, just run things though the vagrant provisioner in vagrant core

Michael DeHaan committed
1231 1232 1233 1234 1235
Bugfixes and Misc Changes:

* service module happier if only enabled=yes|no specified and no state
* mysql_db: use --password= instead of -p in dump/import so it doesn't go interactive if no pass set
* when using -c ssh and the ansible user is the current user, don't pass a -o to allow SSH config to be
1236 1237
* overwrite parameter added to the s3 module
* private_ip parameter added to the ec2 module
Michael DeHaan committed
1238
* $FILE and $PIPE now tolerate unicode
Michael DeHaan committed
1239
* various plugin loading operations have been made more efficient
1240
* hostname now uses platform.node versus socket.gethostname to be more consistent with Unix 'hostname'
Michael DeHaan committed
1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251
* fix for SELinux operations on Unicode path names
* inventory directory locations now ignore files with .ini extensions, making hybrid inventory easier
* copy module in check-mode now reports back correct changed status when used with force=no
* added avail. zone to ec2 module
* fixes to the hash variable merging logic if so enabled in the main settings file (default is to replace, not merge hashes)
* group_vars and host_vars files can now end in a .yaml or .yml extension, (previously required no extension, still favored)
* ec2vol module improvements
* if the user module is told to generate the ssh key, the key generated is now returned in the results
* misc fixes to the Riak module
* make template module slightly more efficient
* base64encode / decode filters are now available to templates
Andrew Murray committed
1252
* libvirt module can now work with multiple different libvirt connection URIs
Michael DeHaan committed
1253 1254
* fix for postgresql password escaping
* unicode fix for shlex.split in some cases
Michael DeHaan committed
1255 1256 1257 1258 1259 1260 1261
* apt module upgrade logic improved
* URI module now can follow redirects
* yum module can now install off http URLs
* sudo password now defaults to ssh password if you ask for both and just hit enter on the second prompt
* validate feature on copy and template module, for example, running visudo prior to copying the file over
* network facts upgraded to return advanced configs (bonding, etc)
* region support added to ec2 module
Michael DeHaan committed
1262 1263 1264
* riak module gets a wait for ring option
* improved check mode support in the file module
* exception handling added to handle scenario when attempt to log to systemd journal fails
Michael DeHaan committed
1265 1266 1267
* fix for upstart handling when toggling the enablement and running bits at the same time
* when registering a task with a conditional attached, and the task is skipped by the conditional,
the variable is still registered for the host, with the attribute skipped: True.
Michael DeHaan committed
1268 1269 1270 1271 1272 1273
* delegate_to tasks can look up ansible_ssh_private_key_file variable from inventory correctly now
* s3 module takes a 'dest' parameter to change the destination for uploads
* apt module gets a cache_valid_time option to avoid redundant cache updates
* ec2 module better understands security groups
* fix for postgresql codec usage
* setup module now tolerant of OpenVZ interfaces
1274 1275 1276 1277 1278 1279
* check mode reporting improved for files and directories
* doc system now reports on module requirements
* group_by module can now also make use of globally scoped variables
* localhost and 127.0.0.1 are now fuzzy matched in inventory (are now more or less interchangeable)
* AIX improvements/fixes for users, groups, facts
* lineinfile now does atomic file replacements
1280 1281
* fix to not pass PasswordAuthentication=no in the config file unnecessarily for SSH connection type
* for authorized_key on Debian Squeeze
Michael DeHaan committed
1282 1283 1284 1285 1286
* fixes for apt_repository module reporting changed incorrectly on certain repository types
* allow the virtualenv argument to the pip module to be a pathname
* service pattern argument now correctly read for BSD services
* fetch location can now be controlled more directly via the 'flat' parameter.
* added basename and dirname as Jinja2 filters available to all templates
1287
* pip works better when sudoing from unprivileged users
Michael DeHaan committed
1288 1289
* fix for user creation with groups specification reporting 'changed' incorrectly in some cases
* fix for some unicode encoding errors in outputing some data in verbose mode
1290
* improved FreeBSD, NetBSD and Solaris facts
Michael DeHaan committed
1291
* debug module always outputs data without having to specify -v
Michael DeHaan committed
1292
* fix for sysctl module creating new keys (must specify checks=none)
Michael DeHaan committed
1293
* NetBSD and OpenBSD support for the user and groups modules
Maykel Moya committed
1294
* Add encrypted password support to password lookup
Michael DeHaan committed
1295

1296
## 1.1 "Mean Street" -- 4/2/2013
1297

Michael DeHaan committed
1298 1299
Core Features

Michael DeHaan committed
1300
* added --check option for "dry run" mode
Michael DeHaan committed
1301
* added --diff option to show how templates or copied files change, or might change
Michael DeHaan committed
1302 1303 1304 1305 1306 1307 1308
* --list-tasks for the playbook will list the tasks without running them
* able to set the environment by setting "environment:" as a dictionary on any task (go proxy support!)
* added ansible_ssh_user and ansible_ssh_pass for per-host/group username and password
* jinja2 extensions can now be loaded from the config file
* support for complex arguments to modules (within reason)
* can specify ansible_connection=X to define the connection type in inventory variables
* a new chroot connection type
Michael DeHaan committed
1309
* module common code now has basic type checking (and casting) capability
Michael DeHaan committed
1310
* module common now supports a 'no_log' attribute to mark a field as not to be syslogged
1311
* inventory can now point to a directory containing multiple scripts/hosts files, if using this, put group_vars/host_vars directories inside this directory
Michael DeHaan committed
1312 1313
* added configurable crypt scheme for 'vars_prompt'
* password generating lookup plugin -- $PASSWORD(path/to/save/data/in)
1314
* added --step option to ansible-playbook, works just like Linux interactive startup!
Michael DeHaan committed
1315 1316 1317

Modules Added:

Michael DeHaan committed
1318 1319 1320 1321
* bzr (bazaar version control)
* cloudformation
* django-manage
* gem (ruby gems)
1322
* homebrew
Michael DeHaan committed
1323
* lvg (logical volume groups)
1324
* lvol (LVM logical volumes)
Michael DeHaan committed
1325 1326
* macports
* mongodb_user
Michael DeHaan committed
1327
* netscaler
Michael DeHaan committed
1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338
* okg
* openbsd_pkg
* rabbit_mq_plugin
* rabbit_mq_user
* rabbit_mq_vhost
* rabbit_mq_parameter
* rhn_channel
* s3 -- allows putting file contents in buckets for sharing over s3
* uri module -- can get/put/post/etc
* vagrant -- launching VMs with vagrant, this is different from existing vagrant plugin
* zfs
Michael DeHaan committed
1339 1340 1341

Bugfixes and Misc Changes:

Michael DeHaan committed
1342 1343
* stderr shown when commands fail to parse
* uses yaml.safe_dump in filter plugins
Michael DeHaan committed
1344
* authentication Q&A no longer happens before --syntax-check, but after
Michael DeHaan committed
1345 1346 1347 1348 1349
* ability to get hostvars data for nodes not in the setup cache yet
* SSH timeout now correctly passed to native SSH connection plugin
* raise an error when multiple when_ statements are provided
* --list-hosts applies host limit selections better
* (internals) template engine specifications to use template_ds everywhere
1350
* better error message when your host file can not be found
Michael DeHaan committed
1351 1352 1353 1354 1355
* end of line comments now work in the inventory file
* directory destinations now work better with remote md5 code
* lookup plugin macros like $FILE and $ENV now work without returning arrays in variable definitions/playbooks
* uses yaml.safe_load everywhere
* able to add EXAMPLES to documentation via EXAMPLES docstring, rather than just in main documentation YAML
1356 1357 1358 1359 1360
* can set ANSIBLE_COW_SELECTION to pick other cowsay types (including random)
* to_nice_yaml and to_nice_json available as Jinja2 filters that indent and sort
* cowsay able to run out of macports (very important!)
* improved logging for fireball mode
* nicer error message when talking to an older system that needs a JSON module installed
1361
* 'magic' variable 'inventory_dir' now gives path to inventory file
Michael DeHaan committed
1362 1363
* 'magic' variable 'vars' works like 'hostvars' but gives global scope variables, useful for debugging in templates mostly
* conditionals can be used on plugins like add_host
1364
* developers: all callbacks now have access to a ".runner" and ".playbook", ".play", and ".task" object (use getattr, they may not always be set!)
Michael DeHaan committed
1365 1366 1367

Facts:

1368
* block device facts for the setup module
Michael DeHaan committed
1369 1370
* facts for AIX
* fact detection for OS type on Amazon Linux
Michael DeHaan committed
1371 1372
* device fact gathering stability improvements
* ansible_os_family fact added
1373 1374
* user_id (remote user name)
* a whole series of current time information under the 'datetime' hash
Michael DeHaan committed
1375 1376
* more OS X facts
* support for detecting Alpine Linux
1377
* added facts for OpenBSD
Michael DeHaan committed
1378 1379 1380

Module Changes/Fixes:

Michael DeHaan committed
1381 1382 1383
* ansible module common code (and ONLY that) which is mixed in with modules, is now BSD licensed.  App remains GPLv3.
* service code works better on platforms that mix upstart, systemd, and system-v
* service enablement idempotence fixes for systemd and upstart
Michael DeHaan committed
1384 1385 1386 1387 1388 1389 1390
* service status 4 is also 'not running'
* supervisorctl restart fix
* increased error handling for ec2 module
* can recursively set permissions on directories
* ec2: change to the way AMI tags are handled
* cron module can now also manipulate cron.d files
* virtualenv module can now inherit system site packages (or not)
Michael DeHaan committed
1391 1392 1393 1394
* lineinfile module now has an insertbefore option
* NetBSD service module support
* fixes to sysctl module where item has multiple values
* AIX support for the user and group modules
Michael DeHaan committed
1395
* able to specify a different hg repo to pull from than the original set
1396 1397
* add_host module can set ports and other inventory variables
* add_host module can add modules to multiple groups (groups=a,b,c), groups now alias for groupname
1398 1399 1400 1401 1402
* subnet ID can be set on EC2 module
* MySQL module password handling improvements
* added new virtualenv flags to pip and easy_install modules
* various improvements to lineinfile module, now accepts common arguments from file
* force= now replaces thirsty where used before, thirsty remains an alias
Michael DeHaan committed
1403
* setup module can take a 'filter=<wildcard>' parameter to just return a few facts (not used by playbooks)
1404 1405 1406 1407 1408 1409
* cron module works even if no crontab is present (for cron.d)
* security group ID settable on EC2 module
* misc fixes to sysctl module
* fix to apt module so packages not in cache are still removable
* charset fix to mail module
* postresql db module now does not try to create the 'PUBLIC' user
Michael DeHaan committed
1410
* SVN module now works correctly with self signed certs
1411
* apt module now has an upgrade parameter (values=yes, no, or 'dist')
Michael DeHaan committed
1412 1413 1414 1415 1416
* nagios module gets new silence/unsilence commands
* ability to disable proxy usage in get_url (use_proxy=no)
* more OS X facts
* added a 'fail_on_missing' (default no) option to fetch
* added timeout to the uri module (default 30 seconds, adjustable)
1417
* ec2 now has a 'wait' parameter to wait for the instance to be active, eliminates need for separate wait_for call.
Michael DeHaan committed
1418
* allow regex backreferences in lineinfile
1419 1420 1421 1422 1423
* id attribute on ec2 module can be used to set idempotent-do-not-recreate launches
* icinga support for nagios module
* fix default logins when no my.conf for MySQL module
* option to create users with non-unique UIDs (user module)
* macports module can enable/disable packages
Michael DeHaan committed
1424 1425 1426 1427
* quotes in my.cnf are stripped by the MySQL modules
* Solaris Service management added
* service module will attempt to auto-add unmanaged chkconfig services when needed
* service module supports systemd service unit files
Michael DeHaan committed
1428 1429 1430 1431 1432

Plugins:

* added 'with_random_choice' filter plugin
* fixed ~ expansion for fileglob
1433
* with_nested allows for nested loops (see examples in examples/playbooks)
1434

1435
## 1.0 "Eruption" -- Feb 1 2013
1436

1437 1438
New modules:

1439 1440
* new sysctl module
* new pacman module (Arch linux)
1441 1442 1443 1444 1445 1446 1447
* new apt_key module
* hg module now in core
* new ec2_facts module
* added pkgin module for Joyent SmartOS

New config settings:

1448 1449
* sudo_exe parameter can be set in config to use sudo alternatives
* sudo_flags parameter can alter the flags used with sudo
1450 1451 1452

New playbook/language features:

1453
* added when_failed and when_changed
1454
* task includes can now be of infinite depth
1455
* when_set and when_unset can take more than one var (when_set: $a and $b and $c)
1456
* added the with_sequence lookup plugin
Andrew Murray committed
1457
* can override "connection:" on an individual task
1458 1459 1460
* parameterized playbook includes can now define complex variables (not just all on one line)
* making inventory variables available for use in vars_files paths
* messages when skipping plays are now more clear
Michael DeHaan committed
1461
* --extra-vars now has maximum precedence (as intended)
1462 1463 1464 1465

Module fixes and new flags:

* ability to use raw module without python on remote system
1466 1467 1468
* fix for service status checking on Ubuntu
* service module now responds to additional exit code for SERVICE_UNAVAILABLE
* fix for raw module with '-c local'
1469
* various fixes to git module
1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483
* ec2 module now reports the public DNS name
* can pass executable= to the raw module to specify alternative shells
* fix for postgres module when user contains a "-"
* added additional template variables -- $template_fullpath and $template_run_date
* raise errors on invalid arguments used with a task include statement
* shell/command module takes a executable= parameter to specify a different shell than /bin/sh
* added return code and error output to the raw module
* added support for @reboot to the cron module
* misc fixes to the pip module
* nagios module can schedule downtime for all services on the host
* various subversion module improvements
* various mail module improvements
* SELinux fix for files created by authorized_key module
* "template override" ??
1484 1485 1486
* get_url module can now send user/password authorization
* ec2 module can now deploy multiple simultaneous instances
* fix for apt_key modules stalling in some situations
1487
* fix to enable Jinja2 {% include %} to work again in template
1488 1489
* ec2 module is now powered by Boto
* setup module can now detect if package manager is using pacman
Michael DeHaan committed
1490
* fix for yum module with enablerepo in use on EL 6
1491

1492
Core fixes and new behaviors:
Michael DeHaan committed
1493

1494 1495 1496 1497 1498 1499 1500 1501
* various fixes for variable resolution in playbooks
* fixes for handling of "~" in some paths
* various fixes to DWIM'ing of relative paths
* /bin/ansible now takes a --list-hosts just like ansible-playbook did
* various patterns can now take a regex vs a glob if they start with "~" (need docs on which!) - also /usr/bin/ansible
* allow intersecting host patterns by using "&" ("webservers:!debian:&datacenter1")
* handle tilde shell character for --private-key
* hash merging policy is now selectable in the config file, can choose to override or merge
1502
* environment variables now available for setting all plugin paths (ANSIBLE_CALLBACK_PLUGINS, etc)
Michael DeHaan committed
1503 1504 1505 1506
* added packaging file for macports (not upstreamed yet)
* hacking/test-module script now uses /usr/bin/env properly
* fixed error formatting for certain classes of playbook syntax errors
* fix for processing returns with large volumes of output
1507 1508 1509 1510 1511 1512

Inventory files/scripts:

* hostname patterns in the inventory file can now use alphabetic ranges
* whitespace is now allowed around group variables in the inventory file
* inventory scripts can now define groups of groups and group vars (need example for docs?)
Michael DeHaan committed
1513

1514
## 0.9 "Dreams" -- Nov 30 2012
1515

Michael DeHaan committed
1516 1517
Highlighted core changes:

Michael DeHaan committed
1518
* various performance tweaks, ansible executes dramatically less SSH ops per unit of work
Michael DeHaan committed
1519 1520
* close paramiko SFTP connections less often on copy/template operations (speed increase)
* change the way we use multiprocessing (speed/RAM usage improvements)
Michael DeHaan committed
1521 1522 1523 1524 1525
* able to set default for asking password & sudo password in config file
* ansible now installs nicely if running inside a virtualenv
* flag to allow SSH connection to move files by scp vs sftp (in config file)
* additional RPM subpackages for easily installing fireball mode deps (server and node)
* group_vars/host_vars now available to ansible, not just playbooks
Michael DeHaan committed
1526
* native ssh connection type (-c ssh) now supports passwords as well as keys
Michael DeHaan committed
1527
* ansible-doc program to show details
Michael DeHaan committed
1528 1529 1530 1531

Other core changes:

* fix for template calls when last character is '$'
Michael DeHaan committed
1532
* if ansible_python_interpreter is set on a delegated host, it now works as intended
Jim Kleckner committed
1533
* --limit can now take "," as separator as well as ";" or ":"
Michael DeHaan committed
1534
* msg is now displaced with newlines when a task fails
Michael DeHaan committed
1535
* if any with_ plugin has no results in a list (empty list for with_items, etc), the task is now skipped
Michael DeHaan committed
1536 1537 1538
* various output formatting fixes/improvements
* fix for Xen dom0/domU detection in default facts
* 'ansible_domain' fact now available (ex value: example.com)
Michael DeHaan committed
1539
* configured remote temp file location is now always used even for root
1540 1541 1542 1543 1544 1545
* 'register'-ed variables are not recorded for skipped hosts (for example, using only_if/when)
* duplicate host records for the same host can no longer result when a host is listed in multiple groups
* ansible-pull now passes --limit to prevent running on multiple hosts when used with generic playbooks
* remote md5sum check fixes for Solaris 10
* ability to configure syslog facility used by remote module calls
* in templating, stray '$' characters are now handled more correctly
Michael DeHaan committed
1546 1547 1548 1549 1550

Playbook changes:

* relative paths now work for 'first_available_file'
* various templating engine fixes
1551
* 'when' is an easier form of only if
1552 1553
* --list-hosts on the playbook command now supports multiple playbooks on the same command line
* playbook includes can now be parameterized
Michael DeHaan committed
1554 1555 1556 1557 1558 1559 1560 1561 1562

Module additions:

* (addhost) new module for adding a temporary host record (used for creating new guests)
* (group_by) module allows partitioning hosts based on group data
* (ec2) new module for creating ec2 hosts
* (script) added 'script' module for pushing and running self-deleting remote scripts
* (svr4pkg) solaris svr4pkg module

Michael DeHaan committed
1563
Module changes:
Michael DeHaan committed
1564 1565

* (authorized key) module uses temp file now to prevent failure on full disk
1566 1567
* (fetch) now uses the 'slurp' internal code to work as you would expect under sudo'ed accounts
* (fetch) internal usage of md5 sums fixed for BSD
Michael DeHaan committed
1568 1569
* (get_url) thirsty is no longer required for directory destinations
* (git) various git module improvements/tweaks
1570
* (group) now subclassed for various platforms, includes SunOS support
Michael DeHaan committed
1571
* (lineinfile) create= option on lineinfile can create the file when it does not exist
Michael DeHaan committed
1572
* (mysql_db) module takes new grant options
Michael DeHaan committed
1573 1574 1575
* (postgresql_db) module now takes role_attr_flags
* (service) further upgrades to service module service status reporting
* (service) tweaks to get service module to play nice with BSD style service systems (rc.conf)
1576
* (service) possible to pass additional arguments to services
Michael DeHaan committed
1577 1578 1579 1580 1581 1582 1583 1584 1585 1586
* (shell) and command module now take an 'executable=' flag for specifying an alternate shell than /bin/sh
* (user) ability to create SSH keys for users when using user module to create users
* (user) atomic replacement of files preserves permissions of original file
* (user) module can create SSH keys
* (user) module now does Solaris and BSD
* (yum) module takes enablerepo= and disablerepo=
* (yum) misc yum module fixing for various corner cases

Plugin changes:

Michael DeHaan committed
1587 1588
* EC2 inventory script now produces nicer failure message if AWS is down (or similar)
* plugin loading code now more streamlined
Michael DeHaan committed
1589
* lookup plugins for DNS text records, environment variables, and redis
1590
* added a template lookup plugin $TEMPLATE('filename.j2')
Michael DeHaan committed
1591
* various tweaks to the EC2 inventory plugin
Michael DeHaan committed
1592
* jinja2 filters are now pluggable so it's easy to write your own (to_json/etc, are now impl. as such)
1593

1594
## 0.8 "Cathedral" -- Oct 19, 2012
Michael DeHaan committed
1595

Michael DeHaan committed
1596
Highlighted Core Changes:
Michael DeHaan committed
1597

Michael DeHaan committed
1598 1599
* fireball mode -- ansible can bootstrap a ephemeral 0mq (zeromq) daemon that runs as a given user and expires after X period of time.  It is very fast.
* playbooks with errors now return 2 on failure.  1 indicates a more fatal syntax error.  Similar for /usr/bin/ansible
Michael DeHaan committed
1600
* server side action code (template, etc) are now fully pluggable
1601
* ability to write lookup plugins, like the code powering "with_fileglob" (see below)
Michael DeHaan committed
1602 1603 1604

Other Core Changes:

1605
* ansible config file can also go in 'ansible.cfg' in cwd in addition to ~/.ansible.cfg and /etc/ansible/ansible.cfg
Michael DeHaan committed
1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616
* fix for inventory hosts at API level when hosts spec is a list and not a colon delimited string
* ansible-pull example now sets up logrotate for the ansible-pull cron job log
* negative host matching (!hosts) fixed for external inventory script usage
* internals: os.executable check replaced with utils function so it plays nice on AIX
* Debian packaging now includes ansible-pull manpage
* magic variable 'ansible_ssh_host' can override the hostname (great for usage with tunnels)
* date command usage in build scripts fixed for OS X
* don't use SSH agent with paramiko if a password is specified
* make output be cleaner on multi-line command/shell errors
* /usr/bin/ansible now prints things when tasks are skipped, like when creates= is used with -m command and /usr/bin/ansible
* when trying to async a module that is not a 'normal' asyncable module, ansible will now let you know
Michael DeHaan committed
1617 1618 1619
* ability to access inventory variables via 'hostvars' for hosts not yet included in any play, using on demand lookups
* merged ansible-plugins, ansible-resources, and ansible-docs into the main project
* you can set ANSIBLE_NOCOWS=1 if you want to disable cowsay if it is installed.  Though no one should ever want to do this!  Cows are great!
Ferenc Grecu committed
1620
* you can set ANSIBLE_FORCE_COLOR=1 to force color mode even when running without a TTY
Michael DeHaan committed
1621 1622 1623
* fatal errors are now properly colored red.
* skipped messages are now cyan, to differentiate them from unchanged messages.
* extensive documentation upgrades
Michael DeHaan committed
1624
* delegate_action to localhost (aka local_action) will always use the local connection type
Michael DeHaan committed
1625

Michael DeHaan committed
1626
Highlighted playbook changes:
Michael DeHaan committed
1627

Michael DeHaan committed
1628 1629
* is_set is available for use inside of an only_if expression:  is_set('ansible_eth0').  We intend to further upgrade this with a 'when'
  keyword providing better options to 'only_if' in the next release.   Also is_unset('ansible_eth0')
Michael DeHaan committed
1630
* playbooks can import playbooks in other directories and then be able to import tasks relative to them
Michael DeHaan committed
1631 1632
* FILE($path) now allows access of contents of file in a path, very good for use with SSH keys
* similarly PIPE($command) will run a local command and return the results of executing this command
Michael DeHaan committed
1633 1634 1635 1636 1637
* if all hosts in a play fail, stop the playbook, rather than letting the console log spool on by
* only_if using register variables that are booleans now works in a boolean way like you'd expect
* task includes now work with with_items (such as: include: path/to/wordpress.yml user=$item)
* when using a $list variable with $var or ${var} syntax it will automatically join with commas
* setup is not run more than once when we know it is has already been run in a play that included another play, etc
Michael DeHaan committed
1638
* can set/override sudo and sudo_user on individual tasks in a play, defaults to what is set in the play if not present
1639
* ability to use with_fileglob to iterate over local file patterns
Michael DeHaan committed
1640 1641
* templates now use Jinja2's 'trim_blocks=True' to avoid stray newlines, small changes to templates may
be required in rare cases.
Michael DeHaan committed
1642 1643 1644 1645 1646 1647

Other playbook changes:

* to_yaml and from_yaml are available as Jinja2 filters
* $group and $group_names are now accessible in with_items
* where 'stdout' is provided a new 'stdout_lines' variable (type == list) is now generated and usable with with_items
Michael DeHaan committed
1648
* when local_action is used the transport is automatically overridden to the local type
Michael DeHaan committed
1649 1650 1651 1652
* output on failed playbook commands is now nicely split for stderr/stdout and syntax errors
* if local_action is not used and delegate_to was 127.0.0.1 or localhost, use local connection regardless
* when running a playbook, and the statement has changed, prints 'changed:' now versus 'ok:' so it is obvious without colored mode
* variables now usable within vars_prompt (just not host/group vars)
Michael DeHaan committed
1653 1654 1655 1656
* setup facts are now retained across plays (dictionary just gets updated as needed)
* --sudo-user now works with --extra-vars
* fix for multi_line strings with only_if

Michael DeHaan committed
1657 1658 1659 1660 1661 1662 1663 1664 1665 1666
New Modules:

* ini_file module for manipulating INI files
* new LSB facts (release, distro, etc)
* pause module -- (pause seconds=10) (pause minutes=1) (pause prompt=foo) -- it's an action plugin
* a module for adding entries to the main crontab (though you may still wish to just drop template files into cron.d)
* debug module can be used for outputing messages without using 'shell echo'
* a fail module is now available for causing errors, you might want to use it with only_if to fail in certain conditions

Other module Changes, Upgrades, and Fixes:
Michael DeHaan committed
1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678

* removes= exists on command just like creates=
* postgresql modules now take an optional port= parameter
* /proc/cmdline info is now available in Linux facts
* public host key detection for OS X
* lineinfile module now uses 'search' not exact 'match' in regexes, making it much more intuitive and not needing regex syntax most of the time
* added force=yes|no (default no) option for file module, which allows transition between files to directories and so on
* additional facts for SunOS virtualization
* copy module is now atomic when used across volumes
* url_get module now returns 'dest' with the location of the file saved
* fix for yum module when using local RPMs vs downloading
* cleaner error messages with copy if destination directory does not exist
Michael DeHaan committed
1679 1680 1681 1682
* setup module now still works if PATH is not set
* service module status now correct for services with 'subsys locked' status
* misc fixes/upgrades to the wait_for module
* git module now expands any "~" in provided destination paths
Michael DeHaan committed
1683
* ignore stop error code failure for service module with state=restarted, always try to start
Michael DeHaan committed
1684
* inline documentation for modules allows documentation source to built without pull requests to the ansible-docs project, among other things
Michael DeHaan committed
1685 1686
* variable '$ansible_managed' is now great to include at the top of your templates and includes useful information and a warning that it will be replaced
* "~" now expanded in command module when using creates/removes
Michael DeHaan committed
1687
* mysql module can do dumps and imports
Michael DeHaan committed
1688 1689
* selinux policy is only required if setting to not disabled
* various fixes for yum module when working with packages not in any present repo
1690

1691
## 0.7 "Panama" -- Sept 6 2012
1692 1693

Module changes:
Michael DeHaan committed
1694

Michael DeHaan committed
1695
* login_unix_socket option for mysql user and database modules (see PR #781 for doc notes)
1696 1697 1698 1699
* new modules -- pip, easy_install, apt_repository, supervisorctl
* error handling for setup module when SELinux is in a weird state
* misc yum module fixes
* better changed=True/False detection in user module on older Linux distros
1700
* nicer errors from modules when arguments are not key=value
Michael DeHaan committed
1701
* backup option on copy (backup=yes), as well as template, assemble, and lineinfile
Michael DeHaan committed
1702 1703
* file module will not recurse on directory properties
* yum module now workable without having repoquery installed, but doesn't support comparisons or list= if so
1704 1705 1706
* setup module now detects interfaces with aliases
* better handling of VM guest type detection in setup module
* new module boilerplate code to check for mutually required arguments, arguments required together, exclusive args
1707
* add pattern= as a parameter to the service module (for init scripts that don't do status, or do poor status)
1708
* various fixes to mysql & postresql modules
1709
* added a thirsty= option (boolean, default no) to the get_url module to decide to download the file every time or not
Michael DeHaan committed
1710 1711 1712 1713 1714 1715 1716 1717 1718 1719
* added a wait_for module to poll for ports being open
* added a nagios module for controlling outage windows and alert statuses
* added a seboolean module for getsebool/setsebool type operations
* added a selinux module for controlling overall SELinux policy
* added a subversion module
* added lineinfile for adding and removing lines from basic files
* added facts for ARM-based CPUs
* support for systemd in the service module
* git moduleforce reset behavior is now controllable
* file module can now operate on special files (block devices, etc)
1720 1721 1722 1723 1724 1725 1726 1727

Core changes:

* ansible --version will now give branch/SHA information if running from git
* better sudo permissions when encountering different umasks
* when using paramiko and SFTP is not accessible, do not traceback, but return a nice human readable msg
* use -vvv for extreme debug levels. -v gives more playbook output as before
* -vv shows module arguments to all module calls (and maybe some other things later)
Michael DeHaan committed
1728
* don not pass "--" to sudo to work on older EL5
Michael DeHaan committed
1729 1730
* make remote_md5 internal function work with non-bash shells
* allow user to be passed in via --extra-vars (regression)
1731
* add --limit option, which can be used to further confine the pattern given in ansible-playbooks
1732
* adds ranged patterns like dbservers[0-49] for usage with patterns or --limit
Michael DeHaan committed
1733
* -u and user: defaults to current user, rather than root, override as before
Michael DeHaan committed
1734
* /etc/ansible/ansible.cfg and ~/ansible.cfg now available to set default values and other things
1735 1736
* (developers) ANSIBLE_KEEP_REMOTE_FILES=1 can be used in debugging (envrionment variable)
* (developers) connection types are now plugins
Michael DeHaan committed
1737 1738 1739 1740
* (developers) callbacks can now be extended via plugins
* added FreeBSD ports packaging scripts
* check for terminal properties prior to engaging color modes
* explicitly disable password auth with -c ssh, as it is not used anyway
1741 1742 1743 1744

Playbooks:

* YAML syntax errors detected and show where the problem is
Michael DeHaan committed
1745
* if you ctrl+c a playbook it will not traceback (usually)
1746 1747 1748
* vars_prompt now has encryption options (see examples/playbooks/prompts.yml)
* allow variables in parameterized task include parameters (regression)
* add ability to store the result of any command in a register (see examples/playbooks/register_logic.yml)
1749
* --list-hosts to show what hosts are included in each play of a playbook
1750
* fix a variable ordering issue that could affect vars_files with selective file source lists
1751
* adds 'delegate_to' for a task, which can be used to signal outage windows and load balancers on behalf of hosts
1752
* adds 'serial' to playbook, allowing you to specify how many hosts can be processing a playbook at one time (default 0=all)
Michael DeHaan committed
1753
* adds 'local_action: <action parameters>' as an alias to 'delegate_to: 127.0.0.1'
Michael DeHaan committed
1754

1755
## 0.6 "Cabo" -- August 6, 2012
1756

1757 1758
playbooks:

Michael DeHaan committed
1759
* support to tag tasks and includes and use --tags in playbook CLI
1760 1761 1762 1763 1764
* playbooks can now include other playbooks (example/playbooks/nested_playbooks.yml)
* vars_files now usable with with_items, provided file paths don't contain host specific facts
* error reporting if with_items value is unbound
* with_items no longer creates lots of tasks, creates one task that makes multiple calls
* can use host_specific facts inside with_items (see above)
1765
* at the top level of a playbook, set 'gather_facts: no' to skip fact gathering
1766 1767 1768 1769 1770
* first_available_file and with_items used together will now raise an error
* to catch typos, like 'var' for 'vars', playbooks and tasks now yell on invalid parameters
* automatically load (directory_of_inventory_file)/group_vars/groupname and /host_vars/hostname in vars_files
* playbook is now colorized, set ANSIBLE_NOCOLOR=1 if you do not like this, does not colorize if not a TTY
* hostvars now preserved between plays (regression in 0.5 from 0.4), useful for sharing vars in multinode configs
1771
* ignore_errors: yes on a task can be used to allow a task to fail and not stop the play
1772
* with_items with the apt/yum module will install/remove/update everything in a single command
1773 1774 1775

inventory:

Michael DeHaan committed
1776
* groups variable available as a hash to return the hosts in each group name
1777 1778 1779
* in YAML inventory, hosts can list their groups in inverted order now also (see tests/yaml_hosts)
* YAML inventory is deprecated and will be removed in 0.7
* ec2 inventory script
1780
* support ranges of hosts in the host file, like www[001-100].example.com (supports leading zeros and also not)
1781 1782 1783

modules:

Michael DeHaan committed
1784
* fetch module now does not fail a system when requesting file paths (ex: logs) that don't exist
Michael DeHaan committed
1785 1786
* apt module now takes an optional install-recommends=yes|no (default yes)
* fixes to the return codes of the copy module
Michael DeHaan committed
1787
* copy module takes a remote md5sum to avoid large file transfer
Michael DeHaan committed
1788 1789 1790
* various user and group module fixes (error handling, etc)
* apt module now takes an optional force parameter
* slightly better psychic service status handling for the service module
Michael DeHaan committed
1791
* fetch module fixes for SSH connection type
1792
* modules now consistently all take yes/no for boolean parameters (and DWIM on true/false/1/0/y/n/etc)
1793
* setup module no longer saves to disk, template module now only used in playbooks
1794
* setup module no longer needs to run twice per playbook
Michael DeHaan committed
1795
* apt module now passes DEBIAN_FRONTEND=noninteractive
1796
* mount module (manages active mounts + fstab)
Michael DeHaan committed
1797
* setup module fixes if no ipv6 support
Michael DeHaan committed
1798
* internals: template in common module boilerplate, also causes less SSH operations when used
Michael DeHaan committed
1799
* git module fixes
Michael DeHaan committed
1800
* setup module overhaul, more modular
Michael DeHaan committed
1801
* minor caching logic added to inventory to reduce hammering of inventory scripts.
Michael DeHaan committed
1802 1803
* MySQL and PostgreSQL modules for user and db management
* vars_prompt now supports private password entry (see examples/playbooks/prompts.yml)
1804
* yum module modified to be more tolerant of plugins spewing random console messages (ex: RHN)
1805 1806 1807 1808 1809 1810 1811 1812

internals:

* when sudoing to root, still use /etc/ansible/setup as the metadata path, as if root
* paramiko is now only imported if needed when running from source checkout
* cowsay support on Ubuntu
* various ssh connection fixes for old Ubuntu clients
* ./hacking/test-module now supports options like ansible takes and has a debugger mode
Michael DeHaan committed
1813
* sudoing to a user other than root now works more seamlessly (uses /tmp, avoids umask issues)
Michael DeHaan committed
1814

1815
## 0.5 "Amsterdam" ------- July 04, 2012
1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829

* Service module gets more accurate service states when running with upstart
* Jinja2 usage in playbooks (not templates), reinstated, supports %include directive
* support for --connection ssh (supports Kerberos, bastion hosts, etc), requires ControlMaster
* misc tracebacks replaced with error messages
* various API/internals refactoring
* vars can be built from other variables
* support for exclusion of hosts/groups with "!groupname"
* various changes to support md5 tool differences for FreeBSD nodes & OS X clients
* "unparseable" command output shows in command output for easier debugging
* mktemp is no longer required on remotes (not available on BSD)
* support for older versions of python-apt in the apt module
* a new "assemble" module, for constructing files from pieces of files (inspired by Puppet "fragments" idiom)
* ability to override most default values with ANSIBLE_FOO environment variables
Jim Kleckner committed
1830
* --module-path parameter can support multiple directories separated with the OS path separator
1831 1832 1833 1834 1835 1836
* with_items can take a variable of type list
* ansible_python_interpreter variable available for systems with more than one Python
* BIOS and VMware "fact" upgrades
* cowsay is used by ansible-playbook if installed to improve output legibility (try installing it)
* authorized_key module
* SELinux facts now sourced from the python selinux library
Michael DeHaan committed
1837 1838
* removed module debug option -D
* added --verbose, which shows output from successful playbook operations
1839
* print the output of the raw command inside /usr/bin/ansible as with command/shell
1840 1841
* basic setup module support for Solaris
* ./library relative to the playbook is always in path so modules can be included in tarballs with playbooks
1842

1843
## 0.4 "Unchained" ------- May 23, 2012
Michael DeHaan committed
1844

1845 1846 1847 1848
Internals/Core
* internal inventory API now more object oriented, parsers decoupled
* async handling improvements
* misc fixes for running ansible on OS X (overlord only)
1849
* sudo improvements, now works much more smoothly
1850 1851 1852 1853 1854 1855 1856
* sudo to a particular user with -U/--sudo-user, or using 'sudo_user: foo' in a playbook
* --private-key CLI option to work with pem files

Inventory
* can use -i host1,host2,host3:port to specify hosts not in inventory (replaces --override-hosts)
* ansible INI style format can do groups of groups [groupname:children] and group vars [groupname:vars]
* groups and users module takes an optional system=yes|no on creation (default no)
1857
* list of hosts in playbooks can be expressed as a YAML list in addition to ; delimited
1858 1859 1860 1861 1862 1863 1864 1865 1866

Playbooks
* variables can be replaced like ${foo.nested_hash_key.nested_subkey[array_index]}
* unicode now ok in templates (assumes utf8)
* able to pass host specifier or group name in to "hosts:" with --extra-vars
* ansible-pull script and example playbook (extreme scaling, remediation)
* inventory_hostname variable available that contains the value of the host as ansible knows it
* variables in the 'all' section can be used to define other variables based on those values
* 'group_names' is now a variable made available to templates
1867
* first_available_file feature, see selective_file_sources.yml in examples/playbooks for info
Michael DeHaan committed
1868
* --extra-vars="a=2 b=3" etc, now available to inject parameters into playbooks from CLI
1869 1870 1871 1872

Incompatible Changes
* jinja2 is only usable in templates, not playbooks, use $foo instead
* --override-hosts removed, can use -i with comma notation (-i "ahost,bhost")
Michael DeHaan committed
1873
* modules can no longer include stderr output (paramiko limitation from sudo)
1874 1875 1876 1877 1878

Module Changes
* tweaks to SELinux implementation for file module
* fixes for yum module corner cases on EL5
* file module now correctly returns the mode in octal
1879 1880
* fix for symlink handling in the file module
* service takes an enable=yes|no which works with chkconfig or updates-rc.d as appropriate
Michael DeHaan committed
1881 1882
* service module works better on Ubuntu
* git module now does resets and such to work more smoothly on updates
Michael DeHaan committed
1883
* modules all now log to syslog
1884
* enabled=yes|no on a service can be used to toggle chkconfig & updates-rc.d states
1885 1886 1887 1888 1889 1890 1891 1892 1893
* git module supports branch=
* service fixes to better detect status using return codes of the service script
* custom facts provided by the setup module mean no dependency on Ruby, facter, or ohai
* service now has a state=reloaded
* raw module for bootstrapping and talking to routers w/o Python, etc

Misc Bugfixes
* fixes for variable parsing in only_if lines
* misc fixes to key=value parsing
1894
* variables with mixed case now legal
1895 1896
* fix to internals of hacking/test-module development script

Michael DeHaan committed
1897

1898
## 0.3 "Baluchitherium" -- April 23, 2012
Michael DeHaan committed
1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925

* Packaging for Debian, Gentoo, and Arch
* Improvements to the apt and yum modules
* A virt module
* SELinux support for the file module
* Ability to use facts from other systems in templates (aka exported
resources like support)
* Built in Ansible facts so you don't need ohai, facter, or Ruby
* tempdir selections that work with noexec mounted /tmp
* templates happen locally, not remotely, so no dependency on
python-jinja2 for remote computers
* advanced inventory format in YAML allows more control over variables
per host and per group
* variables in playbooks can be structured/nested versus just a flat namespace
* manpage upgrades (docs)
* various bugfixes
* can specify a default --user for playbooks rather than specifying it
in the playbook file
* able to specify ansible port in ansible host file (see docs)
* refactored Inventory API to make it easier to write scripts using Ansible
* looping capability for playbooks (with_items)
* support for using sudo with a password
* module arguments can be unicode
* A local connection type, --connection=local,  for use with cron or
in kickstarts
* better module debugging with -D
* fetch module for pulling in files from remote hosts
Michael DeHaan committed
1926
* command task supports creates=foo for idempotent semantics, won't run if file foo already exists
Michael DeHaan committed
1927

1928
## 0.0.2 and 0.0.1
Michael DeHaan committed
1929 1930 1931

* Initial stages of project