From f3c3b5d559e0d71afea32ad3cfb39ca4f0a80c8b Mon Sep 17 00:00:00 2001 From: Dmitriy Chubinidze Date: Wed, 11 Jun 2025 12:44:56 +0000 Subject: [PATCH] docs: add link to OSA deployment guide for adding a role Provide a direct reference to the OpenStack-Ansible deploy guide, helping users understand how to integrate a new role into their deployment. Signed-off-by: Dmitriy Chubinidze Change-Id: Id7799e1d1fde6ccfb4104c76e702538f1b478bea --- doc/source/index.rst | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/doc/source/index.rst b/doc/source/index.rst index 2b9ebee3..123ad61b 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -21,6 +21,46 @@ Table of Contents To clone or view the source code for this repository, visit the role repository for `os_ceilometer `_. +Adding The Service to Your OpenStack-Ansible Deployment +------------------------------------------------------- + +To add a new service to your OpenStack-Ansible (OSA) deployment: + +* Define ``metering-compute_hosts`` and ``metering-compute_hosts`` (on which + runs ceilometer compute agent) in your ``conf.d`` or + ``openstack_user_config.yml``. For example: + + .. code-block:: yaml + + metering-infra_hosts: + infra1: + ip: 172.20.236.111 + infra2: + ip: 172.20.236.112 + infra3: + ip: 172.20.236.113 + + metering-compute_hosts: + compute1: + ip: 172.20.236.110 + +* Create respective LXC containers (skip this step for metal deployments): + + .. code-block:: console + + openstack-ansible openstack.osa.containers_lxc_create --limit ceilometer_all,metering-compute_hosts + +* Run service deployment playbook: + + .. code-block:: console + + openstack-ansible openstack.osa.ceilometer + +For more information, please refer to the `OpenStack-Ansible project documentation `_. + +Always verify that the integration is successful and that the service behaves +correctly before using it in a production environment. + Default variables ~~~~~~~~~~~~~~~~~