feat(bash/infra): servicios systemd locales — 6 funciones atómicas + 1 pipeline

Nuevas primitivas para gestionar servicios systemd del sistema desde
el registry (antes solo había versiones remotas via SSH para deploy VPS):

  bash/functions/infra/
    systemd_local_install_unit   — escribir unit en /etc/systemd/system + daemon-reload
    systemd_local_enable         — systemctl enable
    systemd_local_start          — systemctl start + MainPID
    systemd_local_restart        — systemctl restart + MainPID
    systemd_local_status         — ActiveState/SubState/pid/enabled + journal tail (no sudo)
    systemd_local_uninstall      — stop + disable + rm unit + daemon-reload (idempotente)

  bash/functions/pipelines/
    install_systemd_service      — pipeline que compone las anteriores; args
                                    --name --exec [--workdir --user --env KEY=VAL
                                    --after --restart --type]

Requisito: sudo sin password para systemctl + escritura en /etc/systemd/system/.
En WSL: systemd=true en /etc/wsl.conf.

Registrado sqlite_api como servicio del sistema con este pipeline, queda
vivo al arrancar WSL. Dashboard ya no necesita arrancar la API manualmente.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-24 14:02:54 +02:00
parent 350d3341f6
commit c7ae46f86c
14 changed files with 619 additions and 0 deletions
@@ -0,0 +1,58 @@
---
name: systemd_local_install_unit
kind: function
lang: bash
domain: infra
version: "1.0.0"
purity: impure
signature: "systemd_local_install_unit(name: string, unit_content: string) -> json"
description: "Instala un unit file de systemd en /etc/systemd/system/<name>.service y ejecuta daemon-reload. Requiere sudo sin password para install y systemctl. Sobrescribe si el unit ya existe."
tags: [systemd, service, local, infra, wsl]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
- name: name
desc: "nombre del servicio sin sufijo (se añade .service automáticamente)"
- name: unit_content
desc: "contenido completo del archivo unit como texto (con secciones [Unit], [Service], [Install])"
output: "JSON {name, path, installed:true}. Errores a stderr, exit 1."
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/infra/systemd_local_install_unit.sh"
---
## Ejemplo
```bash
source bash/functions/infra/systemd_local_install_unit.sh
unit=$(cat <<'EOF'
[Unit]
Description=my service
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/my_service
Restart=on-failure
[Install]
WantedBy=multi-user.target
EOF
)
systemd_local_install_unit "my_service" "$unit"
# {"name":"my_service","path":"/etc/systemd/system/my_service.service","installed":true}
```
## Notas
- Usa `install -m 0644 -o root -g root` para escribir el unit con permisos correctos.
- Llama a `sudo systemctl daemon-reload` al final — imprescindible para que systemd vea el unit.
- No hace `enable` ni `start` — esas son funciones separadas (principio de composabilidad).
- En WSL requiere `systemd=true` en `/etc/wsl.conf`.