Repolode
mysticaltech

mysticaltech/terraform-hcloud-kube-hetzner

Модуль Terraform/OpenTofu разворачивает готовый к продакшену кластер Kubernetes (k3s или RKE2) в Hetzner Cloud из единой конфигурации.

Звёзды
3,941
Форки
558
Открытые issues
16
Последний коммит
8 дней назад

Что это?

Kube-Hetzner — это модуль Terraform и OpenTofu для создания кластера Kubernetes в Hetzner Cloud. По умолчанию он разворачивает k3s, а при необходимости — RKE2, на узлах с openSUSE Leap Micro. При развёртывании модуль настраивает приватную сеть, файрволы, хранилище CSI, ingress, управление сертификатами, обновления ОС и обновления Kubernetes.

Кластеры описываются в файле kube.tf. Пользователи выбирают пулы узлов control plane и агентов, несколько локаций и параметры сети, например Flannel, Calico или Cilium, в том числе конфигурации с одним лишь приватным доступом через NAT и транспортом Tailscale. Вспомогательный скрипт создаёт папку проекта и необходимые образы ОС, а встроенная проверка выявляет недопустимые топологии на этапе plan.

В репозитории также есть документация по повседневному администрированию, обновлениям, резервному копированию и восстановлению, а также устранению неполадок, примеры и skills для AI-ассистентов по написанию кода.

Ключевые возможности

  • 01Разворачивает кластеры k3s или RKE2 на узлах с openSUSE Leap Micro.
  • 02Поддерживает отказоустойчивые control plane и пулы узлов в нескольких локациях.
  • 03Интегрирует приватную сеть, файрволы, хранилище CSI и ingress.
  • 04Поддерживает сети Flannel, Calico или Cilium, в том числе конфигурации с одним лишь приватным доступом через NAT.
  • 05Поддерживает пулы узлов Cluster Autoscaler и пошаговые сценарии обновления.

Сценарии использования

  • Запуск кластера Kubernetes, готового к продакшену, в Hetzner Cloud с низкими затратами.
  • Развёртывание небольшого кластера для разработки с одной управляющей нодой.
  • Управление инфраструктурой кластера в виде кода Terraform или OpenTofu, удобного для ревью.

Быстрый старт

  1. 1

    Установите OpenTofu, kubectl и hcloud с помощью Homebrew

    brew install opentofu kubectl hcloud
  2. 2

    Создайте проект Hetzner Cloud, API-токен с правами на чтение и запись и SSH-ключ без парольной фразы

  3. 3

    Запустите скрипт create из README, чтобы создать папку проекта, kube.tf и образы Leap Micro

  4. 4

    Отредактируйте kube.tf, затем инициализируйте проект в папке проекта

    tofu init --upgrade

Что важно знать

  • Работает только с Hetzner Cloud; развертывание создает платные облачные ресурсы.
  • Требуются Terraform или OpenTofu, Packer и существующая учетная запись Hetzner Cloud с API-токеном.

Темы

Частые вопросы

Что такое terraform-hcloud-kube-hetzner?
Модуль Terraform/OpenTofu разворачивает готовый к продакшену кластер Kubernetes (k3s или RKE2) в Hetzner Cloud из единой конфигурации. Kube-Hetzner — это модуль Terraform и OpenTofu для создания кластера Kubernetes в Hetzner Cloud. По умолчанию он разворачивает k3s, а при необходимости — RKE2, на узлах с openSUSE Leap Micro. При развёртывании модуль настраивает приватную сеть, файрволы, хранилище CSI, ingress, управление сертификатами, обновления ОС и обновления Kubernetes.
terraform-hcloud-kube-hetzner можно использовать бесплатно? Какая у него лицензия?
terraform-hcloud-kube-hetzner распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
terraform-hcloud-kube-hetzner всё ещё поддерживается?
Активно поддерживается. Последний коммит в terraform-hcloud-kube-hetzner — 30 окт. 2026 г..
Для чего можно использовать terraform-hcloud-kube-hetzner?
Запуск кластера Kubernetes, готового к продакшену, в Hetzner Cloud с низкими затратами. Развёртывание небольшого кластера для разработки с одной управляющей нодой. Управление инфраструктурой кластера в виде кода Terraform или OpenTofu, удобного для ревью.
Как установить terraform-hcloud-kube-hetzner?
Установите OpenTofu, kubectl и hcloud с помощью Homebrew: brew install opentofu kubectl hcloud Создайте проект Hetzner Cloud, API-токен с правами на чтение и запись и SSH-ключ без парольной фразы Запустите скрипт create из README, чтобы создать папку проекта, kube.tf и образы Leap Micro Отредактируйте kube.tf, затем инициализируйте проект в папке проекта: tofu init --upgrade
Где скачать terraform-hcloud-kube-hetzner?
Исходный код и инструкции по установке — на GitHub: https://github.com/mysticaltech/terraform-hcloud-kube-hetzner

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Terraform-модуль для создания кластеров Google Kubernetes Engine (GKE) с преднастроенными пулами узлов, сетевыми политиками и параметрами IP masquerade.

1,3 тыс.+1 за неделю1,3 тыс.HCLApache-2.0Активно поддерживаетсяОбновлён 6 часов назад