用途:当用户明确要求 Terraform/IaC、已有 Terraform 状态或工作区、需要 plan/diff/漂移检测,或长期团队管理的基础设施选择 IaC 时,用 Terraform 管理火山引擎资源。应用打包、运行时发布、健康检查与 CLI 资源台账部署仍由 volcengine-deploy 负责。
主要能力:提供 assets/examples/ 下已验证的 volcenginecc 示例、assets/modules/ 下旧版 volcengine 模块,以及 tfvars 生成、计划摘要、输出导出、漂移检测等包装脚本。新示例优先使用 volcenginecc 提供方;被阻塞资源记录在 references/volcenginecc-blocked.md。
使用方式:需设置 VOLCENGINE_ACCESS_KEY、VOLCENGINE_SECRET_KEY、VOLCENGINE_REGION,并安装 terraform >= 1.5、jq、git、python3。工作文件默认写入 .volcengine/terraform/。可由 .volcengine/deploy-choice.json 驱动,或通过自然语言问答生成。典型流程:复制示例后执行 terraform init -backend=false -input=false、terraform validate、terraform plan -out=tfplan.binary -input=false,展示计划摘要并获用户确认后再 apply。远程状态可用 TOS S3 兼容后端,需先有 TOS 桶。
适用场景:ECS、VKE、veFaaS、有状态 Web 应用、私有服务、域名入口等组合栈,以及 VKE、托管数据库/缓存/存储、负载均衡、域名证书、IAM/KMS、日志监控、Serverless 触发器等。
限制:不用于 CLI、临时演示、纯 ECS 单机且无 plan/diff/destroy 需求,或 Terraform/提供方安装受阻且可安全回退 CLI 的情况。禁止使用 -auto-approve,apply/destroy 需显式确认,生产工作区销毁需二次确认。TOS 后端无 DynamoDB 式锁,需人工协调。中国网络可能无法访问 registry.terraform.io。部分资源输出缺失需用 CLI 查询。未提供价格与收费信息。