Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

expert-octo-robot

Gitops para self-hosted helm charts en k3s, con Caddy como proxy TLS y autodescobrimiento de servicios.

Ficha actualizada 22 sept 2026, 23:55 · upstream 22 sept 2026, 23:32 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es expert-octo-robot

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este proyecto proporciona un sistema GitOps autoadministrable basado en Helm charts desplegados sobre Kubernetes (k3s). Utiliza Caddy como reverse proxy que genera certificados SSL automáticamente. Además, escucha el socket de Docker para descubrir servicios en tiempo real, lo que permite usar los mismos contenedores tanto como servicios Docker tradicionales como aplicaciones web. El repositorio incluye un script de Renovate que actualiza las imágenes de contenedor y un script automático de actualización con `helm-updater`. Los charts disponibles incluyen herramientas de gestión de archivos (bazarr, radarr, sonarr), búsqueda en línea (searxng, invidious), medios (cloudtube, jellyfin), notificaciones (godns, miniflux) y otros servicios.

CASOS DE USO
  • Despliegue de herramientas de gestión de archivos con autodescobrimiento de servicios
  • Implementación de un sistema GitOps autoadministrable basado en Helm charts
  • Gestión de servicios de búsqueda web (searxng, invidious) y medios (cloudtube, jellyfin)
  • Despliegue de aplicaciones con autodescobrimiento de contenedores Docker
  • Automatización de actualizaciones mediante Renovate y script de actualización manual
PUNTOS DESTACADOS
  • Uso de Caddy como reverse proxy que genera certificados SSL automáticamente sin configuración adicional
  • Autodescobrimiento de servicios a través del socket Docker, permitiendo un solo punto de control para múltiples contenedores
  • Sistema de secretos con sealed-secrets que decodifica valores sensibles mediante template helpers de Helm
  • Actualización automática de imágenes de contenedor mediante Renovate sin intervención manual
  • Soporte para múltiples servicios en una sola configuración con gestión unificada a través de k3s
PRECAUCIONES
  • Requiere Docker instalado y configurado correctamente, lo que puede ser complejo en entornos no estándar
  • La autodescobrimiento de servicios depende del socket Docker y puede fallar si el entorno es aislado
  • Los certificados SSL generados por Caddy tienen una caducidad de 1 año, requiriendo regeneración manual
  • El uso de sealed-secrets requiere configuración adicional con kubeseal y decodificación en Helm templates
  • La arquitectura depende de k3s como controlador de Kubernetes, lo que limita la escalabilidad horizontal
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Para desplegar este proyecto: instale k3s y configure su entorno. Cree un secret con sealed-secrets para almacenar credenciales sensibles. Instale los Helm charts desde app-charts en el repositorio. Configure el archivo .env con variables de entorno, asegúrese de tener Docker instalado y activo. Ejecute `helm install` para desplegar cada chart individualmente o use el script `poor-mans-argocd/helm-updater.sh` para actualizar todos los charts automáticamente. Para la autodescobrimiento de servicios, asegúrese de que el socket Docker esté configurado correctamente en k3s y verifique que los pods de Caddy estén activos.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
No detectados
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.