解剖PCF Dev的Go供应器:DNS、域名替换与API配置背后的6条命令链
解剖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,职责非常清晰:
- 生成证书:为指定域名现场生成证书,写入 gorouter 配置目录(见 provisioner.go 中的
Provision方法); - 顺序执行 6 条命令链:DNS、Garden 网络、API 服务、域名替换等;
- 执行收尾脚本:运行 /var/pcfdev/run 完成服务启动与账号初始化;
- 落健康检查标记:写入
/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 状态接口与健康检查。
五、延伸阅读路径
想继续深入,建议按这个顺序阅读仓库:
- 供应器入口与命令装配:src/provisioner/main.go
- 核心调度逻辑:src/provisioner/provisioner/provisioner.go
- 六条命令链源码目录:src/provisioner/provisioner/commands/
- 内嵌 API 服务:src/api/
- VM 内脚本(run/start/health-check):assets/scripts/
- 构建环境:src/provisioner/Dockerfile
- 项目背景与安装方式:README.md、FAQ.md
💡 小提示:本仓库是 PCF Dev 的开源历史版本(已归档),适合学习其架构与命令链设计;生产使用建议参考社区后续维护的 cfdev 项目。
读懂这 6 条命令链你会发现:所谓"开箱即用的 Cloud Foundry",不过是把几十条运维命令,优雅地编排成了 6 个可测试的小对象。