# 客户的云账单，应该先出现在 PR 里

> Infracost 在部署前于 CI 中估算成本变化，但只有设为必需状态检查，才能阻止合并。

原文: https://fdetimes.net/zh/tools/infracost-cloud-costs-in-pull-requests/

Infracost 的创始人在 2021 年融资时，用一句话概括了这个问题：工程师随手创建云资源，但在账单到来之前，没人告诉他们价格。对前线部署工程师（FDE）来说，这个缺口更疼，因为打开账单的人是客户，不是你。

你在客户的仓库里写 Terraform，合并、部署，然后转向下一件事。三周后，客户财务团队有人问：云支出怎么涨了？到那时，这个数字已经是真金白银，部署团队也失去了一点信任。

Infracost 填补的正是这个缺口。它把成本估算放进 pull request，趁评审者还能修改要合并的内容。

## 它做什么，支持哪些工具

官方文档对 Infracost 的描述是：把云成本更早地带入工程流程，而不是留到最后。它支持 Terraform、CloudFormation 和 AWS CDK，覆盖 AWS、Azure 和 Google Cloud。其目标很明确：在部署前，于 pull request 中发现成本问题。

Infracost 在 Hacker News 上发布时（属于 YC W21 批次），自我介绍是一款在 Terraform PR 上发评论的开源云成本估算工具，最初只支持 AWS 和 Google Cloud 上的 Terraform。

目前的 GitHub README 标明采用 Apache 2.0 许可证，并称成本差异和策略检查会直接发到 PR 上，就在你已经在用的工作流里。

免费版支持 Terraform、CloudFormation 和 CDK 的估算，上限为每月 1000 次运行。Cloud 版增加了成本护栏（Cost Guardrails）、Autofix 和自定义价目表。向客户承诺任何东西之前，先弄清这条界线在哪里。

## FDE 什么时候该用它？

“这个改动每月要花多少钱？”这个问题常常在演示中途冒出来。有了 Infracost，答案已经在 PR 里，连同与现有基础设施的差额。如果客户的项目预算是硬约束，Infracost 官网对护栏的用途说得很直白：让每个上线的项目都不超预算。

交接也是好时机。你离开后，客户团队还会继续改 Terraform。一个在每个 PR 上运行的 Infracost 作业，会在你转去别的项目很久之后，继续给他们发出提醒。

## 一个最小的 GitHub Actions 示例

假设你提交一个 PR，给客户的检索增强生成（RAG）数据管道加一个数据库模块。根据 GitHub Actions 指南，Infracost 作业会在每个 PR 上运行，并发布两样内容：成本估算，以及值得采用的云财务管理（FinOps）实践。配置需要一个存放 CLI token 的 secret，以及工作流的 `pull-requests: write` 权限。

下面的骨架只展示这三样东西放在哪里。尖括号里的大写占位符是待填项：CLI 安装步骤、环境变量名、secret 名称和 `diff` 参数，都必须从 Infracost 的 GitHub Actions 指南原样照抄。

```yaml
name: infracost
on: pull_request

permissions:
  contents: read
  pull-requests: write   # 缺少此权限时，只有评论会失败

jobs:
  infracost:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # <INSTALL_INFRACOST_CLI_STEP>：从官方指南照抄
      - name: Infracost diff
        run: infracost diff <ARGS_PER_DOCS>
        env:
          <CLI_TOKEN_VAR>: ${{ secrets.<CLI_TOKEN_SECRET_NAME> }}
```

客户的评审者不必再读 HCL 去猜价格。他们看评论，了解成本变化多少，然后直接在 PR 里提问，比如这个配置是否真的需要这么大。

再假设这个模块触发了护栏。文档描述的顺序很精确：先发评论，然后 `diff` 命令以退出码 1 结束，作业失败。关键细节在于：作业失败并不足以阻止合并。只有在分支保护中把该作业设为必需状态检查，合并才会被阻止。

**要点:** 成本预警工具要想阻止合并，前提是仓库要求这项检查必须通过。

还有一个细节有助于排查问题。如果工作流没有 PR 的写权限，估算照样运行、照样上传，失败的只有评论。所以当 PR 上没有评论时，先检查工作流权限，再怀疑 Infracost 本身。

## 客户的数据去了哪里？

客户的安全团队首先会问这个。根据指南，代码在 CI runner 上解析，只有成本估算和 PR 元数据会发送到 Infracost Cloud。填写客户的安全问卷时，原样引用这句话并附上原文链接，不要自己转述。

## 要向客户讲清楚的局限

Infracost 给出的数字是部署前根据代码算出的估算，不是发票。它只看得到经过 IaC 和 pull request 的变更。有人在控制台里点出来的资源，不在它的视野内。

它能否拦截合并，也取决于仓库配置，而不是工具本身。此外，成本护栏和 Autofix 属于 Cloud 版。如果客户只用免费版，就不要承诺按预算自动拦截。

## 练习：像客户评审者一样读评论

在个人的 Terraform 仓库上配置这个工作流，然后提交一个测试 PR，加入一个收费资源。

Infracost 的评论出现后，带着三个问题去读：哪个资源对成本影响最大；这个数字是否符合你提交 PR 前的预期；如果这是客户的仓库，你会向 PR 作者问什么。

然后做两个实验。先去掉 `pull-requests: write` 权限，确认估算仍在运行，失败的只有评论。再开启分支保护，把该作业设为必需状态检查，提交一个让 `diff` 以退出码 1 结束的 PR，亲眼看看合并被阻止。

## 先学什么

打牢两项基础：Terraform 要熟练到能读懂基础设施变更，GitHub Actions 要熟练到能配置 secret、权限和分支保护。Infracost 完全依赖这两者。掌握之后，安装它所花的时间，远比向客户解释为什么要用它少得多。

上面的练习还能当作品集。保留带成本评论的测试 PR 和合并被阻止的截图，在 FDE 面试中讲出多数人忽略的细节：除非仓库要求这项检查，否则作业失败什么也拦不住。面试官会看出你理解的是机制，而不只是工具的名字。

客户很少记得你部署得有多快。他们记得的是，月底的账单没有意外。

**本周动手试试:**

- 用 GitHub Actions 在个人 Terraform 仓库上运行 Infracost，读一读测试 PR 上的成本评论
- 去掉 pull-requests: write 权限，验证估算照常运行，失败的只有评论
- 开启分支保护，把 Infracost 作业设为必需状态检查，再提交一个突破护栏的 PR，观察合并被阻止

## 信源

- [Infracost Docs](https://www.infracost.io/docs/)

- [infracost/infracost (GitHub README)](https://github.com/infracost/infracost)

- [GitHub Actions | Infracost](https://www.infracost.io/docs/integrations/github_actions/)

- [Launch HN: Infracost (YC W21) – open-source cloud cost estimator](https://hn.svelte.dev/item/26064588)

- [Announcing Infracost’s seed fundraising from Sequoia, Y Combinator & SV Angel](https://www.infracost.io/resources/blog/infracost-sequoia-seed)

- [Infracost](https://www.infracost.io/)

- [Infracost Pricing](https://www.infracost.io/pricing/)
