openstack/kolla-ansible
Code Issues Proposed changes

Document how to add logging for a service

Browse Source 
TrivialFix

Change-Id: I2e912176174538fb1aded27e54c6a10acaf7d34b
This commit is contained in:
Christian Berendt 2016-09-12 22:35:52 +02:00
parent d2b64b4473
commit ddbbd05be0
1 changed files with 28 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/CONTRIBUTING.rst
View File

@ -137,18 +137,40 @@ that Kolla uses throughout that should be followed.
include service specific setup and steps as not all services can be upgraded
in the same way.
Other than the above, most roles follow the following pattern::
* Log delivery
- ``Register`` : Involves registering the service with Keystone, creating endpoints, roles,
- For OpenStack services the service has be added oo the ``file_match`` paramater
in the ``openstack_logstreamer_input`` section in the ``heka-openstack.toml.j2``
template file in ``ansible/roles/comm/templates`` to deliver log messages to
Elasticsearch.
* Logrotation
- For OpenStack services there should be a ``cron-logrotate-PROJECT.conf.j2``
template file in ``ansible/roles/common/templates`` with the following
content:
.. code::
"/var/log/kolla/PROJECT/*.log"
{
}
- For OpenStack services there should be a entry in the ``services`` list
in the ``cron.json.j2`` template file in ``ansible/roles/common/templates``.
Other than the above, most roles follow the following pattern:
- ``Register``: Involves registering the service with Keystone, creating endpoints, roles,
users, etc.
- ``Config`` : Distributes the config files to the nodes to be pulled into the container on
- ``Config``: Distributes the config files to the nodes to be pulled into the container on
startup.
- ``Bootstrap`` : Creating the database (but not tables), database user for the service,
- ``Bootstrap``: Creating the database (but not tables), database user for the service,
permissions, etc.
- ``Bootstrap Service`` : Starts a one shot container on the host to create the database tables,
- ``Bootstrap Service``: Starts a one shot container on the host to create the database tables,
and other initial run time config.
- ``Start`` : Start the service(s).
- ``Start``: Start the service(s).