ansible · njharman · Oct 15, 2012 · Oct 15, 2012 · Oct 16, 2012 · Oct 16, 2012
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,7 +1,27 @@
 Ansible Changes By Release
 ==========================
 
-0.8 "Cathedral" -- release pending 
+0.9 "Dreams" -- release pending
+
+* various performance tweaks, ansible executes dramatically less SSH ops per unit of work
+* added 'script' module for pushing and running self-deleting remote scripts
+* relative paths now work for 'first_available_file'
+* fix for template calls when last character is '$'
+* postgresql module now takes role_attr_flags
+* ability to create SSH keys for users when using user module to create users
+* close paramiko SFTP connections less often on copy/template operations (speed increase)
+* change the way we use multiprocessing (speed/RAM usage improvements)
+* atomic replacement of files preserves permissions of original file
+* if ansible_*_interpreter is set on a delegated host, it now works as intended
+* authorized key module uses temp file now to prevent failure on full disk
+* MySQL module takes new grant options
+* user module can create SHS keys
+* yum module takes enablerepo= and disablerepo=
+* --limit can now take "," as well as ";" or ":"
+* various git module improvements/tweaks
+* EC2 module now produces nicer failure message if AWS is down (or similar)
+
+0.8 "Cathedral" -- Oct 19, 2012
 
 Highlighted Core Changes:
 
@@ -31,6 +51,7 @@ Other Core Changes:
 * fatal errors are now properly colored red.
 * skipped messages are now cyan, to differentiate them from unchanged messages.
 * extensive documentation upgrades
+* delegate_action to localhost (aka local_action) will always use the local connection type
 
 Highlighted playbook changes:
 
@@ -46,6 +67,8 @@ Highlighted playbook changes:
 * setup is not run more than once when we know it is has already been run in a play that included another play, etc
 * can set/override sudo and sudo_user on individual tasks in a play, defaults to what is set in the play if not present
 * ability to use with_fileglob to iterate over local file patterns
+* templates now use Jinja2's 'trim_blocks=True' to avoid stray newlines, small changes to templates may
+be required in rare cases.
 
 Other playbook changes:
 
@@ -92,6 +115,8 @@ Other module Changes, Upgrades, and Fixes:
 * 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
 * mysql module can do dumps and imports
+* selinux policy is only required if setting to not disabled
+* various fixes for yum module when working with packages not in any present repo
 
 0.7 "Panama" -- Sept 6 2012
 

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -49,6 +49,17 @@ We're not too strict on style considerations, but we require:
    * no single-line if statements, deeply nested list comprehensions, or clever use of metaclasses -- keep it simple
    * comments where appropriate
 
+Testing Requirements
+====================
+
+Automation tests are run by "make tests" and contain a mixture of integration and "unit" level tests.  To run the tests you need the following:
+
+   * nose must be installed - https://nose.readthedocs.org/en/latest/
+   * ansible tests require paramiko, PyYAML python modules, and python 2.6+.
+   * Some tests require additional components (facter, ohai) and will be skipped if not available.
+   * Your user environment should allow "ssh 127.0.0.1"
+     without a password - so a key held in ssh-agent and an authorized_keys entry.
+
 Contributors License Agreement
 ==============================
 

diff --git a/RELEASES.txt b/RELEASES.txt
@@ -1,12 +1,13 @@
 Ansible Releases at a Glance
 ============================
 
-0.8 "Cathedral" ------- pending
-0.7 "Panama" ---------- 9-06-2012
-0.6 "Cabo" ------------ 8-06-2012
-0.5 "Amsterdam" ------- 7-04-2012
-0.4 "Unchained" ------- 5-23-2012
-0.3 "Baluchitherium" -- 4-23-2012
+0.9 "Dreams" ---------- pending
+0.8 "Cathedral" ------- 10-19-2012
+0.7 "Panama" ---------- 09-06-2012
+0.6 "Cabo" ------------ 08-06-2012
+0.5 "Amsterdam" ------- 07-04-2012
+0.4 "Unchained" ------- 05-23-2012
+0.3 "Baluchitherium" -- 04-23-2012
 0.0.2 Untitled
 0.0.1 Untitled
 

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-0.8
+0.9
diff --git a/bin/ansible-playbook b/bin/ansible-playbook
@@ -18,7 +18,6 @@
 
 #######################################################
 
