ilia/ansible
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
ansible/roles/app_setup
History
ilia f5e32afd81
Some checks failed
CI / lint-and-test (pull_request) Failing after 1m20s
Details
CI / ansible-validation (pull_request) Successful in 6m40s
Details
CI / secret-scanning (pull_request) Successful in 2m36s
Details
CI / dependency-scan (pull_request) Successful in 6m12s
Details
CI / sast-scan (pull_request) Successful in 6m48s
Details
CI / license-check (pull_request) Successful in 1m16s
Details
CI / vault-check (pull_request) Failing after 6m13s
Details
CI / playbook-test (pull_request) Successful in 6m34s
Details
CI / container-scan (pull_request) Successful in 6m57s
Details
CI / sonar-analysis (pull_request) Failing after 1m10s
Details
CI / workflow-summary (pull_request) Successful in 1m11s
Details
Add POTE app project support and improve IP conflict detection 
- Add roles/pote: Python/venv deployment role with PostgreSQL, cron jobs
- Add playbooks/app/: Proxmox app stack provisioning and configuration
- Add roles/app_setup: Generic app deployment role (Node.js/systemd)
- Add roles/base_os: Base OS hardening role
- Enhance roles/proxmox_vm: Split LXC/KVM tasks, improve error handling
- Add IP uniqueness validation: Preflight check for duplicate IPs within projects
- Add Proxmox-side IP conflict detection: Check existing LXC net0 configs
- Update inventories/production/group_vars/all/main.yml: Add pote project config
- Add vault.example.yml: Template for POTE secrets (git key, DB, SMTP)
- Update .gitignore: Exclude deploy keys, backup files, and other secrets
- Update documentation: README, role docs, execution flow guides

Security:
- All secrets stored in encrypted vault.yml (never committed in plaintext)
- Deploy keys excluded via .gitignore
- IP conflict guardrails prevent accidental duplicate IP assignments
2025-12-28 20:52:45 -05:00
..
defaults
Add POTE app project support and improve IP conflict detection
2025-12-28 20:52:45 -05:00
handlers
Add POTE app project support and improve IP conflict detection
2025-12-28 20:52:45 -05:00
tasks
Add POTE app project support and improve IP conflict detection
2025-12-28 20:52:45 -05:00
templates
Add POTE app project support and improve IP conflict detection
2025-12-28 20:52:45 -05:00
README.md
Add POTE app project support and improve IP conflict detection
2025-12-28 20:52:45 -05:00

README.md

app_setup

Creates the standard app filesystem layout and runtime services:

  • /srv/app/backend and /srv/app/frontend
  • /srv/app/.env.<dev|qa|prod>
  • /usr/local/bin/deploy_app.sh (git pull, install deps, build, migrate, restart services)
  • systemd units:
    • app-backend.service
    • app-frontend.service

All behavior is driven by variables so you can reuse this role for multiple projects.

Variables

See defaults/main.yml. Common inputs in the app stack:

  • app_project, app_env (used for naming and .env.<env> selection)
  • app_repo_url, app_repo_dest, app_repo_branch
  • app_env_vars (map written into /srv/app/.env.<env>)
  • components.backend, components.frontend (enable/disable backend/frontend setup)
  • app_backend_dir, app_frontend_dir, ports and Node.js commands