Mejores Prácticas para la Nube y Serverless

Sintonización de arranques en frío, observabilidad y barreras de control de costos.

Aplique estas reglas en las plantillas de CI, los archivos README de servicio y las revisiones de plataforma para que cada implementación de Go obtenga una latencia, facturas y respuesta a incidentes predecibles.

Cómo Usar Esta Lista

Adopte los elementos de Nivel A antes del tráfico de producción en cualquier plataforma nueva.
Integre la observabilidad de Nivel B en los paneles y alertas durante la primera semana de implementación.
Revise las reglas de costos mensualmente: las facturas de serverless sorprenden a los equipos cuando los valores predeterminados de concurrencia o memoria se desvían.

A - Arranque en frío y empaquetado

Compile cruzado con CGO_ENABLED=0 para Lambda y contenedores mínimos. Evita sorpresas del enlazador dinámico en los tiempos de ejecución proporcionados.
Elimine binarios con -ldflags="-s -w" a menos que necesite símbolos de Delve en desarrollo. Los zips más pequeños se cargan más rápido en el arranque en frío.
Nombre los artefactos de Lambda bootstrap en la raíz del zip para provided.al2023. Los nombres incorrectos fallan en tiempo de ejecución con errores opacos.
Inicialice de forma diferida los clientes de AWS/GCP con sync.Once, no en init(). Mantiene las rutas de código no utilizadas fuera de la ruta de arranque en frío.
Compare arm64 vs amd64 para su árbol de dependencias. Graviton a menudo gana para Go, pero verifique antes del cambio a toda la flota.
Mantenga las imágenes de contenedor por debajo de unos pocos cientos de MB. Las capas grandes ralentizan los arranques en frío de Cloud Run y ACA.

B - Manejadores y corrección

Diseñe para entrega al menos una vez en colas y webhooks. Las claves idempotentes y las tiendas de deduplicación son obligatorias.
Pase context.Context de la plataforma a todas las llamadas SDK. Respeta los plazos de API Gateway, Cloud Run y desconexión del cliente.
Limite el trabajo con context.WithTimeout ligeramente por debajo de los límites de la plataforma. Devuelva errores estructurados antes de las finalizaciones forzadas.
Evite el disco local mutable excepto /tmp en Lambda. Trate el almacenamiento de la instancia como efímero.
Reutilice grupos de bases de datos entre invocaciones cálidas; dimensione los grupos según la concurrencia. Previene tormentas de conexiones después de eventos de escalado.
Devuelva errores distintos para fallos reintentables frente a fallos terminales. Impulsa el comportamiento de DLQ y la calidad del ruido de las alertas.

C - Seguridad e identidad

Nunca confirme claves de acceso a la nube de larga duración en git o imágenes. Utilice roles de ejecución, identidad de carga de trabajo, identidad administrada.
Alcance IAM a prefijos de ARN de recursos por servicio. Rechace políticas de administrador * en identidades de tiempo de ejecución.
Recupere secretos de Secrets Manager / Secret Manager en tiempo de ejecución. Almacene en caché en memoria con conocimiento de rotación.
Habilite el cifrado en reposo en los buckets que contienen datos de usuario. Políticas de bucket predeterminadas o SSE-KMS en prefijos sensibles.
Requiera autenticación en servicios HTTP públicos a menos que sea explícitamente una demostración de estado. Bloquee los valores predeterminados de --allow-unauthenticated después de picos.
Ejecute govulncheck en módulos que toquen SDKs de la nube. Los problemas de la cadena de suministro aterrizan primero en las rutas de credenciales y HTTP.

D - Observabilidad

Emita registros JSON con log/slog a stdout/stderr. CloudWatch, Cloud Logging y App Insights analizan campos estructurados.
Incluya el ID de solicitud, el ID de traza y la bandera de arranque en frío en los atributos de registro. Separa los incidentes de latencia cálida vs. fría.
Exporte métricas RED: tasa, errores, duración por ruta y por dependencia. Prometheus o agentes del proveedor en contenedores; extensiones Lambda cuando sea necesario.
Alerta sobre la tasa de errores y la duración p99, no solo sobre la CPU. El escalador automático serverless oculta la saturación de la CPU hasta que los tiempos de espera aumentan.
Trace las llamadas SDK salientes cuando los SLOs de latencia se vuelvan más estrictos. Existen envoltorios OpenTelemetry para aws-sdk-go-v2 y gRPC.
Registre metadatos de la plataforma (versión de la función, revisión) al inicio una vez. Acelera las decisiones de retroceso durante los incidentes.

