Repolode
제출하기
mysticaltech

mysticaltech/terraform-hcloud-kube-hetzner

단일 설정으로 Hetzner Cloud에 운영 환경을 고려한 Kubernetes 클러스터(k3s 또는 RKE2)를 배포하는 Terraform/OpenTofu 모듈입니다.

GitHub에서 보기
스타
3,941
포크
558
열린 이슈
16
마지막 커밋
7일 전

어떤 프로젝트인가요?

Kube-Hetzner는 Hetzner Cloud에 Kubernetes 클러스터를 프로비저닝하는 Terraform 및 OpenTofu 모듈입니다. 기본적으로 openSUSE Leap Micro 노드에서 k3s를 실행하며, RKE2도 선택할 수 있습니다. 배포 과정에서 프라이빗 네트워킹, 방화벽, CSI 스토리지, 인그레스, 인증서 관리, OS 업데이트 및 Kubernetes 업그레이드를 설정합니다.

클러스터는 kube.tf 파일에서 정의합니다. 사용자는 컨트롤 플레인과 에이전트 노드 풀, 여러 위치, Flannel·Calico·Cilium 같은 네트워킹 옵션을 선택할 수 있으며, 프라이빗 전용 NAT 구성과 Tailscale 전송 방식도 지원합니다. 헬퍼 스크립트로 프로젝트 폴더와 필요한 OS 이미지를 만들 수 있고, 잘못된 토폴로지는 plan 단계에서 실패하도록 검증 기능도 포함되어 있습니다.

저장소에는 day-2 운영, 업그레이드, 백업 및 복구, 문제 해결 문서와 예제, AI 코딩 어시스턴트용 스킬도 포함되어 있습니다.

핵심 기능

  • 01openSUSE Leap Micro 노드에 k3s 또는 RKE2 클러스터를 배포합니다.
  • 02고가용성 컨트롤 플레인과 여러 위치의 노드 풀을 지원합니다.
  • 03프라이빗 네트워킹, 방화벽, CSI 스토리지 및 인그레스를 통합합니다.
  • 04프라이빗 전용 NAT 구성을 포함해 Flannel, Calico 또는 Cilium 네트워킹을 지원합니다.
  • 05Cluster Autoscaler 노드 풀 지원과 안내형 업그레이드 워크플로를 제공합니다.

활용 사례

  • Hetzner Cloud에서 저렴한 비용으로 운영 환경에 적합한 Kubernetes 클러스터를 실행합니다.
  • 단일 컨트롤 플레인으로 소규모 개발 클러스터를 구축합니다.
  • 검토 가능한 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 계정이 필요합니다.

토픽

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

자주 묻는 질문

terraform-hcloud-kube-hetzner은(는) 무엇인가요?
단일 설정으로 Hetzner Cloud에 운영 환경을 고려한 Kubernetes 클러스터(k3s 또는 RKE2)를 배포하는 Terraform/OpenTofu 모듈입니다. Kube-Hetzner는 Hetzner Cloud에 Kubernetes 클러스터를 프로비저닝하는 Terraform 및 OpenTofu 모듈입니다. 기본적으로 openSUSE Leap Micro 노드에서 k3s를 실행하며, RKE2도 선택할 수 있습니다. 배포 과정에서 프라이빗 네트워킹, 방화벽, CSI 스토리지, 인그레스, 인증서 관리, 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 클러스터를 실행합니다. 단일 컨트롤 플레인으로 소규모 개발 클러스터를 구축합니다. 검토 가능한 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 통계는 매일 갱신됩니다.

관련 프로젝트