From a4c23463fb0e5833d54e00dd7fc79bc46436be96 Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Sat, 31 Mar 2012 09:55:37 -0400 Subject: [PATCH] Add IRC and google groups links to each page --- YAMLSyntax.html | 4 ++++ api.html | 16 +++++++++++++++- examples.html | 4 ++++ faq.html | 4 ++++ gettingstarted.html | 4 ++++ index.html | 6 +++++- man.html | 4 ++++ man/ansible-playbook.1.html | 2 +- man/ansible.1.html | 2 +- moduledev.html | 4 ++++ modules.html | 4 ++++ patterns.html | 4 ++++ rst/YAMLSyntax.rst | 5 ++++- rst/api.rst | 8 ++++++-- rst/examples.rst | 6 ++++++ rst/faq.rst | 4 ++++ rst/gettingstarted.rst | 4 ++++ rst/man.rst | 4 ++++ rst/moduledev.rst | 4 ++++ rst/modules.rst | 5 +++++ rst/patterns.rst | 4 ++++ searchindex.js | 2 +- 22 files changed, 96 insertions(+), 8 deletions(-) diff --git a/YAMLSyntax.html b/YAMLSyntax.html index f53e61a4d0..de6ddaf027 100644 --- a/YAMLSyntax.html +++ b/YAMLSyntax.html @@ -229,6 +229,10 @@ languages:
YAML Lint (online) helps you debug YAML syntax if you are having problems
Github examples directory
Complete playbook files from the github project source
+
Mailing List
+
Questions? Help? Ideas? Stop by the list on Google Groups
+
irc.freenode.net
+
#ansible IRC chat channel
diff --git a/api.html b/api.html index b14a6e721a..94f1e5ef26 100644 --- a/api.html +++ b/api.html @@ -133,7 +133,11 @@ s.parentNode.insertBefore(ga, s);
  • Detailed API Example
  • -
  • External Inventory
  • +
  • External Inventory +
  • @@ -243,6 +247,8 @@ of these options via an external interventory system.

    If you have a data store system where an Ansible external inventory script doesn’t already exist, this may require a little coding,J but we have a Cobbler example in the main source tree – but it’s pretty simple, as we’ll explain below – that would provide a good starting point. Like with modules, it’s possible to build an external inventory script in any language, as long as it returns JSON.

    If you are familiar with Puppet terminology, this concept is basically the same as ‘external nodes’, with the slight difference that it also defines which hosts are managed.

    +
    +

    Script Conventions

    When the external node script is called with no arguments, the script must return a JSON hash/dictionary of all the groups to be managed, with a list of each host/IP as the value for each hash/dictionary element, like so:

    {
         'databases'  : [ 'host1.example.com', 'host2.example.com' ],
    @@ -261,6 +267,9 @@ if the script does not wish to do this, returning an empty hash/dictionary is th
     }
     
    +
    +
    +

    Example: The Cobbler External Inventory Script

    It is expected that many Ansible users will also be Cobbler users. Cobbler has a generic layer that allows it to represent data for multiple configuration management systems (even at the same time), and has been referred to as a ‘lightweight CMDB’ by some admins. This particular script will communicate with Cobbler @@ -304,10 +313,15 @@ a conf.d file appropriately or something similar. Who knows.

    Ansible Modules
    List of built-in modules
    +
    Mailing List
    +
    Questions? Help? Ideas? Stop by the list on Google Groups
    +
    irc.freenode.net
    +
    #ansible IRC chat channel
    + diff --git a/examples.html b/examples.html index 4dac7e1507..6076c17aca 100644 --- a/examples.html +++ b/examples.html @@ -287,6 +287,10 @@ shell commands or software upgrades only.

    A list of available modules
    Playbooks
    Using ansible for configuration management & deployment
    +
    Mailing List
    +
    Questions? Help? Ideas? Stop by the list on Google Groups
    +
    irc.freenode.net
    +
    #ansible IRC chat channel
    diff --git a/faq.html b/faq.html index 1d0fb218ae..807850f2bb 100644 --- a/faq.html +++ b/faq.html @@ -319,6 +319,10 @@ tasks – whether for a QA sytem, build system, or anything you can think of
    Examples of basic commands
    Playbooks
    Learning ansible’s configuration management language
    +
    Mailing List
    +
    Questions? Help? Ideas? Stop by the list on Google Groups
    +
    irc.freenode.net
    +
    #ansible IRC chat channel
    diff --git a/gettingstarted.html b/gettingstarted.html index 31e59bbb7d..df181d5f95 100644 --- a/gettingstarted.html +++ b/gettingstarted.html @@ -253,6 +253,10 @@ you already have a working infrastructure!

    Examples of basic commands
    Playbooks
    Learning ansible’s configuration management language
    +
    Mailing List
    +
    Questions? Help? Ideas? Stop by the list on Google Groups
    +
    irc.freenode.net
    +
    #ansible IRC chat channel
    diff --git a/index.html b/index.html index 2ad4136fe5..693678ade3 100644 --- a/index.html +++ b/index.html @@ -292,7 +292,11 @@ you with questions about Ansible.

  • Detailed API Example
  • -
  • External Inventory
  • +
  • External Inventory +
  • Module Development Guide