Skip to content

Horizon

This page is the starting point for Horizon, the horizon role: one container, horizon, on the control nodes of the example inventory, selected by the tag horizon. The role has no register.yml, so it is never registered in Keystone, and by default it runs no bootstrap (Tags §3). The lists below say where the study covers how to operate it, its impact, its dependencies and the evidence, what to check around a run and what stays open; the service card follows them.

Where to look

Operate

No operation page gives a command line for the horizon tag. With defaults, -t horizon runs the haproxy horizon include, common, config, check-containers and, if anything changed, the horizon restart handler (Tags §3, paragraph below the table).

Impact and risk

  • What the tag executes (horizon): Tags §3, row <svc> and the paragraph below the table; Tags §3.1, row <svc> API service
  • Risks: R8, R24

Dependencies

Evidence

Before and after a run

  • Tags §3.1, row <svc> API service: safe on its own "yes, it is the intended unit"; horizon runs neither Keystone registration nor DB sync, by default; batch with ANSIBLE_SERIAL. Prerequisites: MariaDB, RabbitMQ, memcached, Keystone (registration), HAProxy VIP.
  • fact sheet C §4.2: enabling or disabling any service that has a horizon plugin (designate, octavia, magnum, …) changes the container environment; the horizon container is then recreated on the next deploy/reconfigure even if no horizon config changed.
  • Kolla images §5.2: a recreate (new image, changed parameters) or a settings change makes the next start regenerate the static assets; a plain restart with unchanged settings does not CODE. NOT AVAILABLE How long such a start takes.
  • R8, precautions for a HAProxy config change: ANSIBLE_SERIAL=1 for haproxy changes; --skip-tags haproxy when you don't intend to change frontends.
  • R24, precautions for the effective container stop timeout of 10 s: drain long operations before restarts; patch kolla_docker or pass graceful_timeout if needed.

Known limits and open points

  • What is not known, row "Horizon": the sources do not establish how long a start that regenerates the static assets takes.
  • What is not known, row "memcached": the sources do not establish whether cached tokens are lost when the membership changes or the container restarts, and the effect on auth latency and Horizon sessions.
  • fact sheet C §4.8, "Operational notes", three points: sessions live in memcached unless the DB backend is used (NOT AVAILABLE: whether a horizon restart or a memcached restart logs users out); image side: when collectstatic and compress run (NOT AVAILABLE: how long they take); Horizon config is independent of host count except for the memcached list.
  • fact sheet C §8, item 9: NOT AVAILABLE: Horizon restart: session survival (memcached) and start-up duration.
  • Kolla images §6, item 14: memcached has no data volume and no persistence option CODE; whether every restart therefore empties the cache, with token-cache misses and lost Horizon sessions where they are kept in memcached, is NOT AVAILABLE (memcached semantics).
  • Kolla images §7: not available from the sources: Horizon regeneration time after a recreate or a settings change.
  • Known bugs and limitations, Open questions and Findings have no entry on Horizon.

Service card

The rows of the card are explained on the Components page.

Item Value
Play site.yml:806
Tags horizon
Play host patterns horizon
Node types in play (example inventory) control
Node types running its containers control
Containers horizon
deploy/reconfigure flow (tasks/deploy.yml) config → check-containers → clone (if) → bootstrap (if) → flush handlers
Task files bootstrap.yml, bootstrap_service.yml, check-containers.yml, check.yml, clone.yml, config.yml, copy-certs.yml, deploy-containers.yml, deploy.yml, loadbalancer.yml, main.yml, policy_item.yml, precheck.yml, pull.yml, reconfigure.yml, stop.yml, upgrade.yml
Templates custom_local_settings.j2, horizon.conf.j2, horizon.json.j2, local_settings.j2
Handlers (definition order) Restart horizon container
Key variables enable_horizon, enable_horizon_*, horizon_backend_database
Role dependencies common (meta)