Kube-Hetzner Terraform 项目教程

1. 项目的目录结构及介绍

Kube-Hetzner Terraform 项目的目录结构如下：

terraform-hcloud-kube-hetzner/
├── docs/
│   └── terraform.md
├── tf/
│   ├── kubeconfig
│   ├── kustomization_backup
│   ├── kustomization_user
│   ├── locals
│   ├── main
│   ├── output
│   ├── placement_groups
│   ├── values-export
│   ├── variables
│   └── versions
├── README.md
├── LICENSE
└── .gitignore

目录结构介绍

• docs/: 包含项目的文档文件，如 terraform.md。
• tf/: 包含 Terraform 配置文件，如 kubeconfig, kustomization_backup, kustomization_user, locals, main, output, placement_groups, values-export, variables, versions。
• README.md: 项目的主介绍文件。
• LICENSE: 项目的许可证文件。
• .gitignore: 用于指定 Git 忽略的文件和目录。

2. 项目的启动文件介绍

项目的启动文件主要是 tf/main 文件。该文件包含了 Terraform 的主要配置和资源定义。以下是 tf/main 文件的部分内容示例：

provider "hcloud" {
  token = var.hcloud_token
}

resource "hcloud_server" "control_plane" {
  count       = var.control_plane_count
  name        = "control-plane-${count.index}"
  server_type = var.control_plane_server_type
  image       = var.os_image
  location    = var.location
  ssh_keys    = [hcloud_ssh_key.default.id]
}

启动文件介绍

• provider "hcloud": 定义了 Hetzner Cloud 的提供者配置，包括 API 令牌。
• resource "hcloud_server" "control_plane": 定义了控制平面节点的资源配置，包括节点数量、服务器类型、操作系统镜像、位置和 SSH 密钥。

3. 项目的配置文件介绍

项目的配置文件主要位于 tf/ 目录下，包括 variables, output, locals 等文件。以下是部分配置文件的介绍：

variables

variables 文件定义了 Terraform 使用的变量，例如：

variable "hcloud_token" {
  description = "Hetzner Cloud API Token"
  type        = string
}

variable "control_plane_count" {
  description = "Number of control plane nodes"
  type        = number
  default     = 3
}

output

output 文件定义了 Terraform 输出的值，例如：

output "control_plane_ips" {
  description = "IP addresses of control plane nodes"
  value       = hcloud_server.control_plane[*].ipv4_address
}

locals

locals 文件定义了本地变量，例如：

locals {
  common_tags = ["kubernetes", "hetzner"]
}

配置文件介绍

• variables: 定义了 Terraform 使用的变量，如 API 令牌、节点数量等。
• output: 定义了 Terraform 输出的值，如控制平面节点的 IP 地址。
• locals: 定义了本地变量，如常用的标签。

通过以上介绍，您可以更好地理解和使用 Kube-Hetzner Terraform 项目。