Skip to content

Stop and destroy

Impact Critical

Lumo holds a lantern forward and raises a palm in a careful gesture.

Lumo: pause here

This page covers an operation rated Critical in the risk register. Read its risks before you run anything, and try it on a test platform first.

The command lines of kolla-ansible stop and kolla-ansible destroy, which the study files under "dangerous". What each one stops or removes is described in the sections listed under Related.

Caution

The risk register rates both commands Critical: kolla-ansible stop (R15) and kolla-ansible destroy (R16). For destroy, the precaution of R16 is "Never on production; there is no --limit safety net beyond what you pass".

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   # never on production
  • Both refuse to run without --yes-i-really-really-mean-it CODE (kolla-ansible tools/kolla-ansible:452-470, :519-531). stop runs site.yml with kolla_action=stop, so -t and --limit narrow it; destroy runs destroy.yml (kolla-ansible tools/kolla-ansible:280, :454, :521).
  • stop honours skip_stop_containers (e.g. -e '{"skip_stop_containers": ["nova_libvirt"]}') CODE (roles/service-stop/tasks/main.yml:10-12, default [] in group_vars/all.yml:784).
  • destroy also removes the images with --include-images (or enable_destroy_images: yes, default no), and the dev-mode repositories under kolla_dev_repos_directory with --include-dev CODE (kolla-ansible tools/kolla-ansible:455-460; roles/destroy/defaults/main.yml:2-3, group_vars/all.yml:775, roles/destroy/tasks/cleanup_images.yml:5; kolla-ansible tools/cleanup-host:92-95).
  • R15 — kolla-ansible stop: it stops all Kolla containers on the targeted hosts, and MariaDB then needs mariadb_recovery
  • R16 — kolla-ansible destroy: what it removes on the targeted hosts, the deploy host included
  • Fact sheet E §6 — destroy in detail: destroy.yml, the destroy role and the tools/cleanup-* scripts
  • Fact sheet E §11 — the confirmation guard --yes-i-really-really-mean-it
  • Execution flow §4 — the row stop of the action matrix
  • Fact sheet B §1.8 — item 4: after stop, the next deploy or reconfigure fails until mariadb_recovery is run
  • Database operations — the mariadb_recovery command