Skip to content

Operations

An open wooden workshop with brass server machinery, tools and an unmarked parchment plan.

What Kolla-Ansible Ussuri commands do when they run against a live platform, read from the source of the unmodified site.yml, its roles and Ansible 2.9.27. Nothing was run against a host.

Real kolla-ansible (Ussuri) invocations with what they select, their scope and their impact.

Note

Key answers

Operations catalogue

One row per operation page, in the order of the navigation. The commands are copied from each page. The impact classes are defined in Operation impact classes. The risk numbers are those the page cites, in its text or in its "Related" list.

Operation Commands covered Impact Risks
Pre-execution checklist kolla-ansible genconfig
docker exec -u root <c> /usr/local/bin/kolla_set_configs --check
kolla-ansible pull
kolla-ansible mariadb_backup
and the openstack checks of its steps 5 and 6
writes-config –
Predict and inspect a run EXTRA_OPTS="--list-tags" kolla-ansible -i multinode deploy
EXTRA_OPTS="--list-hosts" kolla-ansible -i multinode -t nova reconfigure
EXTRA_OPTS="--list-tasks" …
kolla-ansible -i multinode genconfig [-t <svc>] [--limit <hosts>]
docker exec -u root <container> /usr/local/bin/kolla_set_configs --check; echo $?
EXTRA_OPTS="--check --diff" kolla-ansible … reconfigure
kolla-ansible -i multinode prechecks [-t <svc>]
read-only, writes-config –
Reconfigure a single service kolla-ansible -i multinode -t keystone reconfigure
kolla-ansible -i multinode -t nova --skip-tags haproxy reconfigure
restarts-on-drift R8, R19, R20, R23, R24
Reconfigure Nova kolla-ansible -i multinode -t nova reconfigure
kolla-ansible -i multinode -t nova-api reconfigure
kolla-ansible -i multinode -t nova-cell reconfigure
restarts-on-drift R1, R2, R3, R24
Reconfigure Neutron kolla-ansible -i multinode -t neutron reconfigure
kolla-ansible -i multinode -t neutron reconfigure --limit network01
kolla-ansible -i multinode -t openvswitch reconfigure --limit compute042
restarts-on-drift, critical R5, R6, R7
Apply common changes (fluentd, cron, kolla_toolbox) kolla-ansible -i multinode -t chrony reconfigure
kolla-ansible -i multinode -t chrony reconfigure --limit 'compute[0:49]'
restarts-on-drift R2, R25
Write config first, apply in controlled batches kolla-ansible -i multinode -t nova-cell genconfig
kolla-ansible -i multinode -t nova-cell deploy-containers --limit 'compute[0:9]'
kolla-ansible -i multinode -t nova-cell deploy-containers --limit 'compute[10:19]'
ANSIBLE_SERIAL=10 kolla-ansible -i multinode -t nova reconfigure
writes-config, restarts-on-drift R1
Update container images kolla-ansible -i multinode pull
kolla-ansible -i multinode -t nova pull --limit compute
kolla-ansible -i multinode upgrade
ANSIBLE_SERIAL=20 kolla-ansible -i multinode -t nova upgrade
pulls-images, recreates-containers, critical R7, R11, R12, R13
Add a compute node kolla-ansible -i multinode bootstrap-servers --limit compute501
kolla-ansible -i multinode pull --limit compute501
kolla-ansible -i multinode deploy --limit compute501
– R14, R23
Change control-plane membership no command line in its command section; its scenario reads -t nova,neutron reconfigure restarts-on-drift, maintenance-window R3, R4
Database operations kolla-ansible -i multinode mariadb_backup
kolla-ansible -i multinode mariadb_recovery
recovery R18
Stop and destroy kolla-ansible -i multinode stop --yes-i-really-really-mean-it -t heat --limit control03
kolla-ansible -i multinode destroy --yes-i-really-really-mean-it
critical R15, R16
Command quick lookup by tag -t <tag> reconfigure for 12 tags
reconfigure (no tag)
deploy-containers -t X
genconfig -t X
pull -t X
restarts-on-drift, writes-config, pulls-images by tag, in the "Risks" bullet of the component pages

Assumed deployment

Every scenario assumes the same deployed state: 3 controllers, 2 network nodes, 3 computes, 1 storage node and 1 monitoring node, with Keystone, Glance, Placement, Nova, Neutron/OVS, Cinder/LVM, Heat and Horizon.

Conventions used by the command sections

These two lists apply to the command sections of every operation page and to the Command quick lookup by tag.

The examples assume:

  • the inventory is /etc/kolla/multinode (adapt -i);
  • globals.yml and passwords.yml are in /etc/kolla;
  • Ansible is 2.9.

Conventions:

  • Scope = plays and hosts touched.
  • Restarts = containers that can restart (only if drift is detected).
  • One-shot = bootstrap containers that run regardless of drift.

Drift

Drift means what compare_container detects: a changed image or container parameter, or kolla_set_configs --check exiting 1 (library/kolla_docker.py:326-332; Kolla images §3).

Code guarantees and environment dependence

On the operation pages:

  • The code guarantees = what Kolla will do (tasks, restarts) given the inputs.
  • Depends on the environment = what that does to VMs and APIs; mostly NOT AVAILABLE in these sources.

These two notions head the columns of the tables in Reconfigure Nova §5 ("Guaranteed by code", "Depends on environment") and Reconfigure Neutron §4 ("code-guaranteed", "environment-dependent").

The evidence labels CODE and NOT AVAILABLE are defined once, in the Conventions and evidence labels.

Three mechanisms that explain almost every surprise

Three mechanisms explain almost every surprise on the operation pages, so they are restated here, each with the section that establishes it:

  1. Config drift ⇒ full container stop/start. It is never a reload. The stop timeout is effectively 10 s (Repository architecture §6).
  2. Loop-notify. One changed container in a role's loop restarts every container of that role on that host (Tags §2.4).
  3. Global inputs. enable_* flags, group membership and passwords are rendered into per-host files on every host (Component dependencies §5).