Files
panxiao81 5241eceb0c
yaml / yaml (pull_request) Successful in 23s
terraform / validate (pull_request) Successful in 36s
ansible / collection-test (pull_request) Successful in 1m33s
ansible / lint (pull_request) Failing after 2m44s
feat(dns): 用模板生成各后端配置
2026-09-16 18:27:09 +00:00

147 lines
5.2 KiB
Python

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = ["Jinja2==3.1.6", "PyYAML==6.0.3"]
# ///
"""Render backend DNS configuration from records.yml."""
from __future__ import annotations
import argparse
import difflib
from pathlib import Path
import sys
import yaml
from jinja2 import Environment, FileSystemLoader, StrictUndefined
ROOT = Path(__file__).resolve().parents[2]
DNS_DIR = ROOT / "infrastructure/dns"
BEGIN = "# BEGIN GENERATED: homelab DNS ([[ target ]])"
END = "# END GENERATED: homelab DNS ([[ target ]])"
def load_inventory() -> dict:
data = yaml.safe_load((DNS_DIR / "records.yml").read_text())
try:
inventory = data["homelab_dns"]
split_records = inventory["split_horizon"]["records"]
public_records = inventory["public"]["records"]
except (KeyError, TypeError) as exc:
raise ValueError(f"invalid DNS inventory: missing {exc}") from exc
for record in split_records:
require_fields(record, "name", "type", "values", "backends")
if record["type"] != "A" or len(record["values"]) != 1:
raise ValueError(f"split record must be a single A value: {record!r}")
unknown = set(record["backends"]) - {"blocky", "coredns"}
if unknown:
raise ValueError(f"unknown split DNS backends {sorted(unknown)}")
for record in public_records:
require_fields(record, "name", "type", "values", "proxied", "terraform")
terraform = record["terraform"]
if terraform.get("managed") and not terraform.get("resource_name"):
raise ValueError(f"managed Terraform record needs resource_name: {record['name']}")
if len(record["values"]) != 1:
raise ValueError(f"Cloudflare Terraform supports one value per record: {record['name']}")
return inventory
def require_fields(record: dict, *fields: str) -> None:
missing = [field for field in fields if field not in record]
if missing:
raise ValueError(f"record missing {', '.join(missing)}: {record!r}")
def environment() -> Environment:
return Environment(
loader=FileSystemLoader(DNS_DIR / "templates"),
undefined=StrictUndefined,
autoescape=False,
keep_trailing_newline=True,
trim_blocks=True,
lstrip_blocks=True,
variable_start_string="[[",
variable_end_string="]]",
block_start_string="[%",
block_end_string="%]",
)
def marker(target: str, end: bool = False) -> str:
return (END if end else BEGIN).replace("[[ target ]]", target)
def replace_block(original: str, target: str, rendered: str) -> str:
begin = marker(target)
end = marker(target, end=True)
if original.count(begin) != 1 or original.count(end) != 1:
raise ValueError(f"expected exactly one generated block for {target}")
prefix, remainder = original.split(begin, 1)
_, suffix = remainder.split(end, 1)
indent = prefix.rsplit("\n", 1)[-1]
body = rendered.rstrip("\n")
return f"{prefix}{begin}\n{body}\n{indent}{end}{suffix}"
def outputs(inventory: dict) -> dict[Path, str]:
env = environment()
split_records = inventory["split_horizon"]["records"]
public_records = inventory["public"]["records"]
result = {}
blocky_path = ROOT / "apps/blocky/config.yml"
blocky = env.get_template("blocky.yml.j2").render(
records=[record for record in split_records if "blocky" in record["backends"]]
)
result[blocky_path] = replace_block(blocky_path.read_text(), "blocky", blocky)
coredns_path = ROOT / "platform/k3s/coredns-custom.yaml"
coredns = env.get_template("coredns.yaml.j2").render(
records=[record for record in split_records if "coredns" in record["backends"]]
)
result[coredns_path] = replace_block(coredns_path.read_text(), "coredns", coredns)
terraform_path = ROOT / "infrastructure/cloudflared/terraform/dns.generated.tf"
terraform = env.get_template("cloudflare.tf.j2").render(
records=[record for record in public_records if record["terraform"]["managed"]]
)
result[terraform_path] = terraform
return result
def main() -> int:
parser = argparse.ArgumentParser()
parser.add_argument("--check", action="store_true", help="fail when generated files differ")
args = parser.parse_args()
try:
rendered_outputs = outputs(load_inventory())
except (OSError, ValueError, yaml.YAMLError) as exc:
print(f"dns generation failed: {exc}", file=sys.stderr)
return 2
changed = False
for path, expected in rendered_outputs.items():
actual = path.read_text() if path.exists() else ""
if actual == expected:
continue
changed = True
if args.check:
print("".join(difflib.unified_diff(
actual.splitlines(keepends=True),
expected.splitlines(keepends=True),
fromfile=str(path.relative_to(ROOT)),
tofile=f"{path.relative_to(ROOT)} (generated)",
)))
else:
path.parent.mkdir(parents=True, exist_ok=True)
path.write_text(expected)
print(f"rendered {path.relative_to(ROOT)}")
return 1 if args.check and changed else 0
if __name__ == "__main__":
raise SystemExit(main())