FastFN Doctor para Dominios y CI¶

Estado verificado al 28 de marzo de 2026. Nota de runtime: FastFN auto-instala dependencias locales por función desde requirements.txt / package.json; en fastfn dev --native necesitas runtimes instalados en host, mientras que fastfn dev depende de Docker daemon activo. fastfn doctor centraliza validaciones de entorno local y readiness de dominios.

Por que importa¶

Los problemas de dominio suelen aparecer tarde: - DNS apunta al target equivocado - TLS expirado o por expirar - HTTP no redirige a HTTPS - ruta de ACME bloqueada

fastfn doctor domains permite detectarlos antes de deploy.

Inicio rapido¶

fastfn doctor
fastfn doctor --json

Chequeo de dominios:

fastfn doctor domains --domain api.midominio.com
fastfn doctor domains --domain api.midominio.com --expected-target lb.midominio.net

Salida para CI:

fastfn doctor domains --domain api.midominio.com --json

Configurar dominios en `fastfn.json`¶

{
  "domains": [
    "api.midominio.com",
    {
      "domain": "www.midominio.com",
      "expected-target": "lb.midominio.net",
      "enforce-https": true
    }
  ]
}

Luego:

fastfn doctor domains

Contrato de checks (OK/WARN/FAIL)¶

domain.format: validacion de sintaxis del host.
dns.resolve: resolucion A/AAAA/CNAME.
dns.target: match contra target esperado (si esta configurado).
tls.handshake: validez del certificado para el host.
tls.expiry: ventana de expiracion (warning cuando esta cerca).
https.reachability: respuesta HTTPS basica.
http.redirect: politica HTTP -> HTTPS.
acme.challenge: reachability de /.well-known/acme-challenge/....

Auto-fix seguro¶

fastfn doctor --fix solo aplica cambios locales seguros.

Fix actual: - crear fastfn.json minimo cuando falta.

Idea clave¶

Usá fastfn doctor domains como un chequeo previo del borde público, no como un reemplazo del health check de tu app. Te dice si el host, el destino DNS, TLS, la redirección y la ruta de ACME están bien desde afuera antes de mover tráfico.

Qué conviene tener en cuenta¶

Corré el comando después de cambios DNS, antes de renovar certificados y en CI antes de un release.
Usá --json cuando quieras salida fácil de procesar en pipelines o validaciones automáticas.
Definí expected-target solo cuando tengas claro qué destino final querés exigir.

Cuándo usar otra herramienta¶

Usá health endpoints de la app para bugs aguas adentro, fallas de base de datos o dependencias lentas.
Usá monitoreo continuo para alertas de reachability y vencimiento de certificados.
Usá fastfn doctor --fix solo para ayuda local; a propósito no cambia DNS ni TLS remotos.

Ver también¶

Última revisión: 28 de marzo de 2026 · Docs en fastfn.dev