-import os
 import sys
 import getpass
 

diff --git a/contrib/README.md b/contrib/README.md
diff --git a/docs/man/man1/ansible-playbook.1 b/docs/man/man1/ansible-playbook.1
@@ -2,12 +2,12 @@
 .\"     Title: ansible-playbook
 .\"    Author: [see the "AUTHOR" section]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 10/12/2012
+.\"      Date: 10/19/2012
 .\"    Manual: System administration commands
-.\"    Source: Ansible 0.8
+.\"    Source: Ansible 0.9
 .\"  Language: English
 .\"
-.TH "ANSIBLE\-PLAYBOOK" "1" "10/12/2012" "Ansible 0\&.8" "System administration commands"
+.TH "ANSIBLE\-PLAYBOOK" "1" "10/19/2012" "Ansible 0\&.9" "System administration commands"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------

diff --git a/docs/man/man1/ansible-playbook.1.asciidoc.in b/docs/man/man1/ansible-playbook.1.asciidoc.in
@@ -114,9 +114,9 @@ FILES
 
 /usr/share/ansible/ -- Default module library
 
-/etc/ansible/ansible.conf -- Config file, used if present
+/etc/ansible/ansible.cfg -- Config file, used if present
 
-~/.ansible.config -- User config file, overrides the default config if present
+~/.ansible.cfg -- User config file, overrides the default config if present
 
 AUTHOR
 ------

diff --git a/docs/man/man1/ansible-pull.1 b/docs/man/man1/ansible-pull.1
@@ -2,12 +2,12 @@
 .\"     Title: ansible
 .\"    Author: [see the "AUTHOR" section]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 09/06/2012
+.\"      Date: 10/19/2012
 .\"    Manual: System administration commands
-.\"    Source: Ansible 0.8
+.\"    Source: Ansible 0.9
 .\"  Language: English
 .\"
-.TH "ANSIBLE" "1" "09/06/2012" "Ansible 0\&.8" "System administration commands"
+.TH "ANSIBLE" "1" "10/19/2012" "Ansible 0\&.9" "System administration commands"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------

diff --git a/docs/man/man1/ansible.1 b/docs/man/man1/ansible.1
@@ -2,12 +2,12 @@
 .\"     Title: ansible
 .\"    Author: [see the "AUTHOR" section]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 10/12/2012
+.\"      Date: 10/19/2012
 .\"    Manual: System administration commands
-.\"    Source: Ansible 0.8
+.\"    Source: Ansible 0.9
 .\"  Language: English
 .\"
-.TH "ANSIBLE" "1" "10/12/2012" "Ansible 0\&.8" "System administration commands"
+.TH "ANSIBLE" "1" "10/19/2012" "Ansible 0\&.9" "System administration commands"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------

diff --git a/docs/man/man1/ansible.1.asciidoc.in b/docs/man/man1/ansible.1.asciidoc.in
@@ -135,9 +135,9 @@ FILES
 
 /usr/share/ansible/ -- Default module library
 
-/etc/ansible/ansible.conf -- Config file, used if present
+/etc/ansible/ansible.cfg -- Config file, used if present
 
-~/.ansible.config -- User config file, overrides the default config if present
+~/.ansible.cfg -- User config file, overrides the default config if present
 
 ENVIRONMENT
 -----------
@@ -148,6 +148,8 @@ ANSIBLE_HOSTS  -- Override the default ansible hosts file
 
 ANSIBLE_LIBRARY -- Override the default ansible module library path
 
+ANSIBLE_CONFIG -- Override the default ansible config file
+
 
 AUTHOR
 ------

diff --git a/docsite/rst/YAMLSyntax.rst b/docsite/rst/YAMLSyntax.rst
@@ -38,15 +38,15 @@ A dictionary is represented in a simple ``key:`` and ``value`` form::
 
     ---
     # An employee record
