Repolode
Enviar
mysticaltech

mysticaltech/terraform-hcloud-kube-hetzner

Módulo de Terraform/OpenTofu que despliega un clúster de Kubernetes orientado a producción (k3s o RKE2) en Hetzner Cloud con una sola configuración.

Ver en GitHub
Estrellas
3,942
Forks
558
Issues abiertos
16
Último commit
hace 8 días

¿Qué es?

Kube-Hetzner es un módulo de Terraform y OpenTofu que aprovisiona un clúster de Kubernetes en Hetzner Cloud. De forma predeterminada, ejecuta k3s, con RKE2 como opción, en nodos con openSUSE Leap Micro. Durante el despliegue, el módulo configura redes privadas, firewalls, almacenamiento CSI, ingress, gestión de certificados, actualizaciones del sistema operativo y actualizaciones de Kubernetes.

Los clústeres se definen en un archivo kube.tf. Los usuarios eligen los pools de nodos del plano de control y de agentes, varias ubicaciones y opciones de red como Flannel, Calico o Cilium, incluidas configuraciones NAT solo privadas y transporte de Tailscale. Un script auxiliar crea la carpeta del proyecto y las imágenes del sistema operativo necesarias, y el proyecto incluye validaciones para que las topologías no válidas fallen durante la planificación.

El repositorio también incluye documentación sobre operaciones del día 2, actualizaciones, copias de seguridad y restauración, y resolución de problemas, además de ejemplos y skills para asistentes de programación con IA.

Funciones clave

  • 01Despliega clústeres de k3s o RKE2 en nodos con openSUSE Leap Micro.
  • 02Admite planos de control de alta disponibilidad y pools de nodos en varias ubicaciones.
  • 03Integra redes privadas, firewalls, almacenamiento CSI e ingress.
  • 04Ofrece redes con Flannel, Calico o Cilium, incluidas configuraciones NAT solo privadas.
  • 05Incluye compatibilidad con nodepools de Cluster Autoscaler y flujos guiados de actualización.

Casos de uso

  • Ejecutar un clúster de Kubernetes de estilo productivo en Hetzner Cloud a bajo costo.
  • Configurar un clúster de desarrollo pequeño con un único plano de control.
  • Gestionar la infraestructura del clúster como código de Terraform u OpenTofu sujeto a revisión.

Inicio rápido

  1. 1

    Instala OpenTofu, kubectl y hcloud con Homebrew

    brew install opentofu kubectl hcloud
  2. 2

    Crea un proyecto de Hetzner Cloud, un token de API con permisos de lectura y escritura y una clave SSH sin frase de contraseña

  3. 3

    Ejecuta el script create del README para generar la carpeta del proyecto, kube.tf y las imágenes de Leap Micro

  4. 4

    Edita kube.tf y, después, inicializa el proyecto en su carpeta

    tofu init --upgrade

Antes de usarlo

  • Solo funciona con Hetzner Cloud y, al implementarlo, se crean recursos en la nube de pago.
  • Necesitas Terraform u OpenTofu, Packer y una cuenta existente de Hetzner Cloud con un token de API.

Temas

#kubernetes#terraform#hetzner-cloud#k3s#infrastructure-as-code#opentofu#hcloud#k8s#rke2

Preguntas frecuentes

¿Qué es terraform-hcloud-kube-hetzner?
Módulo de Terraform/OpenTofu que despliega un clúster de Kubernetes orientado a producción (k3s o RKE2) en Hetzner Cloud con una sola configuración. Kube-Hetzner es un módulo de Terraform y OpenTofu que aprovisiona un clúster de Kubernetes en Hetzner Cloud. De forma predeterminada, ejecuta k3s, con RKE2 como opción, en nodos con openSUSE Leap Micro. Durante el despliegue, el módulo configura redes privadas, firewalls, almacenamiento CSI, ingress, gestión de certificados, actualizaciones del sistema operativo y actualizaciones de Kubernetes.
¿terraform-hcloud-kube-hetzner es gratuito? ¿Qué licencia tiene?
terraform-hcloud-kube-hetzner es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿terraform-hcloud-kube-hetzner sigue mantenido?
Mantenimiento activo. El último commit de terraform-hcloud-kube-hetzner fue el 30 oct 2026.
¿Para qué puedo usar terraform-hcloud-kube-hetzner?
Ejecutar un clúster de Kubernetes de estilo productivo en Hetzner Cloud a bajo costo. Configurar un clúster de desarrollo pequeño con un único plano de control. Gestionar la infraestructura del clúster como código de Terraform u OpenTofu sujeto a revisión.
¿Cómo se instala terraform-hcloud-kube-hetzner?
Instala OpenTofu, kubectl y hcloud con Homebrew: brew install opentofu kubectl hcloud Crea un proyecto de Hetzner Cloud, un token de API con permisos de lectura y escritura y una clave SSH sin frase de contraseña Ejecuta el script create del README para generar la carpeta del proyecto, kube.tf y las imágenes de Leap Micro Edita kube.tf y, después, inicializa el proyecto en su carpeta: tofu init --upgrade
¿Dónde consigo terraform-hcloud-kube-hetzner?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mysticaltech/terraform-hcloud-kube-hetzner

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados