Files
pangolin/infra/terraform/modules/control-plane/main.tf
T
wangjia 3d5bac66b4 feat(provision): 弹性节点基建 Terraform + 一键更换 (tsk_6u0FxmbC7Yeq)
IaC 面 (infra/) 与控制面 (server/internal/provision) 双产出,落地 doc/04 §4
「节点是牲口」弹性拓扑与 make-before-break 一键更换。

server/internal/provision:
- CloudAdapter 适配层 + Registry(首发 vultr 消耗品池 / hetzner 精品池各一);
  厂商凭证仅从 PROVISION_<VENDOR>_* env 注入,不入库不入 git。
- ProvisionService:CreateNode(幂等键重放不重复开机)、DestroyNode(幂等)、
  RotateIP(换 IP 不换机 + version bump)、ListProviders。
- Replace 一键更换:先建后拆,新机 up 先于旧机 draining(容量不下降),
  replacement_uuid 幂等键 + replacements 表分步记录,崩溃可续跑不重复。
- RotatePool:池内滚动轮换,并发度 1–2。
- cmd/nodectl CLI:create/destroy/rotate-ip/replace/rotate-pool/providers。
- 单测(mock 厂商 API + 内存 Store):幂等重放、make-before-break 时序断言、
  开机失败/探活超时→destroyed+失败计数+告警钩子、崩溃续跑、RotatePool。

infra/:
- terraform/:探针机 + 控制面基线模块化(probe / control-plane)+ README,
  低频基线进 state,节点不进 Terraform。
- cloud-init/node.yaml.tmpl:节点引导模板(注入一次性 bootstrap token,task #5)。
- identity-isolation.md:身份隔离登记表(doc/06 §2 红线,无任何凭证)。

migrations/000008:nodes 增 provider_instance_id/elastic_ip_id、node_events
增 ip_rotated、provision_idempotency / replacements 表(附加式,不动现网)。

红线:仅面向新厂商池,绝不纳管现网生产 EC2(deploy/ marzban)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 14:23:39 +08:00

54 lines
1.5 KiB
Terraform

terraform {
required_providers {
hcloud = {
source = "hetznercloud/hcloud"
version = "~> 1.45"
}
}
}
# Control-plane baseline host (API + MySQL + Redis). Deployed on a stable cloud
# COMPLETELY UNRELATED to the data-plane node vendors (doc/04 §5.2): nodes can
# all die without touching the control plane, and vice-versa. Carries NO proxy
# traffic.
#
# Provisioned once and rarely changed — hence Terraform-managed. Application
# bring-up (containers, migrations) is handled separately by the server deploy
# pipeline, not here.
resource "hcloud_server" "control_plane" {
name = "pangolin-control-plane"
server_type = var.server_type
image = var.image
location = var.location
ssh_keys = var.ssh_key_ids
labels = {
role = "control-plane"
project = "pangolin"
}
lifecycle {
# Never recreate the control plane implicitly — it holds the user DB.
prevent_destroy = true
}
}
# Admin/SSH surface is never on the open internet (doc/06 §2). Inbound is locked
# to the management allowlist; the public API is expected to sit behind a CDN /
# reverse proxy terminated elsewhere.
resource "hcloud_firewall" "control_plane" {
name = "pangolin-control-plane"
rule {
direction = "in"
protocol = "tcp"
port = "22"
source_ips = length(var.allowlist_cidrs) > 0 ? var.allowlist_cidrs : ["0.0.0.0/0", "::/0"]
}
}
resource "hcloud_firewall_attachment" "control_plane" {
firewall_id = hcloud_firewall.control_plane.id
server_ids = [hcloud_server.control_plane.id]
}