garage-operator
Operador Kubernetes para Garage, sistema de almacenamiento distribuido compatible con S3 diseñado para autohospedaje con federación multi-clúster.
Ficha actualizada 22 sept 2026, 18:15 · upstream 22 sept 2026, 17:59 · release v0.7.12
Qué es garage-operator
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Garage Operator es una herramienta de automatización para gestionar clústeres de Garage, un sistema de almacenamiento de objetos distribuido compatible con S3. Proporciona gestión declarativa del ciclo de vida del clúster mediante Custom Resources Definitions (CRDs), permitiendo definir configuraciones de almacenamiento y gateways en un solo recurso v1beta2.
El operador soporta nodos locales con pools dedicados, vinculando identidades de Garage a nodos Kubernetes específicos y discos HostPath. Incluye gestión de buckets, cuotas y credenciales S3 mediante kubectl, además de federación multi-clúster con descubrimiento automático de nodos. Los pods de gateway mantienen identidad persistente entre reinicios.
Requiere Kubernetes 1.25+ (1.27+ para node-local pools), cert-manager para webhooks por defecto, y soporta imágenes firmadas con cosign y SBOM SPDX. La API actual es v1beta2 con conversión de v1beta1, pero no soporta Garage versiones anteriores a 2.0.0.
- Gestión declarativa de clústeres de almacenamiento S3 distribuido en Kubernetes
- Federación de almacenamiento entre múltiples clústeres Kubernetes con descubrimiento automático
- Control granular de asignación de nodos locales para gateways persistentes
- Creación y gestión de buckets, cuotas y credenciales S3 mediante CRDs
- Despliegue con driver COSI para aprovisionamiento nativo de almacenamiento
- Soporte oficial para API Admin v2 de Garage desde la versión 2.0.0
- Conversión automática entre versiones v1beta1 y v1beta2 de CRDs
- Imágenes y charts firmados con cosign y SLSA build provenance
- Gestión unificada de tiers de almacenamiento y gateway en un solo CRD
- Soporte para node-local pools con Kubernetes 1.27+
- Compatibilidad con imágenes multi-plataforma oficiales (v2.4.0, v2.2.0)
- No soporta Garage versiones 0.x y 1.x (requiere mínimo v2.0.0)
- Webhooks de admisión requieren cert-manager por defecto
- Funciones avanzadas como node-local pools necesitan Kubernetes 1.27+
- Algunos campos de configuración requieren Garage v2.1.0 o superior
- Despliegue sin webhooks limita recuperación de PVCs existentes
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.
Instalar con Helm en namespace garage-operator-system, creando el namespace primero. Requiere cert-manager para habilitar webhooks por defecto. Verificar firmas con cosign usando certificate-identity-regexp correspondiente. Crear secret admin-token antes del despliegue. Usar imagen oficial ghcr.io/rajsinghtech/garage-operator:v0.7.12 o posterior. Para node-local pools, usar Kubernetes 1.27+. Pinning por digest recomendado con Kyverno.
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.