-    name: John Eckersberg
+    name: Example Developer
     job: Developer
     skill: Elite
 
 Dictionaries can also be represented in an abbreviated form if you really want to::
 
     ---
     # An employee record
-    {name: John Eckersberg, job: Developer, skill: Elite}
+    {name: Example Developer, job: Developer, skill: Elite}
 
 .. _truthiness:
 
@@ -63,7 +63,7 @@ has nothing to do with Ansible, but will give you a feel for the format::
 
     ---
     # An employee record
-    name: John Eckersberg
+    name: Example Developer
     job: Developer
     skill: Elite
     employed: True
@@ -80,6 +80,19 @@ has nothing to do with Ansible, but will give you a feel for the format::
 That's all you really need to know about YAML to get started writing
 `Ansible` playbooks.
 
+Gotchas
+-------
+
+While YAML is generally friendly, the following is going to be a YAML syntax error:
+
+    foo: somebody said I should put a colon here: so I did
+
+You will want to quote any hash values using colons, like so:
+
+    foo: "somebody said I should put a colon here: so I did"
+
+And then the colon will be preserved.
+
 .. seealso::
 
    :doc:`playbooks`

diff --git a/docsite/rst/api.rst b/docsite/rst/api.rst
@@ -82,8 +82,8 @@ Advanced programmers may also wish to read the source to ansible itself, for
 it uses the Runner() API (with all available options) to implement the
 command line tools ``ansible`` and ``ansible-playbook``.
 
-Plugins Repository
-------------------
+Plugins Available Online
+------------------------
 
 The remainder of features in the API docs have components available in `ansible-plugins <https://github.com/ansible/ansible/blob/devel/plugins>`_.  Send us a github pull request if you develop any interesting features.
 
@@ -279,10 +279,10 @@ To see the complete list of variables available for an instance, run the script
     cd examples/scripts
     ./ec2_external_inventory.py --host ec2-12-12-12-12.compute-1.amazonaws.com
 
-Example: OpenStack
-``````````````````
+Example: OpenStack Inventory Script
+```````````````````````````````````
 
-Though not detailed here in as much depth as the EC2 module, there's also a OpenStack Nova external inventory source in the plugins directory.  See the inline comments in the module source.
+Though not detailed here in as much depth as the EC2 module, there's also a OpenStack Nova external inventory source in the plugins directory.  See the inline comments in the module source for how to use it.
 
 Callback Plugins
 ----------------
@@ -293,12 +293,35 @@ system, or even (yes, really) making sound effects.  Some examples are contained
 Connection Type Plugins
 -----------------------
 
-By default, ansible ships with a 'paramiko' SSH, native ssh (just called 'ssh'), and 'local' connection type, which can be used
+By default, ansible ships with a 'paramiko' SSH, native ssh (just called 'ssh'), and 'local' connection type.  Release 0.8 also
+added an accelerated connection type named 'fireball'.  All of these can be used
 in playbooks and with /usr/bin/ansible to decide how you want to talk to remote machines.  The basics of these connection types
 are covered in the 'getting started' section.  Should you want to extend Ansible to support other transports (SNMP? Message bus?
 Carrier Pigeon?) it's as simple as copying the format of one of the existing modules and dropping it into the connection plugins
 directory.
 
+Lookup Plugins
+--------------
+
+Language constructs like "with_fileglob" are implemnted via lookup plugins.  Just like other plugin types, you can write your own.
+
+Distributing Plugins
+--------------------
+
+.. versionadded: 0.8
+
+Plugins are loaded from both Python's site_packages (those that ship with ansible) and a configured plugins directory, which defaults
+to /usr/share/ansible/plugins, in a subfolder for each plugin type::
+
+    * action_plugins
+    * lookup_plugins
+    * callback_plugins
+    * connection_plugins
+
+To change this path, edit the ansible configuration file.
+
+In addition, plugins can be shipped in a subdirectory relative to a top-level playbook, in folders named the same as indicated above.
+
 .. seealso::
 
    :doc:`modules`