解剖PCF Dev的Go供应器:DNS、域名替换与API配置背后的6条命令链

原创2026-10-26 22:03:291,737 阅读

解剖PCF Dev的Go供应器:DNS、域名替换与API配置背后的6条命令链

PCF Dev 是一个运行在开发者笔记本上的轻量级 Cloud Foundry 发行版,而它真正"干活"的大脑,是 VM 内部用 Go 语言编写的供应器(provisioner)。本文带你逐条拆解这个供应器:它如何在 VM 启动时完成 DNS 配置、域名替换、API 配置等关键动作,看懂背后的 6 条命令链,你就理解了 cf dev start 之后发生的一切。

一、PCF Dev 供应器是什么?

当你在本地执行 cf dev start 后,PCF Dev 会启动一个 VirtualBox 虚拟机。VM 里预装了一整套 Cloud Foundry 组件(UAA、gorouter、Garden 等),但这些组件出厂时用的是"占位域名"和自签名配置,无法直接对外服务。

于是 Go 供应器登场了。它的入口在 main.go,职责非常清晰:

  1. 生成证书:为指定域名现场生成证书,写入 gorouter 配置目录(见 provisioner.go 中的 Provision 方法);
  2. 顺序执行 6 条命令链:DNS、Garden 网络、API 服务、域名替换等;
  3. 执行收尾脚本:运行 /var/pcfdev/run 完成服务启动与账号初始化;
  4. 落健康检查标记:写入 /run/pcfdev-healthcheck,宣告"供应完成"。

整个过程由 ConcreteCmdRunner 执行,自带 3600 秒超时保护——任何一条命令卡死都会被强杀,避免供应过程无限挂起。

二、6 条命令链逐个拆解

所有命令的装配逻辑集中在 buildCommands 函数。它们都实现了同一个接口:Run() 执行动作、Distro() 声明适用发行版(OSS 或 PCF),Provisioner 会按发行版自动跳过不兼容的命令。

命令 作用一句话 源码位置
DisableUAAHSTS 关闭 UAA 的 HSTS 强制跳转 disable_uaa_hsts.go
ConfigureDnsmasq 配置通配符 DNS 解析 configure_dnsmasq.go
ConfigureGardenDNS 让容器容器也走本地 DNS configure_garden_dns.go
SetupApi 注册 pcfdev-api 监控服务 setup_api.go
ReplaceDomain 全局替换旧域名为新域名 replace_domain.go
SetupCFDot 把 cfdot 初始化脚本注入登录环境 setup_cfdot.go

1️⃣ DisableUAAHSTS:给 UAA 关掉 HSTS

HSTS(HTTP 严格传输安全)会强制浏览器走 HTTPS。PCF Dev 里 UAA 用的是本地自签名证书,HSTS 反而会把登录流程卡死。这条命令解析 UAA 的 web.xml,通过 Tomcat 的 HttpHeaderSecurityFilter 把 hstsEnabled 设为 false。注意它的 Distro() 返回的是 PCF——只在商业版发行版中生效,开源版会被自动跳过。

2️⃣ ConfigureDnsmasq:通配符 DNS 的核心魔法

这是整条链里最精彩的一环。PCF Dev 承诺"任何子域名都能访问"(如 myapp.local.pcfdev.io),靠的就是 dnsmasq 的通配符解析。它的动作顺序是:

  • 停掉 dnsmasq,并禁用 resolvconf 的动态更新,防止配置被 DHCP 覆盖;
  • 用 ip route get 1 探测出 VM 内部 IP(正则匹配 src 字段);
  • 写入三条关键配置:
    • address=/.<你的域名>/<外部IP>:所有 *.域名 全部指向 VM 外部 IP,请求由此进入 gorouter;
    • address=/.cf.internal/127.0.0.1:Cloud Foundry 内部服务名走回环地址;
    • listen-address=<内部IP>:只监听 VM 网卡,不对外泄露。
  • 最后把系统 resolv.conf 指向 dnsmasq,完成闭环。

细节代码可对照 configure_dnsmasq.go。

3️⃣ ConfigureGardenDNS:让容器内部也能解析

第 2 步只解决了 VM 宿主机的 DNS,而应用实际跑在 Garden(Diego)容器里。这条命令直接"动手术":读取 garden_ctl 脚本,先剔除旧的 -dnsServer= 参数,再在启动命令中注入新的 -dnsServer=<内部IP>——容器里的应用从此也能解析 *.域名。

