ansible/project-docs/workflow.md

Workflow

Setup

• Install dependencies (Python requirements, Node deps for docs, Ansible collections):

make bootstrap

• Edit vault secrets:

make edit-group-vault

Validate (safe, local)

• Syntax checks:

make test-syntax

• Lint:

make lint

Common apply flows

• Servers baseline (services + qa + ansible + tailscale):

make servers
make servers GROUP=services
make servers HOST=jellyfin

• Workstations baseline (dev + desktop + local; desktop apps only on desktop group):

make workstations
make workstations GROUP=dev
make apps

Proxmox app projects

End-to-end:

make app PROJECT=projectA

Provision only / configure only:

make app-provision PROJECT=projectA
make app-configure PROJECT=projectA

Inspect Proxmox guests:

make proxmox-info PROJECT=projectA
make proxmox-info ALL=true
make proxmox-info TYPE=lxc

Safety checks

• Prefer --check --diff first:

make check

Debugging

make debug
make verbose