Skip to content

Add a compute node

How to add a compute node with bootstrap-servers, pull and deploy, each with --limit on the new host, and what deploy --limit then touches: it creates the containers of the new compute, delegates tasks to the controllers, gathers facts for all hosts, and does not touch existing computes apart from the delegated setup. The page gives no verification steps for the new compute.

The scenario section is written for the assumed deployment, with compute004 as the new host.

Warning

Existing hosts' /etc/hosts is not updated (bootstrap-servers --limit), and a full bootstrap-servers run carries its own Docker-restart risk (R14) — see the caveats in §2.

1. Commands

1.1 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

Details in §2.

  • Facts for all hosts are still gathered, sequentially from compute501 (gather-facts.yml:30-54; loop items run one after another, ansible-core 2.14.18 lib/ansible/executor/task_executor.py:259-335). Enable fact caching for large inventories: with cached facts the delegated setup is skipped (gather-facts.yml:52-53).
  • Discovery runs from the first compute of the batch, delegated to nova-conductor[0]. That host is outside the limit, but delegate_to works: Ansible looks the delegated host up in the whole inventory CODE (ansible-core 2.14.18 lib/ansible/vars/manager.py:611-625, lib/ansible/inventory/manager.py:197-198).
  • /etc/hosts on existing hosts is not updated with the new compute (bootstrap-servers was limited; in 2023.1 the file is written by the openstack.kolla.etc_hosts role of ansible-collection-kolla, run by openstack.kolla.baremetal on the play hosts only: ansible-collection-kolla roles/baremetal/tasks/main.yml:2-3, roles/etc_hosts/tasks/etc-hosts.yml:25-37; kolla-host.yml:4-10). Live migration with libvirt_tls (hostname-based) and RabbitMQ name resolution may need a full bootstrap-servers run later (fact sheet E §3).

2. Add a compute node

CODE deploy --limit compute004 (after bootstrap-servers --limit and pull --limit), read from the plays and task files:

  • On compute004: 10 containers created, one per compare_container item of a compute: fluentd, kolla_toolbox, cron (common), iscsid (enable_iscsid follows the Cinder LVM backend), openvswitch_db, openvswitch_vswitchd, neutron_openvswitch_agent, nova_libvirt, nova_ssh, nova_compute (roles/common/defaults/main.yml:4, :13, :25; roles/iscsi/defaults/main.yml:4, group_vars/all.yml:653-654, :700; roles/openvswitch/defaults/main.yml:4, :20; roles/nova-cell/defaults/main.yml:3-18, :53-55; groups in inventory/multinode). The Ussuri count of 11 included chrony, which has no role in 2023.1 (Compute scaling §2). The number of task results is NOT AVAILABLE.
  • Elsewhere (via delegate_to):
    • a Neutron bootstrap (DB sync) container on control01 (roles/neutron/tasks/bootstrap_service.yml:2-21);
    • nova-manage cell_v2 list_cells (one-shot nova_list_cells container) and discover_hosts (through kolla_container_engine exec nova_conductor) on control01 (roles/nova-cell/tasks/discover_computes.yml:4-23, get_cell_settings.yml:2-21);
    • openstack compute service list through kolla_toolbox on control01, retried up to 20 times every 10 s until the new compute's service is registered (roles/nova-cell/tasks/wait_discover_computes.yml:8-43).
  • Facts: gathered for all 12 hosts (the 10 of the assumed deployment, compute004 and the localhost of [deployment], inventory/multinode:32-33). The new compute itself runs the delegated setup loop sequentially (gather-facts.yml:30-54).
  • Not touched: existing computes, apart from the delegated setup above. Controllers get no config writes or restarts, only delegated tasks: those listed above, the fact gathering above (setup on all three controllers), and the Neutron DB and DB-user tasks (mysql_db, mysql_user run through kolla_toolbox) on control01 (roles/neutron/tasks/bootstrap.yml:2-36).
  • Caveats:
    • Existing hosts' /etc/hosts is not updated (bootstrap-servers --limit).
    • With libvirt_tls: true (hostname-based migration), the other computes' /etc/hosts lacks the new host until a full bootstrap-servers run, which carries its own Docker-restart risk (R14). NOT AVAILABLE Whether live migration to it fails meanwhile (fact sheet E §3).
  • Risk register — R14 (bootstrap-servers re-run on a live host), which this page names, and R23 (any run with --limit on a large inventory)
  • Nova — service cards of the roles nova and nova-cell, and where to look
  • Pre-execution checklist — the checks before every production run
  • Compute scaling §2 — work per compute host, read from the task files: the compare_container items of a compute (10 in 2023.1, §2)
  • Execution flow §2.4 — compute node deployment: what one compute host experiences
  • Fact sheet E §3 — /etc/hosts generation
  • Reconfigure Nova §6 — the checks listed after a Nova run (openstack compute service list, nova-manage cell_v2 list_hosts); this page lists none