Repolode
mysticaltech

mysticaltech/terraform-hcloud-kube-hetzner

単一の設定からHetzner Cloud上に本番運用を意識したKubernetesクラスター(k3sまたはRKE2)を構築するTerraform/OpenTofuモジュール。

スター
3,941
フォーク
558
未解決の Issue
16
最終コミット
8 日前

これは何?

Kube-Hetznerは、Hetzner Cloud上にKubernetesクラスターを構築するTerraformおよびOpenTofuモジュールです。デフォルトではopenSUSE Leap Microノード上でk3sを実行し、RKE2も選択できます。デプロイ時に、プライベートネットワーク、ファイアウォール、CSIストレージ、Ingress、証明書管理、OSアップデート、Kubernetesのアップグレードを設定します。

クラスターはkube.tfファイルで定義します。コントロールプレーンとエージェントのノードプール、複数のロケーション、Flannel、Calico、Ciliumなどのネットワーク設定を選択できます。プライベートネットワークのみを使うNAT構成や、Tailscaleトランスポートにも対応しています。ヘルパースクリプトでプロジェクトフォルダーと必要なOSイメージを作成でき、無効なトポロジーはplan時にエラーになるよう検証機能も備えています。

リポジトリには、日々の運用、アップグレード、バックアップと復元、トラブルシューティングに関するドキュメントに加え、サンプルやAIコーディングアシスタント向けのスキルも含まれています。

主な機能

  • 01openSUSE Leap Microノード上にk3sまたはRKE2クラスターをデプロイできます。
  • 02高可用性コントロールプレーンと複数ロケーションのノードプールに対応しています。
  • 03プライベートネットワーク、ファイアウォール、CSIストレージ、Ingressを統合します。
  • 04Flannel、Calico、Ciliumのネットワークに対応し、プライベートネットワークのみを使うNAT構成も利用できます。
  • 05Cluster Autoscalerのノードプールに対応し、ガイド付きのアップグレード手順を備えています。

ユースケース

  • Hetzner Cloud上で、低コストの本番運用向けKubernetesクラスターを稼働させる。
  • コントロールプレーンを1つ備えた小規模な開発用クラスターを構築する。
  • レビュー可能なTerraformまたはOpenTofuコードとしてクラスターのインフラを管理する。

クイックスタート

  1. 1

    HomebrewでOpenTofu、kubectl、hcloudをインストールします

    brew install opentofu kubectl hcloud
  2. 2

    Hetzner Cloudプロジェクト、読み取り・書き込み権限のAPIトークン、パスフレーズなしのSSHキーを作成します

  3. 3

    READMEのcreateスクリプトを実行して、プロジェクトフォルダー、kube.tf、Leap Microイメージを生成します

  4. 4

    kube.tfを編集し、プロジェクトフォルダー内でプロジェクトを初期化します

    tofu init --upgrade

使う前に知っておきたいこと

  • Hetzner Cloudでのみ動作します。デプロイすると有料のクラウドリソースが作成されます。
  • TerraformまたはOpenTofu、Packer、APIトークンを持つ既存のHetzner Cloudアカウントが必要です。

トピック

よくある質問

terraform-hcloud-kube-hetzner とは?
単一の設定からHetzner Cloud上に本番運用を意識したKubernetesクラスター(k3sまたはRKE2)を構築するTerraform/OpenTofuモジュール。 Kube-Hetznerは、Hetzner Cloud上にKubernetesクラスターを構築するTerraformおよびOpenTofuモジュールです。デフォルトではopenSUSE Leap Microノード上でk3sを実行し、RKE2も選択できます。デプロイ時に、プライベートネットワーク、ファイアウォール、CSIストレージ、Ingress、証明書管理、OSアップデート、Kubernetesのアップグレードを設定します。
terraform-hcloud-kube-hetzner は無料で使えますか?ライセンスは?
terraform-hcloud-kube-hetzner は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
terraform-hcloud-kube-hetzner は今もメンテナンスされていますか?
活発にメンテナンス中。terraform-hcloud-kube-hetzner の最終コミットは 2026年10月30日 です。
terraform-hcloud-kube-hetzner は何に使えますか?
Hetzner Cloud上で、低コストの本番運用向けKubernetesクラスターを稼働させる。 コントロールプレーンを1つ備えた小規模な開発用クラスターを構築する。 レビュー可能なTerraformまたはOpenTofuコードとしてクラスターのインフラを管理する。
terraform-hcloud-kube-hetzner のインストール方法は?
HomebrewでOpenTofu、kubectl、hcloudをインストールします: brew install opentofu kubectl hcloud Hetzner Cloudプロジェクト、読み取り・書き込み権限のAPIトークン、パスフレーズなしのSSHキーを作成します READMEのcreateスクリプトを実行して、プロジェクトフォルダー、kube.tf、Leap Microイメージを生成します kube.tfを編集し、プロジェクトフォルダー内でプロジェクトを初期化します: tofu init --upgrade
terraform-hcloud-kube-hetzner はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/mysticaltech/terraform-hcloud-kube-hetzner

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト