Cómo verificamos

Qué es un gotcha

Un hecho verificable sobre una nube, su consecuencia práctica y qué hacer al respecto. No es una opinión ni un ranking: si algo es más simple o barato en una nube, el texto dice qué se paga en otro lado.

Fuentes aceptadas

Cada gotcha necesita al menos una fuente de documentación oficial. El build falla si una fuente no pertenece a estos dominios:

• learn.microsoft.com
• azure.microsoft.com
• docs.aws.amazon.com
• aws.amazon.com
• repost.aws
• cloud.google.com
• docs.cloud.google.com
• registry.terraform.io
• developer.hashicorp.com
• docs.github.com

Blogs, foros y videos sirven para descubrir un problema, no para respaldarlo.

Frescura

Cada gotcha tiene la fecha en que alguien leyó sus fuentes y confirmó el texto (verified_at). A los 180 días se marca "re-verificar" y un workflow semanal mantiene un issue con la lista. Re-verificar un gotcha es la contribución más valiosa del proyecto.

Qué garantiza el sitio y qué no

Los chequeos automáticos garantizan que cada gotcha tiene una fuente oficial, una fecha y que el Terraform compila. No garantizan que lo que dice el gotcha sea cierto: eso lo confirma una persona leyendo la fuente. Hoy los gotchas los verifica el mantenedor; los que no tienen revisor externo lo dicen en su tarjeta ("sin revisor externo"). Cuando alguien con experiencia en esa nube los revisa, la tarjeta muestra su usuario de GitHub.

Si encontrás un error, usá "Reportar desactualizado" en la tarjeta. Si querés revisar una nube, mirá CONTRIBUTING.

Qué se chequea en cada PR

terraform fmt -check

Formato canónico.

terraform validate

Contra el schema real del provider pinneado (detecta atributos renombrados entre versiones).

terraform test

Con mock_provider: aserciones sobre lo que el patrón promete, sin credenciales ni recursos reales.

tflint

Ruleset de cada nube (SKUs, regiones, argumentos).

checkov

Cero fallas. Cada excepción va en el código con su motivo y se ve en el snippet publicado.

lychee

Todas las fuentes oficiales siguen respondiendo.

Limitación: los tests con mock providers no detectan errores que solo aparecen al aplicar contra la API real (cuotas, nombres tomados, disponibilidad regional). Usá los módulos como punto de partida revisado, no como un despliegue certificado.