Integrations

db

Interface: pgsql
Supported charms: postgresql-k8s, postgresql

Database integration is a required relation for the indico charm to supply structured data storage for Indico.

Example db integrate command:

juju integrate indico postgresql-k8s:db

redis

Interface: redis
Supported charms: redis-k8s

Redis integration is a required relation for the indico charm to supply caching capabilities and a message broker to interface with Celery. As such, two instances are needed, redis-cache and redis-broker.

Example db integrate commands:

juju integrate redis-cache indico 
juju integrate redis-broker indico

ingress

Interface: ingress
Supported charms: nginx-ingress-integrator

Ingress manages external http/https access to services in a kubernetes cluster. Ingress relation through nginx-ingress-integrator charm enables additional blog_hostname and use_nginx_ingress_modesec configurations. Note that the kubernetes cluster must already have an nginx ingress controller already deployed. Documentation to enable ingress in microk8s can be found here.

Example ingress integrate command:

juju integrate indico nginx-ingress-integrator

metrics-endpoint

Interface: prometheus_scrape
Supported charms: prometheus-k8s

Metrics-endpoint relation allows scraping the /metrics endpoint provided by apache-exporter sidecar on port 9117, which provides apache metrics from apache’s /server-status route. This internal apache’s /server-status route is not exposed and can only be accessed from within the same Kubernetes pod. The metrics are exposed in the open metrics format and will only be scraped by Prometheus once the relation becomes active. For more information about the metrics exposed, please refer to the apache-exporter documentation.

Metrics-endpoint integrate command:

juju integrate indico prometheus-k8s

grafana-dashboard

Interface: grafana-dashboard
Supported charms: grafana-k8s

Grafana-dashboard relation enables quick dashboard access already tailored to fit the needs of operators to monitor the charm. The template for the Grafana dashboard for indico charm can be found at /src/grafana_dashboards/indico.json. In Grafana UI, it can be found as “Indico Operator Overview” under the General section of the dashboard browser (/dashboards). Modifications to the dashboard can be made but will not be persisted upon restart/redeployment of the charm.

Grafana-Prometheus integrate command:

juju integrate grafana-k8s:grafana-source prometheus-k8s:grafana-source

Grafana-dashboard integrate command:

juju integrate indico grafana-dashboard

See more information in Charm Architecture.