Skip to content

feat: dev_deployer_ui_lab - migrate to dev_deployer_ui_lab_bundles #121

Description

@hyde-repo

feat: dev_deployer_ui_lab - migrate to dev_deployer_ui_lab_bundles

Umbrella: #69
Wave: WAVE_04 (since 2026-06-05)

Migrates the dev_deployer_ui_lab scenario from its monolithic shape to the bundle-driven shape. Single-tier Docker lab on vmbr142, no admin platform, dev-focused tooling for iterating on the deployer-ui frontend. Mirror of kunai_lab_bundles (single-user lab shape).

Members

Scenario VMs Bridge Template Purpose
dev_deployer_ui_lab 1 (or as declared in manifest) vmbr142 medium-02-8g-64g (9232) iterative dev environment for range42-deployer-ui

Solution

  1. Create scenarios/dev_deployer_ui_lab_bundles/ mirroring kunai_lab_bundles/ directory layout.
  2. 01_templates-bootstrap/ : reuse the shared template 9232 (already created by other scenarios on the same Proxmox - idempotent).
  3. 02__infrastructure/ : single-tier (no admin tier). Direct stage_00 vm-bootstrap + stage_01 baseline + Docker install (the dev VM hosts a Docker daemon for running the deployer-ui stack in dev mode).
  4. Wrapper scripts : regenerate the standard set + add reset.ssh_keys.sh.
  5. Inventory + ssh-config J2 : 1-host configuration.
  6. manifest/feature_flags.yml : declare INSTALL_WAZUH=NO (default) for placeholder consistency.

Directory renames

The bundle-driven refactor applies the following dir restructure (mirror of the kunai_lab -> kunai_lab_bundles migration) :

Layer Before After
Scenario root scenarios/dev_deployer_ui_lab/ scenarios/dev_deployer_ui_lab_bundles/
Init / templates 01_init_proxmox/ (if present) 01_templates-bootstrap/
VM tier (existing path) 02_dev_deployer_ui_lab_infrastructure/ (single-tier)
Stage 00 (bootstrap) stage_00/ stage_00-vm_bootstrap/
Stage 01 (configure) stage_01/ stage_01-vm_configure/
Wrapper scripts <scenario>.<verb>.sh (5 scripts) <scenario>_bundles.<verb>.sh (6 scripts, adds reset.ssh_keys.sh)
Per-VM YAML inline replaced by bundles/core/vm-bootstrap/main.yml import
Inventory + ssh-config J2 adapted to the new structure (1-host group, no admin group)

Lab content preserved

VM names, vm_ids, IPs, bridges, templates stay byte-identical post-refactor. The scenario remains parallel-deployable alongside kunai_lab_bundles, misp_lab_bundles and others on the same Proxmox.

References

  • scenarios/kunai_lab_bundles/ - canonical reference for the single-tier Docker lab shape.
  • bundles/core/vm-bootstrap/main.yml - shared clone + cloud-init.
  • bundles/core/system-baseline-default/main.yml + Docker install via warmup role - shared baseline.

Metadata

Metadata

Assignees

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions