Skip to content

Placement

This page is the starting point for Placement, the placement role: one container, placement_api, on the control nodes of the example inventory, selected by the tag placement. Its bootstrap container runs the DB sync and the online data migrations on every deploy and reconfigure (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

Impact and risk

Dependencies

Evidence

Before and after a run

  • Tags §3.1, row <svc> API service: safe on its own "yes, it is the intended unit; it still runs Keystone registration and DB sync"; batch with ANSIBLE_SERIAL. Prerequisites: MariaDB, RabbitMQ, memcached, Keystone (registration), HAProxy VIP.
  • fact sheet C §2.8: rotating placement_keystone_password needs a reconfigure of placement and nova (all computes) and neutron; in 2023.1 cyborg also renders it, when enabled (enable_cyborg, default no) CODE (roles/placement/templates/placement.conf.j2:36, roles/nova/templates/nova.conf.j2:183, roles/nova-cell/templates/nova.conf.j2:225, roles/neutron/templates/neutron.conf.j2:192, roles/cyborg/templates/cyborg.conf.j2:38; group_vars/all.yml:662).
  • 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 container stop timeout, in 2023.1 the 60 s of docker_graceful_timeout written into each container's systemd unit: drain long operations before restarts; raise docker_graceful_timeout if needed (it reaches the unit on the next restart).
  • Reconfigure a single service §3, verification of -t <svc> reconfigure: before, kolla-ansible -t <svc> genconfig, then kolla_set_configs --check in each <svc> container and a diff of /etc/kolla/haproxy/services.d/<svc>*.cfg against the previous version; after, openstack endpoint list --service <name> is unchanged for each Keystone service the role registers, the API answers through the VIP, the container start times show which hosts restarted, and docker ps --filter name=haproxy shows whether HAProxy restarted.

Known limits and open points

  • Known bugs and limitations, second row site.yml: placement haproxy include lacks when: enable_placement (site.yml:243-246). Status: CODE.
  • Q14, answered from the source CODE: Placement's KOLLA_BOOTSTRAP runs db sync + online_data_migrations on every deploy/reconfigure (roles/placement/tasks/bootstrap_service.yml:10-12, deploy.yml:11; kolla docker/placement/placement-api/extend_start.sh:5-9).
  • F15, "What the bootstrap containers run differs per image": Placement's KOLLA_BOOTSTRAP container also runs online_data_migrations, on every deploy/reconfigure CODE.
  • 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, row on upstream Nova behaviour when a dependency is missing: for Placement, the sources do not establish whether scheduling stops while it restarts.
  • Nova deep dive §3, item 4: Placement serves the scheduler's allocation candidates and nova-compute's resource-provider updates; NOT AVAILABLE whether scheduling stops and computes log errors without it.
  • fact sheet C §2.8, "Operational notes and the relation to nova", three points: consumers authenticate as the placement user; NOT AVAILABLE (upstream nova): how scheduling and the nova-compute resource tracker periodic task behave during a placement-api outage or restart; the upgrade db sync and online data migrations run while the old placement-api is still serving.
  • Kolla images §6, item 6: Placement's online data migrations run on every deploy/reconfigure, inside bootstrap_placement, and twice on upgrade (bootstrap_placement with KOLLA_BOOTSTRAP, then again with KOLLA_OSM, roles/placement/tasks/upgrade.yml:11,16-34); a tag change applied with deploy therefore runs them CODE.

Service card

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

Item Value
Play site.yml:532
Tags placement
Play host patterns placement-api
Node types in play (example inventory) control
Node types running its containers control
Containers placement_api
deploy/reconfigure flow (tasks/deploy.yml) register → clone (if) → config → check-containers → bootstrap → flush handlers
Task files bootstrap.yml, bootstrap_service.yml, check-containers.yml, check.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 migrate-db.rc.j2, placement-api-wsgi.conf.j2, placement-api.json.j2, placement.conf.j2
Handlers (definition order) Restart placement-api container
Key variables enable_placement
Role dependencies none