openstack/openstack-ansible
Code Issues Proposed changes

Merge "Update Gnocchi with Ceph and Redis documentation."

Browse Source
This commit is contained in:
Zuul 2021-02-23 21:54:52 +00:00 committed by Gerrit Code Review
commit 97c0a10b48
1 changed files with 15 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/source/user/prod/gnocchi_redis.rst
View File

@ -22,11 +22,11 @@ You have to add some pip packages to your gnocchi setup:
- cryptography
- gnocchiclient
# this is what we want:
# - "gnocchi[mysql,ceph,ceph_alternative_lib,redis]"
# - "gnocchi[mysql,ceph,ceph_alternative_lib,redis,keystone]"
# but as there is no librados >=12.2 pip package we have to first install ceph without alternative support
# after adding the ceph repo to gnocchi container, python-rados>=12.2.0 is installed and linked automatically
# and gnocchi will automatically take up the features present in the used rados lib.
- "gnocchi[mysql,ceph,redis]"
- "gnocchi[mysql,ceph,redis,keystone]"
- keystonemiddleware
- python-memcached
@ -50,7 +50,7 @@ storage for your gnocchi installation. The `supported storage systems`_ are:
.. _supported storage systems: https://gnocchi.xyz/intro.html#incoming-and-storage-drivers
When your Swift installation uses Ceph as backend, the only one left for this
When your Swift API endpoint uses Ceph as a backend, the only one left for this
setup is Redis.
So first of all setup a redis server/cluster, e.g. with this `ansible role`_.
@ -64,7 +64,7 @@ Cluster as incoming storage:
gnocchi_conf_overrides:
incoming:
driver: redis
redis_url: redis://{{ hostvars[groups['redis-master'][0]]['ansible_default_ipv4']['address'] }}:{{ hostvars[groups['redis-master'][0]]['redis_sentinel_port'] }}?sentinel=master01{% for host in groups['redis-slave'] %}&sentinel_fallback={{ hostvars[host]['ansible_default_ipv4']['address'] }}:{{ hostvars[host]['redis_sentinel_port'] }}{% endfor %}
redis_url: redis://{{ hostvars[groups['redis-master'][0]]['ansible_default_ipv4']['address'] }}:{{ hostvars[groups['redis-master'][0]]['redis_sentinel_port'] }}?sentinel=master01{% for host in groups['redis-slave'] %}&sentinel_fallback={{ hostvars[host]['ansible_default_ipv4']['address'] }}:{{ hostvars[host]['redis_sentinel_port'] }}{% endfor %}&db=0
You also have to install additional pip/distro packages to use the redis
cluster:
@ -77,11 +77,13 @@ cluster:
- libapache2-mod-wsgi
- git
- build-essential
- python-dev
- python3-dev
- librados-dev
- libpq-dev
- python-rados
- python3-rados
# additional package for python redis client
- python-redis
- python3-redis
- libsystemd-dev
.. code-block:: yaml
@ -89,14 +91,15 @@ cluster:
- cryptography
- gnocchiclient
# this is what we want:
# - "gnocchi[mysql,ceph,ceph_alternative_lib,redis]"
# - "gnocchi[mysql,ceph,ceph_alternative_lib,redis,keystone]"
# but as there is no librados >=12.2 pip package we have to first install ceph without alternative support
# after adding the ceph repo to gnocchi container, python-rados>=12.2.0 is installed and linked automatically
# and gnocchi will automatically take up the features present in the used rados lib.
- "gnocchi[mysql,ceph,redis]"
- "gnocchi[mysql,ceph,redis,keystone]"
- keystonemiddleware
- python-memcached
- redis
- systemd-python
.. note::
@ -154,14 +157,15 @@ You also have to install additional packages:
- cryptography
- gnocchiclient
# this is what we want:
# - "gnocchi[mysql,ceph,ceph_alternative_lib,redis]"
# - "gnocchi[mysql,ceph,ceph_alternative_lib,redis,keystone]"
# but as there is no librados >=12.2 pip package we have to first install ceph without alternative support
# after adding the ceph repo to gnocchi container, python-rados>=12.2.0 is installed and linked automatically
# and gnocchi will automatically take up the features present in the used rados lib.
- "gnocchi[mysql,ceph,redis]"
- "gnocchi[mysql,ceph,redis,keystone]"
- keystonemiddleware
- python-memcached
- redis
- systemd-python
# addiitional pip packages needed for zookeeper coordination backend
- tooz
- lz4