E - Redes y resiliencia

Establezca ReadHeaderTimeout en cada http.Server en contenedores. Bloquea ataques de lentitud antes de que se ejecuten los manejadores.
Maneje SIGTERM con http.Server.Shutdown limitado. Cloud Run y ECS envían señales de terminación antes de SIGKILL.
Separe los puntos finales de salud de liveness y readiness. Detenga el tráfico sin reiniciar tareas cuando las dependencias fallen.
Documente los requisitos del conector VPC / grupo de seguridad en README. El personal de guardia no debería buscar en Terraform durante las interrupciones.
Reintente solo las operaciones SDK idempotentes; use retroceso con jitter para reintentos a nivel de aplicación. Previene bucles de amplificación en la limitación.
Configure DLQs para desencadenadores asíncronos con alarma de profundidad. Los mensajes venenosos deben aparecer en minutos.

F - Barreras de costos

Ajuste la memoria de Lambda después de las pruebas de carga: la memoria escala la CPU. El sobreaprovisionamiento duplica las facturas sin ganancias de latencia.
Establezca instancias máximas y límites de concurrencia de Cloud Run en producción. Protege las bases de datos de eventos de escala ilimitada.
Use escala a cero solo cuando los arranques en frío se ajusten a los SLOs; de lo contrario, establezca instancias mínimas. Compromiso explícito entre economía y latencia.
Elimine entornos de vista previa no utilizados y versiones de funciones obsoletas. Los recursos huérfanos se acumulan silenciosamente.
Supervise el tráfico de salida al almacenamiento de objetos y el tráfico entre zonas. La transferencia de datos a menudo excede la computación en cargas de trabajo de exportación.
Programe lotes no urgentes como trabajos, no como pods siempre activos. Las horas de Fargate se suman para el trabajo solo nocturno.

Preguntas Frecuentes

¿Cuál es la primera métrica a observar después del lanzamiento?

Latencia de extremo a extremo p99 dividida por ruta fría vs. cálida.

Si el frío domina, corrija el empaquetado y la inicialización antes de aumentar el gasto en memoria.

¿Qué tan estrictas deben ser las IAM en las cuentas de desarrollo?

El desarrollo puede ser más flexible para la velocidad, pero no debe compartir roles o secretos de producción.

Use cuentas o espacios de nombres separados con políticas paralelas.

¿Debo usar capas de Lambda para dependencias compartidas de Go?

Las capas ayudan a los equipos políglotas a compartir agentes; los binarios de Go puros rara vez necesitan capas a menos que distribuyan extensiones de observabilidad.

Prefiera primero binarios únicos más pequeños.

¿Cómo pruebo la idempotencia?

Pruebe caóticamente entregas duplicadas de SQS y reintentos de HTTP en pruebas de integración; afirme un efecto secundario visible.

¿Cuándo recurro a Kubernetes en lugar de serverless?

Cuando necesite operadores, CRDs personalizados, características de service mesh o estándares de clúster uniformes para varios equipos que las funciones administradas no pueden alojar.

¿El GC de Go afecta el dimensionamiento de la memoria de Lambda?

Sí: deje margen por encima del tamaño en vivo del heap; las muertes por OOM son más difíciles de depurar que las configuraciones de memoria ligeramente más altas.

Relacionado

Go en la Nube: Lambda, Cloud Run y Más Allá - base conceptual
Conceptos Básicos de Despliegue en la Nube - ejemplos prácticos de despliegue
Runtime Personalizado de AWS Lambda y provided.al2023 - detalles de empaquetado
Secretos, IAM e Identidad de Carga de Trabajo - postura de credenciales
Guía de Decisión de Arquitectura Serverless de Go - elección de plataforma
Respuesta a Incidentes para Servicios Go - cuando se activan las alertas

Versiones de Stack: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, modernizadores go fix - verifique el parche en la compilación), chi (última versión - verifique en la compilación), gin (última versión - verifique en la compilación), echo (última versión - verifique en la compilación), google.golang.org/grpc (última versión - verifique en la compilación), sigs.k8s.io/controller-runtime (última versión - verifique en la compilación), kubebuilder (última versión - verifique en la compilación), tinygo (última versión - verifique los objetivos de la placa en la compilación), wazero (última versión - verifique en la compilación) y golangci-lint (última versión - verifique el conjunto de linters en la compilación).