用途:在终端中检索并显示 Terraform Cloud(TFC)某次运行的 plan 和/或 apply 日志,便于调试失败的 plan/apply 或人工审阅基础设施变更输出。
主要能力:通过 TFC API 根据 run ID 获取 run 的 plan、apply 关系,再取对应 log-read-url 拉取日志;可只取 plan 日志、只取 apply 日志或两者都取;日志含 ANSI 颜色码,可用 sed 去除后输出干净文本。
必要用法:需设置环境变量 export TFE_TOKEN="your-api-token"(用户或团队令牌,不能用组织令牌),可选 export TFE_ADDRESS="app.terraform.io"(默认 app.terraform.io)。核心流程为:请求 /api/v2/runs/$RUN_ID?include=plan,apply,用 jq 提取 plan/apply 的 id,再请求 /api/v2/plans/$PLAN_ID 或 /api/v2/applies/$APPLY_ID 取 log-read-url,最后 curl 该 URL 获取日志。
限制与注意:日志 URL 属于机密,内含认证信息,不要记录或外泄;URL 有效期 25 小时;拿到 archivist URL 后拉取日志无需 bearer token;/runs 端点限速 30 次/分钟;404 可能表示 run 不存在或无权限,401 表示令牌无效或过期;若 run 仅 plan、尚未 apply 或已丢弃,则没有 apply 日志,应先检查 run 状态。相关技能包括 tfc-run-status、tfc-list-runs、tfc-plan-json。