ansible-role-cloud-launcher/README.rst
Ricardo Carrillo Cruz 4531f7958e Switch README from markdown to rst
Change-Id: I7a53d456dbc7a3b8e2b6c20332f7a544bf48b9f3
2016-05-04 13:31:43 +02:00

63 lines
1.6 KiB
ReStructuredText

===========================
ansible-role-cloud-launcher
===========================
Ansible role to launch multiple OpenStack Clouds resources
* License: Apache License, Version 2.0
* Documentation: https://ansible-role-cloud-launcher.readthedocs.org
* Source: https://git.openstack.org/cgit/openstack/ansible-role-cloud-launcher
* Bugs: https://bugs.launchpad.net/ansible-role-cloud-launcher
Description
-----------
ansible-role-cloud-launcher is an Ansible role that allows to launch
multiple OpenStack clouds resources.
Resources can be defined in a cloud by cloud basis or defined in a profile,
which may be reused by more than one cloud.
Requirements
------------
shade library needs to be installed, as that is required by the
OpenStack Ansible modules.
Role Variables
--------------
The role expects variables fed by ansible-playbook
on the CLI, for example:
ansible-playbook -i inventory play.yml -e "@resources.yml"
The role expects the resources variables file to have two dict variables,
*profiles* and *clouds*.
*profiles* contains a list of OpenStack resources definitions
that are meant to be reused by one or more clouds.
*clouds* contains a list of clouds the role will launch resources on. Each
cloud definition will have the OSCC cloud name, a list of profiles the cloud
will reuse and a list of resources specific to that cloud.
Please check resources.yml.sample on this repository for a full-blown example.
Dependencies
------------
None
Example playbook
----------------
.. code-block:: yaml
---
- hosts: localhost
connection: local
gather_facts: false
roles:
- { role: ansible-role-cloud-launcher }