Repolode
Enviar
mysticaltech

mysticaltech/terraform-hcloud-kube-hetzner

Módulo Terraform/OpenTofu que implanta um cluster Kubernetes preparado para produção (k3s ou RKE2) na Hetzner Cloud a partir de uma única configuração.

Ver no GitHub
Estrelas
3,942
Forks
558
Issues abertas
16
Último commit
há 9 dias

O que é?

Kube-Hetzner é um módulo Terraform e OpenTofu que provisiona um cluster Kubernetes na Hetzner Cloud. Por padrão, ele executa k3s, com RKE2 como alternativa, em nós com openSUSE Leap Micro. Durante a implantação, o módulo configura rede privada, firewalls, armazenamento CSI, ingress, gerenciamento de certificados, atualizações do sistema operacional e upgrades do Kubernetes.

Os clusters são definidos em um arquivo kube.tf. Os usuários escolhem pools de nós de control plane e agent, várias localizações e opções de rede como Flannel, Calico ou Cilium, incluindo configurações com NAT exclusivamente privado e transporte por Tailscale. Um script auxiliar cria a pasta do projeto e as imagens de sistema operacional necessárias, e o projeto inclui validações para que topologias inválidas falhem durante o planejamento.

O repositório também oferece documentação para operações do dia a dia, upgrades, backup e restauração e solução de problemas, além de exemplos e skills para assistentes de programação com IA.

Recursos principais

  • 01Implanta clusters k3s ou RKE2 em nós com openSUSE Leap Micro.
  • 02Oferece suporte a control planes de alta disponibilidade e pools de nós em várias localizações.
  • 03Integra rede privada, firewalls, armazenamento CSI e ingress.
  • 04Oferece redes Flannel, Calico ou Cilium, incluindo configurações com NAT exclusivamente privado.
  • 05Inclui suporte a node pools do Cluster Autoscaler e fluxos guiados de upgrade.

Casos de uso

  • Executar um cluster Kubernetes com configuração de produção na Hetzner Cloud a baixo custo.
  • Configurar um pequeno cluster de desenvolvimento com um único control plane.
  • Gerenciar a infraestrutura do cluster como código Terraform ou OpenTofu passível de revisão.

Início rápido

  1. 1

    Instale OpenTofu, kubectl e hcloud com o Homebrew

    brew install opentofu kubectl hcloud
  2. 2

    Crie um projeto no Hetzner Cloud, um token de API com permissões de leitura e gravação e uma chave SSH sem frase secreta

  3. 3

    Execute o script create do README para gerar a pasta do projeto, kube.tf e as imagens do Leap Micro

  4. 4

    Edite kube.tf e, em seguida, inicialize o projeto na pasta do projeto

    tofu init --upgrade

Antes de usar

  • Funciona apenas com o Hetzner Cloud, e a implantação cria recursos de nuvem pagos.
  • Requer Terraform ou OpenTofu, Packer e uma conta existente no Hetzner Cloud com um token de API.

Tópicos

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

Perguntas frequentes

O que é terraform-hcloud-kube-hetzner?
Módulo Terraform/OpenTofu que implanta um cluster Kubernetes preparado para produção (k3s ou RKE2) na Hetzner Cloud a partir de uma única configuração. Kube-Hetzner é um módulo Terraform e OpenTofu que provisiona um cluster Kubernetes na Hetzner Cloud. Por padrão, ele executa k3s, com RKE2 como alternativa, em nós com openSUSE Leap Micro. Durante a implantação, o módulo configura rede privada, firewalls, armazenamento CSI, ingress, gerenciamento de certificados, atualizações do sistema operacional e upgrades do Kubernetes.
terraform-hcloud-kube-hetzner é gratuito? Qual é a licença?
terraform-hcloud-kube-hetzner é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
terraform-hcloud-kube-hetzner ainda é mantido?
Manutenção ativa. O último commit de terraform-hcloud-kube-hetzner foi em 30 de out. de 2026.
Para que posso usar terraform-hcloud-kube-hetzner?
Executar um cluster Kubernetes com configuração de produção na Hetzner Cloud a baixo custo. Configurar um pequeno cluster de desenvolvimento com um único control plane. Gerenciar a infraestrutura do cluster como código Terraform ou OpenTofu passível de revisão.
Como instalar terraform-hcloud-kube-hetzner?
Instale OpenTofu, kubectl e hcloud com o Homebrew: brew install opentofu kubectl hcloud Crie um projeto no Hetzner Cloud, um token de API com permissões de leitura e gravação e uma chave SSH sem frase secreta Execute o script create do README para gerar a pasta do projeto, kube.tf e as imagens do Leap Micro Edite kube.tf e, em seguida, inicialize o projeto na pasta do projeto: tofu init --upgrade
Onde consigo terraform-hcloud-kube-hetzner?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mysticaltech/terraform-hcloud-kube-hetzner

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados