Skip to content

Barbican

This page is the starting point for Barbican, the barbican role: the containers barbican_api, barbican_keystone_listener and barbican_worker, on the control nodes of the example inventory, selected by the tag barbican (site.yml:765; group barbican is a child of control, inventory/multinode:146-147). Its DB sync (bootstrap_barbican, run_once, roles/barbican/tasks/bootstrap_service.yml:2-20) runs on every deploy and reconfigure, and barbican_crypto_key comes from passwords.yml (etc/kolla/passwords.yml:56, rendered as kek in roles/barbican/templates/barbican.conf.j2:45) CODE (Component dependencies §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 barbican tag, and the tag has no row of its own in Tags §3 or in the Tag index. What the study says about running it is in fact sheet D: the plays the tag selects (§1.1) and the task flow per action (§1.3).

Dependencies

Evidence

Before and after a run

  • Pre-execution checklist, step 8 (rollback material): previous /etc/kolla/config, globals.yml, passwords.yml and inventory under git.
  • fact sheet D §1.6: the crypto KEK lives in passwords.yml (barbican_crypto_key); this key must be in the passwords.yml backup.
  • fact sheet D §1.3: reconfigure = deploy, so keystone registration and the DB bootstrap container re-run on every reconfigure.
  • R2, precautions for enabling or disabling a service that has a logrotate or fluentd input entry (enable_X for most OpenStack services, e.g. barbican, roles/common/defaults/main.yml:141-142): treat enable_* changes as fleet-wide changes; roll out with --limit batches; apply the common side deliberately with -t common. In 2023.1 td-agent.conf and logrotate.conf change only when the common play runs (an untagged run or -t common, site.yml:86-97), not under -t barbican CODE.
  • Reconfigure Nova §3, row enable_barbican: yes (Barbican not even deployed): nova.conf is rewritten everywhere (adds [barbican], roles/nova/templates/nova.conf.j2:204-209, roles/nova-cell/templates/nova.conf.j2:246-251); all nova containers restart, libvirt included on every compute; td-agent.conf and logrotate.conf change too, but fluentd, cron and kolla_toolbox restart only at the next run of the common play, not under -t nova CODE.

Known limits and open points

  • What is not known: the sources do not establish whether a [barbican] section rendered before Barbican exists has any effect before encrypted volumes are used.
  • Execution flow §2.2: Barbican comes after Nova, Cinder and Glance in the deployment order; with enable_barbican, Nova and Cinder render a [barbican] section, and on a first deploy they start configured with it before Barbican exists CODE.
  • fact sheet D §1.6, "Operationally notable", four points: the crypto KEK lives in passwords.yml (NOT AVAILABLE: whether losing or changing barbican_crypto_key makes stored secrets undecryptable); p11_crypto: the library path is not mounted into the containers and no task generates the MKEK or HMAC keys (NOT AVAILABLE: what else an HSM setup needs); running kolla-ansible deploy -t barbican alone does not run the keystone play, so the barbican_notifications topic is not enabled in keystone.conf (NOT AVAILABLE: whether barbican-keystone-listener then receives project-deletion events); copying the policy file uses become: true. All four still hold in 2023.1 CODE: etc/kolla/passwords.yml:56; barbican.conf.j2:32-40 sets library_path, mkek_label and hmac_label while no barbican task or volume refers to barbican_library_path (group_vars/all.yml:927); the topic is enabled from the keystone role (roles/keystone/defaults/main.yml:200-201); roles/barbican/tasks/config.yml copies with become: true.
  • fact sheet D §7, item 15: Barbican and other bootstraps (octavia, manila, ceilometer, masakari, zun, cyborg) re-run their DB sync container on every deploy/reconfigure.
  • F5, "reconfigure = deploy": a reconfigure re-runs Keystone registration, DB creation/grants and the DB-sync bootstrap containers of most services CODE.
  • What is not known: fact sheet D has its own NOT AVAILABLE list, and its §1.6 is among the sections that contain NOT AVAILABLE marks.
  • Known bugs and limitations, Open questions and Findings have no entry on Barbican.

Service card

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

Item Value
Play site.yml:765
Tags barbican
Play host patterns barbican-api, barbican-keystone-listener, barbican-worker
Node types in play (example inventory) control
Node types running its containers control
Containers barbican_api, barbican_keystone_listener, barbican_worker
deploy/reconfigure flow (tasks/deploy.yml) register → config → check-containers → clone (if) → bootstrap → flush handlers
Task files bootstrap.yml, bootstrap_service.yml, check-containers.yml, clone.yml, config.yml, config_validate.yml, copy-certs.yml, deploy-containers.yml, deploy.yml, loadbalancer.yml, main.yml, precheck.yml, pull.yml, reconfigure.yml, register.yml, stop.yml, upgrade.yml
Templates barbican-api.ini.j2, barbican-api.json.j2, barbican-keystone-listener.json.j2, barbican-worker.json.j2, barbican.conf.j2
Handlers (definition order) Restart barbican-api container; Restart barbican-keystone-listener container; Restart barbican-worker container
Key variables enable_barbican, barbican_crypto_key (passwords.yml)
Role dependencies none
  • fact sheet D §1 — the per-role evidence: plays, services, task flow, config files and dependencies
  • Keystone — -t barbican alone does not run the keystone play, so the barbican_notifications topic is not enabled in keystone.conf
  • Nova — the compute nova.conf changes when barbican is enabled
  • Common: fluentd, cron, kolla_toolbox — enabling a service such as barbican changes td-agent.conf and/or logrotate.conf on every host of the common play, when that play runs
  • Why a small change creates a large workload — enable_<new service>: yes changes fluentd/logrotate on every host and nova.conf sections on every compute
  • Components — the other component pages