1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00

Various syntax and layout things, add Galaxy to docs

This commit is contained in:
Michael DeHaan 2013-12-20 17:07:06 -05:00
parent d481b6e686
commit d6ea5be20f
4 changed files with 38 additions and 17 deletions

View file

@ -9,9 +9,7 @@ Rackspace Cloud Guide
Introduction Introduction
```````````` ````````````
.. note:: This section of the documentation is under construction. We are in the process of adding more examples about the Rackspace modules .. note:: This section of the documentation is under construction. We are in the process of adding more examples about the Rackspace modules and how they work together. Once complete, there will also be examples for Rackspace Cloud in `ansible-examples <http://github.com/ansible/ansible-examples/>`_.
and how they work together. Once complete, there will also be examples for
Rackspace Cloud in `ansible-examples <http://github.com/ansible/ansible-examples/>`_.
Ansible contains a number of core modules for interacting with Rackspace Cloud. Ansible contains a number of core modules for interacting with Rackspace Cloud.
@ -127,8 +125,6 @@ Here's what it would look like in a playbook, assuming the parameters were defin
By registering the return value of the step, it is then possible to dynamically add the resulting hosts to inventory (temporarily, in memory). By registering the return value of the step, it is then possible to dynamically add the resulting hosts to inventory (temporarily, in memory).
This facilitates performing configuration actions on the hosts immediately in a subsequent task:: This facilitates performing configuration actions on the hosts immediately in a subsequent task::
.. code-block:: yaml
- name: Add the instances we created (by public IP) to the group 'raxhosts' - name: Add the instances we created (by public IP) to the group 'raxhosts'
local_action: local_action:
module: add_host module: add_host
@ -139,9 +135,7 @@ This facilitates performing configuration actions on the hosts immediately in a
with_items: rax.success with_items: rax.success
when: rax.action == 'create' when: rax.action == 'create'
With the host group now created, a second play in your provision playbook could now configure them, for example: With the host group now created, a second play in your provision playbook could now configure them, for example::
.. code-block:: yaml
- name: Configuration play - name: Configuration play
hosts: raxhosts hosts: raxhosts
@ -183,10 +177,7 @@ rax.py
To use the rackspace dynamic inventory script, copy ``rax.py`` from ``plugins/inventory`` into your inventory directory. You can specify credentials To use the rackspace dynamic inventory script, copy ``rax.py`` from ``plugins/inventory`` into your inventory directory. You can specify credentials
for ``rax.py`` utilizing the ``RAX_CREDS_FILE`` environment variable. for ``rax.py`` utilizing the ``RAX_CREDS_FILE`` environment variable.
.. note:: Users of AnsibleWorks AWX will note that dynamic inventory is natively supported by AWX, and all you have to do is associate .. note:: Users of AnsibleWorks AWX will note that dynamic inventory is natively supported by AWX, and all you have to do is associate a group with your Rackspace Cloud credentials, and it will easily synchronize without going through these steps::
a group with your Rackspace Cloud credentials, and it will easily synchronize without going through these steps.
.. code-block:: bash
$ RAX_CREDS_FILE=~/.raxpub ansible all -i rax.py -m setup $ RAX_CREDS_FILE=~/.raxpub ansible all -i rax.py -m setup

View file

@ -1,5 +1,5 @@
Tutorial: Rolling Upgrades for Continuous Delivery Continuous Delivery and Rolling Upgrades
================================================== ========================================
.. contents:: .. contents::
:depth: 2 :depth: 2
@ -14,8 +14,8 @@ Continuous Delivery is the concept of frequently delivering updates to your soft
The idea is that my updating more often, you not only have to wait for specific timed period, but your organization The idea is that my updating more often, you not only have to wait for specific timed period, but your organization
gets better at the process of responding to change. gets better at the process of responding to change.
Some Ansible users are deploying updates to their end users on an hourly or even more frequent basis. Some Ansible users are deploying updates to their end users on an hourly or even more frequent basis -- sometimes every time
To achieve this, you need tools to be able to quickly apply those updates in a zero-downtime way. there is an approved code change. To achieve this, you need tools to be able to quickly apply those updates in a zero-downtime way.
This document describes in detail how to achieve this goal, using one of Ansible's most complete example This document describes in detail how to achieve this goal, using one of Ansible's most complete example
playbooks as a template: lamp_haproxy. This example uses a lot of Ansible features: roles, templates, playbooks as a template: lamp_haproxy. This example uses a lot of Ansible features: roles, templates,
@ -24,7 +24,7 @@ rolling upgrades of the web application stack.
.. note:: .. note::
You can always find the latest playbooks for this example `here `Click here for the latest playbooks for this example`
<https://github.com/ansible/ansible-examples/tree/master/lamp_haproxy>`_. <https://github.com/ansible/ansible-examples/tree/master/lamp_haproxy>`_.
The playbooks deploy Apache, PHP, MySQL, Nagios, and HAProxy to a CentOS-based set of servers. The playbooks deploy Apache, PHP, MySQL, Nagios, and HAProxy to a CentOS-based set of servers.

View file

@ -127,6 +127,22 @@ Find out more about AWX features and how to download it on the `AWX webpage <htt
is free for usage for up to 10 nodes, and comes bundled with amazing support from AnsibleWorks. As you would expect, AWX is is free for usage for up to 10 nodes, and comes bundled with amazing support from AnsibleWorks. As you would expect, AWX is
installed using Ansible playbooks! installed using Ansible playbooks!
.. _ansibleworks_galaxy:
AnsibleWorks Galaxy
```````````````````
.. image:: https://galaxy.ansibleworks.com/static/img/galaxy_logo_small.png
:alt: AnsibleWorks Galaxy Logo
:width: 619px
:height: 109px
`AnsibleWorks Galaxy <http://galaxy.ansibleworks.com>`_, is a free site for finding, downloading, rating, and reviewing all kinds of community developed Ansible roles and can be a great way to get a jumpstart on your automation projects.
You can sign up with social auth, and the download client 'ansible-galaxy' is included in Ansible 1.4.2 and later.
Read the "About" page on the Galaxy site for more information.
.. _detailed_guides: .. _detailed_guides:
Detailed Guides Detailed Guides

View file

@ -320,6 +320,20 @@ The resulting order of execution would be as follows::
.. note:: .. note::
Variable inheritance and scope are detailed in the :doc:`playbooks_variables`. Variable inheritance and scope are detailed in the :doc:`playbooks_variables`.
AnsibleWorks Galaxy
```````````````````
.. image:: https://galaxy.ansibleworks.com/static/img/galaxy_logo_small.png
:alt: AnsibleWorks Galaxy Logo
:width: 619px
:height: 109px
`AnsibleWorks Galaxy <http://galaxy.ansibleworks.com>`_, is a free site for finding, downloading, rating, and reviewing all kinds of community developed Ansible roles and can be a great way to get a jumpstart on your automation projects.
You can sign up with social auth, and the download client 'ansible-galaxy' is included in Ansible 1.4.2 and later.
Read the "About" page on the Galaxy site for more information.
.. seealso:: .. seealso::
:doc:`YAMLSyntax` :doc:`YAMLSyntax`