Source: HA Ansible Role oficial (limitada aplicabilidad)¶
Repo Ansible "oficial" del ecosistema HA. Caveat crítico: targetea el install method ../entities/home-assistant-core (Python venv) que está deprecated desde 2025.12. No aplicable al setup del usuario (HAOS Yellow). Lo registramos para contexto pero el camino de IaC del usuario va por otro lado: Ansible para el HOST (Docker + Mosquitto + observability stack), no para HA en sí.
Por qué entró al wiki (a pesar de la baja aplicabilidad)¶
- Es el role "oficial" del ecosistema HA — relevant for completeness.
- Confirma que no hay un role oficial para HAOS (que es appliance, no se Ansible-iza).
- Negativo informativo: si querés IaC riguroso del componente HA mismo, vas a tener que armarlo.
Páginas derivadas¶
- ../analysis/q3-iac-strategy-v1 — el plan IaC real para el setup del usuario, que NO usa este role.
Take-aways¶
- Targets HA Core install method (deprecated tras 2025.12).
- Variables:
ha_venv,ha_user,ha_port,pkgs. - Fedora-first, Debian compatible.
- Sin dependencies declaradas.
- README explícito: "non-generic, especially for HA + Fedora".
Por qué NO sirve para el usuario¶
- El user corre HAOS (appliance) en el Yellow → no se gestiona vía Ansible.
- Para el track Container futuro, Ansible apunta al host Docker, no al venv de HA.
Path real de IaC para el usuario (resumen, expandido en analysis)¶
| Componente | IaC tool | Notas |
|---|---|---|
| HA Yellow host | (nada — es appliance) | Solo backups automatizados |
| HA config | git repo + scp / hass-cli | Patrón Beguelin |
| Mini-PC host | Ansible role custom | Instala Docker + Loki + Prometheus + agente |
| Docker Compose services en mini-PC | Compose YAML en git + auto-pull | Pin de versiones |
| Z2M config | Ansible template + restart trigger | Custom |
| ESPHome configs | git repo + esphome CLI | Build + flash declarativo |
| Prometheus + Grafana dashboards | YAML / JSON en git | Provisioned, not UI-edited |
Source candidato mejor para próxima iteración¶
Bellack.dev y bellackn/ansible-role-hass-control (en candidatos media): role que gestiona configs vía HA API, no install. Mejor fit para el path del usuario.
Abierto / gaps¶
- Ingerir
bellackn/ansible-role-hass-control(en candidatos alta de la lista original). - Patrón de Ansible role para HAOS host — ¿existe? La superficie es muy chica (sólo SSH addon + backups). Probable que sea custom roleable.
- Patrón concreto para Z2M deploy declarativo vía Ansible (templating configuration.yaml + restart del add-on).