既存のCIパイプライン内でTerraformやOpenTofuを実行し、プルリクエストのコメントからplanとapplyを実行できる、オープンソースのIaCオーケストレーションツールです。
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
HomebrewでOpenTofu、kubectl、hcloudをインストールします
brew install opentofu kubectl hcloud - 2
Hetzner Cloudプロジェクト、読み取り・書き込み権限のAPIトークン、パスフレーズなしのSSHキーを作成します
- 3
READMEのcreateスクリプトを実行して、プロジェクトフォルダー、kube.tf、Leap Microイメージを生成します
- 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 の数値は毎日更新されます。
関連プロジェクト
Terraform、OpenTofu、Helmfile、コンテナを、共通の設定・認証・CIワークフローでオーケストレーションするオープンソースのランタイム。
TerraformとOpenTofuをPull Requestから実行し、state fileの代わりに依存関係グラフとしてPostgreSQLに状態を保存します。
ホームラボやセルフホスト環境向けに、再利用可能なインフラテンプレートを作成し、環境ごとの設定に展開するCLI。
ノードプール、ネットワークポリシー、IP masquerade設定を備えた、独自のデフォルト設定によるGoogle Kubernetes Engine(GKE)クラスターを構築するTerraformモジュール。
IaC、コンテナイメージ、オープンソースパッケージを静的解析し、クラウドの設定ミスやCVEを検出するツール。