hamicloud
Runtime distribuido auto-alojado para servicios HTTP y trabajos finitos en Kubernetes. Usa PostgreSQL como fuente de verdad con estados durables, outbox transaccional y recuperación automática ante fallos.
Ficha actualizada 27 sept 2026, 14:08 · upstream 27 sept 2026, 12:47 · release v0.1.0
Qué es hamicloud
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
HamiCloud es un runtime distribuido auto-alojado diseñado específicamente para ejecutar servicios HTTP y trabajos de fondo finitos en entornos Kubernetes. El sistema proporciona un plano de control respaldado por PostgreSQL que incluye estados durables, intenciones de ejecución con arrendamientos acotados, eventos transaccionales de outbox y transiciones deterministas de máquinas de estado. La arquitectura se centra en límites operativos explícitos, registros de auditoría duraderos y recuperación automatizada cuando los componentes fallan.
La implementación incluye un Control API construido con FastAPI que valida entradas, registra solicitudes de inquilinos y escribe estados deseados dentro de transacciones PostgreSQL. El sistema utiliza Go para el agendamiento y ejecución de trabajos, con workers que reconcilian intenciones de ejecución usando épocas de arrendamiento. La infraestructura depende de PostgreSQL 16 para datos persistentes, Redis (puerto 6380) para caché/colas, NATS JetStream para mensajería asíncrona y MinIO como almacenamiento S3 compatible.
El proyecto implementa autenticación OIDC con Keycloak, especificaciones OpenAPI 3.1 publicadas y esquemas de eventos para NATS. La interfaz web es un prototipo en React + Vite. El sistema está diseñado bajo principios de ingeniería de software rigurosos con revisión por IA (Claude Code) y pruebas de mutación antes de cada fase de desarrollo.
- Orquestación de microservicios HTTP en Kubernetes con recuperación automática ante fallos
- Ejecución de trabajos finitos (batch jobs) con garantía de entrega al menos una vez
- Gestión de estados durables para aplicaciones que requieren consistencia transaccional
- Implementación de patrones de outbox para mantener coherencia entre bases de datos y sistemas externos
- Recuperación automática mediante intenciones de ejecución durables con arrendamientos acotados
- Arquitectura desacoplada entre plano de control (FastAPI) y workers de ejecución (Go)
- Especificaciones OpenAPI 3.1 publicadas para integración programática segura
- Sistema de outbox transaccional que garantiza consistencia entre base de datos y eventos
- Requiere conocimientos avanzados de Kubernetes para despliegue en producción
- No incluye un clic para instalación (supportsOneClick: false)
- La interfaz web es un prototipo, no una solución completa de administración
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere PostgreSQL 16, Redis en puerto 6380, NATS JetStream y MinIO. Configurar ARTIFACTS_DIR compartido entre API y workers. Autenticación OIDC con Keycloak (localhost:8080) o Bearer tokens en producción. Portos críticos: 8000 (API), 6380 (Redis), 9000/9001 (MinIO).
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.