oowy/infracost

Infracost Docker镜像文档

概述

Infracost是一款开源工具，用于估算和展示基础设施即代码（IaC）配置文件中定义的云基础设施资源成本。本Docker镜像由Oowy团队维护，将infracost可执行文件容器化，便于在容器环境中高效运行，支持主流IaC平台（如Terraform）和云服务提供商（AWS、Google Cloud、Azure等），帮助团队在部署前了解潜在成本，优化资源配置。

支持的标签

基于Alpine Linux 3.20

• latest
• 0.10.41-alpine3.20 0.10.40-alpine3.20

基于Alpine Linux 3.19

• 0.10.39-alpine3.19 0.10.38-alpine3.19 0.10.37-alpine3.19 0.10.36-alpine3.19 0.10.35-alpine3.19 0.10.34-alpine3.19 0.10.33-alpine3.19 0.10.32-alpine3.19 0.10.31-alpine3.19 0.10.30-alpine3.19

基于Alpine Linux 3.18

• 0.10.39-alpine3.18 0.10.38-alpine3.18 0.10.37-alpine3.18 0.10.36-alpine3.18 0.10.35-alpine3.18 0.10.34-alpine3.18 0.10.33-alpine3.18 0.10.32-alpine3.18 0.10.31-alpine3.18 0.10.30-alpine3.18

支持的架构

• amd64
• arm64v8

核心功能与特性

• 开源工具：Infracost为开源项目，支持自由使用和定制，代码透明可审计。
• 成本估算：快速解析IaC配置文件（如Terraform），生成详细的云资源成本 breakdown 报告。
• 多平台兼容：支持Terraform等主流IaC工具，适配AWS、Google Cloud、Azure等云服务提供商的资源定价模型。
• 容器化执行：镜像内置infracost可执行文件，可直接运行所有子命令，无需本地安装依赖。
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快，资源占用低，适合容器化环境部署。

使用场景与适用范围

• 开发阶段成本评估：开发人员编写IaC代码时，实时估算资源成本，提前优化配置，避免设计阶段引入高成本资源。
• 部署前成本审核：运维团队在基础设施部署前，通过成本估算识别潜在超支风险，确保符合预算要求。
• CI/CD流程集成：作为CI/CD流水线的环节，自动对代码提交或Pull Request进行成本检查，阻止高成本变更合并。
• 定期成本审计：对现有IaC配置定期执行成本分析，识别资源闲置或过度配置问题，优化云支出。

配置与使用方法

基本命令执行

通过Docker运行infracost命令，基本格式如下：

bash
docker run --rm infracost/infracost <子命令> [参数]

示例：查看版本信息

bash
docker run --rm infracost/infracost --version

挂载本地IaC配置文件

需分析本地IaC配置文件时，将本地目录挂载到容器，并指定工作目录：

bash
# 将当前目录挂载到容器的/app目录，在/app目录下执行breakdown命令
docker run --rm -v $(pwd):/app -w /app infracost/infracost breakdown --path=terraform/

上述命令会分析当前目录下terraform/文件夹中的配置文件，生成成本明细报告。

配置云服务提供商凭证

Infracost需要访问云服务提供商的定价数据（无需资源访问权限），可通过环境变量或配置文件传递凭证。以AWS为例：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_key \
  -v $(pwd):/app -w /app \
  infracost/infracost breakdown --path=terraform/

注：实际使用中，建议通过Docker secrets或环境变量文件传递敏感信息，避免命令行明文暴露。

自定义基础镜像

可基于此镜像构建包含预配置的自定义镜像，例如预设CLI配置：

dockerfile
# 自定义Dockerfile
FROM infracost/infracost:latest

# 设置默认工作目录
WORKDIR /infracost

# 预配置默认货币为USD
RUN infracost configure set currency USD

# 添加自定义CA证书（如需内部环境使用）
COPY ./ca-certificates.crt /etc/ssl/certs/

构建并使用自定义镜像：

bash
docker build -t my-custom-infracost .
docker run --rm my-custom-infracost breakdown --path=terraform/

社区支持

• 问题反馈：Infracost二进制相关问题，请在https://github.com/infracost/infracost%E6%8F%90%E4%BA%A4issue%E3%80%82
• Docker相关支持：可通过以下渠道获取帮助：
  • Docker社区Slack：https://dockr.ly/comm-slack
  • Server Fault：[***]
  • Unix & Linux Stack Exchange：https://unix.stackexchange.com/help/on-topic
  • Stack Overflow：https://stackoverflow.com/help/on-topic