4️⃣ SetupApi:注册一个"随身 API 服务"

这条命令写入两个文件(见 setup_api.go):

  • 一个 monit 监控配置 1001_pcfdev_api.monitrc,让 monit 负责拉起 /var/pcfdev/api/api 进程;
  • 一个 api_ctl 控制脚本,提供 start / stop 并记录 PID 文件。

被拉起的这个 API 服务就是 src/api/main.go 编译出的程序,监听 localhost:8090,提供两个接口:

  • /status:检查 /run/pcfdev-healthcheck 标记文件,返回 Running 或 Unprovisioned;
  • /replace-secrets:接收新密码,调用 UaaCredentialReplacement 精准替换 UAA 配置里 admin|admin| 的弱口令——这就是 cf dev change-password 的幕后实现。

5️⃣ ReplaceDomain:一次 perl 完成全域名替换

VM 镜像是通用的,出厂带一个"占位旧域名"。这条命令(replace_domain.go)的逻辑:

  • 用 find /var/vcap/jobs/*/ -type f 找出所有 BOSH Job 配置与脚本文件;
  • 用一条 perl -p -i -e s/旧域名/新域名/g 在所有文件中做精确替换(\Q...\E 转义保证域名中的 . 不误伤);
  • 把新域名写回 /var/pcfdev/domain,作为后续脚本的唯一事实来源。

一次批量改写,让 UAA、gorouter、路由、broker 等所有组件瞬间"改口"为你的域名。

6️⃣ SetupCFDot:登录即自动 cf 配置

cfdot 是一个 shell 函数,作用是登录后自动执行 cf api 并处理 SSL 校验。这条命令只需一步:把 cfdot 的 setup 脚本 复制到 /etc/profile.d/cfdot.sh。任何用户登录 VM 都会自动加载它——这也是 ssh -t pcfdev 之后命令提示符直接可用的原因。

附赠:AWS 场景的 iptables 命令链

如果第 5 个启动参数是 aws(见 isAwsProvisioner),还会追加一组长命令:先 CloseAllPorts 关闭 eth0/eth1 的所有新 TCP 连接(保留已建立连接和本地回环),再逐条 OpenPort 放行 80、443、22、2222 以及 61001–61100 的 TCP 路由端口段——白名单思路,最小暴露面。

三、收尾:/var/pcfdev/run 脚本干了什么?

6 条命令链跑完后,Provisioner 会执行 shell 收尾脚本 run,它的要点包括:

  • 把自签名证书合并进系统信任链(trusted_ca.crt);
  • 再次执行 perl 域名替换并更新 /var/pcfdev/domain;
  • 依次拉起 MariaDB、Consul、Garden、UA 等全部服务,轮询直到"N out of N running"(详见 start 脚本);
  • 执行 cf api + cf auth admin admin,创建 pcfdev-org / pcfdev-space 和默认用户 user;
  • 创建 tcp.<域名> 共享域并放开 TCP 路由配额;
  • 注册 p-mysql、local-volume 两个服务 broker。

全部完成后回到 provisioner.go 写入空文件 /run/pcfdev-healthcheck。配套的 health-check 脚本 则要求"Cloud Controller 返回 200 且 标记文件存在"才判定健康——双重保险。

四、核心设计亮点总结

  • 接口化命令:每条命令链都是独立的 Command,可单独用 mock 测试(参考 provisioner_test.go),也便于按发行版裁剪;
  • 命令与数据分离:Go 负责"改配置",shell 脚本负责"起服务",各司其职;
  • 防御式执行:全局 3600 秒超时 + 进程组强杀,任何一步卡死都不会让 VM 假死;
  • 幂等标记:/run/pcfdev-healthcheck 一个空文件,串起 API 状态接口与健康检查。

五、延伸阅读路径

想继续深入,建议按这个顺序阅读仓库:

💡 小提示:本仓库是 PCF Dev 的开源历史版本(已归档),适合学习其架构与命令链设计;生产使用建议参考社区后续维护的 cfdev 项目。

读懂这 6 条命令链你会发现:所谓"开箱即用的 Cloud Foundry",不过是把几十条运维命令,优雅地编排成了 6 个可测试的小对象。

登录后查看全文
illy