SuperAPI AI 工具集

volcengine-iac

部署与运维

查看项目

更新于 10-19 18:19

技能介绍

用途

volcengine-iac 用于在用户明确选择 Terraform/IaC 时,为火山引擎资源生成、规划并应用 Terraform 基础设施。它适用于以下情形:用户要求使用 Terraform 或 IaC;用户已有 Terraform 状态或工作区;plan/diff/漂移检测很重要;基础设施需要长期由团队管理且用户选择 IaC;部署涉及 VKE、托管数据库/缓存/存储、负载均衡、域名/证书、IAM/KMS、日志、监控或 Serverless 触发器,并且用户选择 IaC。

以下情况不应使用本技能:用户要求使用 CLI、临时演示或快速验证、不带 plan/diff/destroy 需求的纯 ECS 单机服务,或 Terraform/provider 安装受阻且目标可安全使用 CLI 回退。不应仅因为部署长期存在、基于 VKE 或带有托管依赖就自动使用 IaC,而应建议并让用户选择。应用打包、运行时发布、健康检查、CLI 资源账本部署仍由 volcengine-deploy 负责。

主要能力

新示例优先使用 Cloud Control provider volcengine/volcenginecc。assets/examples/ 下提供经过验证的示例,assets/modules/ 下保留旧版 volcengine/volcengine provider 的可复用模块(网络、VKE、CR、RDS MySQL、Redis、TOS),直至各组件用 volcenginecc 重新验证。受阻塞资源记录在 references/volcenginecc-blocked.md。

技能附带用于生成 tfvars、plan 摘要、输出导出和漂移检查的包装脚本。默认将 Terraform 工作文件写入 .volcengine/terraform/。小型一次性实验可使用本地状态;需要远程状态时可用 TOS 的 S3 兼容后端。

使用方式

前置条件:环境变量 VOLCENGINE_ACCESS_KEY、VOLCENGINE_SECRET_KEY、VOLCENGINE_REGION;工具 terraform >= 1.5、jq、git、python3。可选读取 .volcengine/deploy-choice.json。

路径 A:由 .volcengine/deploy-choice.json 驱动,用 gen_tfvars.py 生成 terraform.tfvars(该脚本只写 tfvars,不生成 Terraform 配置文件)。路径 B:自然语言输入时,一次性询问项目名、地域、是否需要 VKE、有状态依赖(MySQL/PostgreSQL/Redis/TOS)、负载档位(light/standard/heavy),再从已验证示例或旧版模块组装配置。路径 C:复制相关已验证示例,执行 terraform init -backend=false -input=false、terraform validate、terraform plan -out=tfplan.binary -input=false。

计划阶段用 plan_summary.sh 按 CREATE/UPDATE/DELETE/REPLACE 分组展示变更,apply 前必须用户明确确认,不使用 -auto-approve。成功后运行 export_outputs.sh 将输出写入 .volcengine/iac-outputs.json(权限 0600),供下游使用。销毁前先展示 terraform plan -destroy 摘要并二次确认;prod 工作区需额外输入 destroy prod 确认。漂移检测用 check_drift.sh,返回 0/2/1 分别表示无漂移、有漂移、检查出错。导入既有资源使用 terraform import,导入后通过修改配置而非状态来对齐。

适用场景

典型部署组合:ECS(network、ecs、可选 TLS/CloudMonitor);VKE(network、vke、cr、CLB/ALB);veFaaS(vefaas、可选 APIG/TLS);有状态 Web 应用(运行时栈加 RDS、Redis、TOS);私有服务(运行时栈加私有 NAT 或网络连通);域名入口(运行时栈加 DNS 和负载均衡证书)。示例目录覆盖网络、NAT、VPN、DirectConnect、CEN、DNS、ECS、EBS、Auto Scaling、VKE、CR、CLB/ALB、APIG、veFaaS、RDS MySQL/PostgreSQL/MSSQL、Redis、Kafka、TOS、TLS、CloudMonitor、IAM、FileNAS、EFS 等。

限制与安全规则

不要读取 ~/.volcengine/config.json(可能含明文 AK/SK);不要提交 terraform.tfstate* 或 .volcengine/iac-outputs.json;不要给 apply/destroy 传 -auto-approve;共享环境每次 apply 前运行 check_drift.sh;含 kubeconfig 或密钥的文件设为 0600;每个模块/示例固定 provider 版本。国内网络访问 registry.terraform.io 可能受阻或缓慢,失败时需配置文件系统或内部镜像;若仍不可行,应回退询问是否使用 CLI 资源账本路径。TOS 后端需 skip_requesting_account_id = true,不得设置 force_path_style/use_path_style;TOS 后端无 DynamoDB 式锁,并发 apply 需人工协调。RDS/Redis 的 REPLACE 意味着数据丢失,需中止检查。具体资源的导入 ID、字段选择和 provider 注意事项需查阅对应的 references/volcenginecc-*.md 或 references/modules.md。