bridgecrew/terraformer
bridgecrew
Terraformer是一个CLI工具，可从现有基础设施生成Terraform配置文件（tf/json）和状态文件（tfstate），支持多种云服务和基础设施软件，帮助实现现有资源的Terraform管理与迁移。
1 次收藏下载次数: 0状态：社区镜像维护者：bridgecrew仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Terraformer
镜像概述
Terraformer是一个命令行工具，用于基于现有基础设施生成Terraform配置文件（.tf/.json）和状态文件（tfstate），实现"反向Terraform"功能。该工具支持多种云服务提供商、基础设施软件及网络服务，帮助用户将现有手动部署的资源纳入Terraform管理，实现基础设施即代码（IaC）的迁移与维护。
核心功能
- 配置文件生成：为支持的资源生成Terraform配置文件（HCL或JSON格式）和对应的状态文件
- 远程状态支持：可将生成的状态文件上传至GCS存储桶
- 资源关联：通过
terraform_remote_state连接本地或存储桶中的资源 - 自定义文件结构：支持通过参数自定义生成文件的文件夹树模式
- 资源过滤：可按资源名称、类型、ID或属性筛选需要导入的资源
- 版本兼容：支持Terraform 0.13+（Terraform 0.11需使用v0.7.9版本）
- 计划功能：生成导入计划文件，支持在导入前编辑资源列表
使用场景
- 基础设施迁移：将现有手动部署的云资源（如AWS、GCP、Azure等）转换为Terraform配置
- IaC审计：生成现有基础设施的Terraform配置，用于审计和合规检查
- 配置基线生成：为新项目提供基于现有资源的配置基线
- 多环境同步：基于生产环境资源生成测试/开发环境的配置模板
- 资源文档化：通过生成的配置文件记录现有基础设施结构
使用方法
Docker运行示例
bash# 基本使用：生成AWS VPC和子网的配置 docker run -v $(pwd):/app docker.xuanyuan.run/terraformer import aws --resources=vpc,subnet --regions=eu-west-1 --profile=prod # 带过滤条件：仅导入指定ID的VPC docker run -v $(pwd):/app docker.xuanyuan.run/terraformer import aws --resources=vpc --filter=vpc=vpc-12345678 --regions=eu-west-1 # 生成计划文件，编辑后再导入 docker run -v $(pwd):/app docker.xuanyuan.run/terraformer plan google --resources=networks,firewall --projects=my-project --regions=europe-west1-d docker run -v $(pwd):/app docker.xuanyuan.run/terraformer import plan generated/google/my-project/terraformer/plan.json
主要配置参数
| 参数 | 说明 | 示例 |
|---|---|---|
--bucket | GCS存储桶路径，用于存储远程状态 | gs://terraform-state |
--connect | 是否连接资源（默认true） | --connect=false |
--compact | 是否将服务资源合并到单个文件（默认false） | --compact |
--excludes | 排除的资源类型，逗号分隔 | firewalls,networks |
--filter | 资源过滤条件，格式为资源类型=id1:id2 | vpc=vpc-123:vpc-456 |
--output | 输出格式（hcl或json，默认hcl） | --output=json |
--path-output | 输出目录（默认"generated"） | --path-output=tfconfig |
--path-pattern | 输出路径模式 | {output}/{provider}/{service}/ |
--regions | 区域列表，逗号分隔（默认global） | europe-west1,us-east1 |
--resources | 要导入的资源类型，*表示所有 | vpc,subnet,sg |
--state | 状态存储位置（local或bucket，默认local） | --state=bucket |
--verbose | 详细输出模式 | --verbose |
资源过滤
ID过滤
通过资源ID筛选要导入的资源，多个ID用冒号分隔：
bashdocker run -v $(pwd):/app docker.xuanyuan.run/terraformer import aws --resources=vpc --filter=vpc=vpc-123456:vpc-789012 --regions=eu-west-1
属性过滤
通过资源属性筛选，格式为Name=属性名;Value=值1:值2：
bashdocker run -v $(pwd):/app docker.xuanyuan.run/terraformer import aws --resources=ec2_instance --filter="Name=tags.env;Value=prod:staging" --regions=eu-west-1
资源结构
默认生成文件路径：{output}/{provider}/{service}/{resource}.tf
可通过参数调整：
--compact：将服务下所有资源合并到resources.tf--path-pattern：自定义路径模式，如--path-pattern {output}/{provider}/将所有服务资源放在同一目录
支持的服务提供商
主要云服务
- Google Cloud (GCP)
- AWS
- Azure
- AliCloud
其他云服务
- DigitalOcean、Fastly、Heroku、Linode、NS1、OpenStack、Vultr、Yandex.Cloud
基础设施软件
- Kubernetes、OctopusDeploy、RabbitMQ
网络服务
- Cloudflare
版本控制
- GitHub
监控与系统管理
- Datadog、New Relic
社区支持
- Keycloak、Logz.io、Commercetools、Mikrotik、GmailFilter
权限要求
工具需要对目标服务具有只读权限，以列出和获取资源信息。具体权限因服务提供商而异，通常需要能列出资源、获取资源详情的权限。
注意事项
- Terraform 0.11用户需使用Terraformer v0.7.9版本
- 生成配置后，建议手动检查和调整，特别是资源依赖关系
- 部分资源可能需要特定版本的Terraform provider支持，需确保provider版本兼容
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 terraformer 镜像标签
docker pull docker.xuanyuan.run/bridgecrew/terraformer:<标签>
DockerHub 原生拉取命令
docker pull bridgecrew/terraformer:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"