Compilar binarios

Estructura del proyecto

src/            módulos del programa
├── main.sh          punto de entrada y orquestación
├── cloudflare.sh    interacción con la API de Cloudflare
├── config.sh        parseo de la configuración YAML
├── ip.sh            detección de IP (interfaz local + servicios externos)
├── network.sh       wrapper HTTP sobre curl/wget/PowerShell
├── logger.sh        logging a consola y fichero, redacción de secretos
└── notifications.sh Telegram / Discord

tools/          herramientas de build y calidad
tests/          tests unitarios con bashunit
cloudflare-dns-updater.sh   lanzador de desarrollo (ejecuta desde el código fuente)

Monolito

Todos los módulos de src/ fusionados en un único script autocontenido:

./tools/bundle.sh
# → dist/cloudflare-dns-updater-monolith.sh

Binarios autónomos

tools/build-all.sh genera los binarios de Linux y macOS: descarga builds estáticos de bash y jq para la arquitectura objetivo, verifica cada uno contra un SHA-256 registrado, los empaqueta con el monolito y compila tools/launcher.c como ejecutor autoextraíble. No hay objetivo Windows, porque el programa necesita un Bash real y no existe ninguno empaquetable en un solo fichero.

# --all compila los objetivos Linux (x86_64 + aarch64)
./tools/build-all.sh --all

# El resto de plataformas se compilan nombrándolas explícitamente
./tools/build-all.sh macos aarch64

Requiere GCC. Los artefactos se generan en dist/.

Una descarga que falle, llegue truncada, no sea un ejecutable o no coincida con su digest registrado aborta la compilación. Actualizar una herramienta empaquetada implica cambiar tanto la versión fijada como su SHA-256 en expected_sha256().

Publicar una release

Las releases se controlan con el fichero VERSION de la raíz del repositorio:

1. Sube la versión en ambos sitios: el fichero VERSION y la constante VERSION de src/main.sh (un test unitario falla si difieren).
2. Mergea a main.

El workflow Build & Release Binaries (que solo se dispara con cambios en VERSION) compila los cinco binarios, crea el tag vX.Y.Z y publica la release de GitHub con notas autogeneradas. Ejecutar el workflow manualmente (workflow_dispatch) compila los binarios sin publicar nada.