openstack-ansible-os_trove/README.rst

========================
Team and repository tags
========================

.. image:: https://governance.openstack.org/tc/badges/openstack-ansible-os_trove.svg
    :target: https://governance.openstack.org/tc/reference/tags/index.html

.. Change things from this point on

=======================
OpenStack-Ansible Trove
=======================

Ansible role that installs and configures OpenStack Trove. Trove is
installed behind the Apache webserver listening on port 8779 by default.

Documentation for the project can be found at:
`<https://docs.openstack.org/openstack-ansible-os_trove/latest/>`_

Release notes for the project can be found at:
`<https://docs.openstack.org/releasenotes/openstack-ansible-os_trove/>`_

The project source code repository is located at:
`<https://opendev.org/openstack/openstack-ansible-os_trove>`_

The project home is at:
`<https://launchpad.net/openstack-ansible>`_

The project bug tracker is located at:
`<https://bugs.launchpad.net/openstack-ansible>`_

Required Variables
==================

This list is not exhaustive at present. See role internals for further
details.

.. code-block:: yaml

    # trove TCP listening port
    trove_service_port: 8779

Example Playbook
================

.. code-block:: yaml

   - name: Install trove service
     hosts: trove_all
     user: root
     roles:
        - { role: "os_trove", tags: [ "os-trove" ] }
     vars:
       is_metal: "{{ properties.is_metal|default(false) }}"