基础设施管理
基础设施管理
文档指南
请输入
- 文档首页
基础设施管理用户指南资源栈管理创建资源栈
复制全文
下载 pdf创建资源栈
文档反馈
问问助手资源栈（Stack）是 Infra Manager 中用于编排和管理云资源的逻辑单元。通过创建资源栈，您可以将 Git 仓库中的 Terraform 模板与火山引擎账号关联，实现一组云资源的自动化部署与生命周期管理。
准备 Terraform 项目
- 使用资源栈前，请先将本地 Terraform 项目推送至 Git 仓库或者存到 TOS 桶。
- 如需了解 Terraform 项目的编写规范，请参考：Terraform 开发指南。
- 本文示例所用的项目结构与完整代码，详见文末“示例项目代码”章节。
- 您可以通过选择 Github 代码仓库或者存储桶下作为您的模板来源。
选择模板来源
Github 代码仓库
- 进入 基础设施管理 控制台，在顶部菜单栏的地域下拉列表，选择所在地域。
- 在资源栈列表页面，单击创建资源栈。
- 如未授权过，点击“前往授权”，此时将跳转创建 CodeConnector 并进行授权，完成后可以在 Github Settings 页点击 Applications 查看应用安装及授权情况。
- 授权完成后选择代码仓库所属用户。
- 选择用户后选择代码仓库名称。
- 选择仓库后选择目标分支。
- 指定 Terraform 模板文件（.tf）相对于仓库根目录的存放路径，默认为仓库根目录（/）。
- 选择是否开启“自动更新”，开启后对应仓库代码分支有新提交时，将自动触发部署动作。
- 选择 Terraform 或者 OpenTofu 的引擎版本。
存储桶
- 将代码存储在 TOS 桶，可以是文件夹或者压缩包。
- 进入 TOS 控制台，进入到模板所在文件目录，复制存储桶URL，有以下三种方式复制：
- 点击“复制路径”，若为压缩包，需要在URL下补齐文件名称。
- 点击操作列下的“详情”，点击 URL 后的“生成并复制预签名链接”即完成复制。
- 点击操作列的“分享”，限制 URL 有效期，完成创建分享。
- 在 InfraManager 控制台选择模板来源为存储桶，填入上述的 URL
- 指定 Terraform 模板文件（.tf）相对于仓库根目录的存放路径，默认为仓库根目录。
- 选择 Terraform 或者 OpenTofu 的引擎版本。
配置资源栈参数
- 填写资源栈名称和描述信息。
- 配置模板参数，模板参数是从 variables.tf 文件中解析。
注意：
- 若您通过 terraform.tfvars 或 terraform.tfvars.json 文件管理变量，系统将优先解析并展示这些变量文件中的值；其中标记为 sensitive = true 的参数将以脱敏形式展示。
- Infra Manager 始终以最近一次触发源（Git 提交、控制台或 OpenAPI）传入的变量值为准。因此当启用「自动更新」时，不建议直接在控制台修改变量，避免后续 Git 推送触发的部署覆盖控制台所做的改动。
配置委托角色
您可以创建一个可信实体为 Infra Manager 的 IAM 角色，并按照"最小权限原则"为其授予 Terraform 模板中所涉及资源的操作权限。指定委托角色后，Infra Manager 将使用该角色而非您的个人身份执行部署。这样可以避免因个人权限变更、临时凭证过期等原因导致部署失败，并保障定时触发、Git 自动触发等无人值守场景下的部署任务连续可靠。
- 首先前往访问控制创建角色，选择信任身份为服务。
- 选择服务“基础设施管理器（IaC工作台）”，角色的授信策略如下：
- 授信完成后为角色授予实际编排资源所需的权限，注意使用 cc 版本的 Terraform 除了服务相关操作权限如 VPCFullAccess 外，还需授予 CloudControl 服务权限如 CloudControlFullAccess，更多 Terraform 授权管理参考：Terraform 权限管理
- 配置完成后即可在 Infra Manager 控制台选择该角色。
资源栈部署配置
支持以下高级部署配置项：
- 失败回滚：开启后，若本次部署失败，系统会自动尝试删除新建资源或将变更回滚至上一稳定状态。注意，受部分云产品能力限制，回滚遵循尽量原则，不保证 100% 还原；若回滚失败，会在日志事件中提示。
- 删除保护：开启后，将禁止通过控制台或 OpenAPI 删除该资源栈，避免误操作；如需删除，请先关闭此开关。
- 超时时间：默认 60 分钟，可配置范围 10–720 分钟。若资源在指定时间内未完成创建或更新，系统将自动终止本次部署任务。
确认并执行部署
- 确认配置信息无误。
- 点击直接部署资源栈，此时将立即开通资源栈内所有资源，且会依据开通资源产生相关费用。
- 若暂不部署，可单击保存将当前配置保存为草稿，后续可再编辑或部署。
查看部署结果
- 资源栈部署状态为部署成功。
- 事件展示部署操作成功。
- 资源页展示已创建出来的资源，也可前往产品控制台查看资源详情。
示例项目代码
- 项目文件目录
- provider.tf 文件代码，声明使用的 Provider 及其来源，并配置 region
- variables.tf，声明所有可配置的输入变量，均带默认值。
- main.tf，核心资源定义：先创建 VPC，Subnet 通过引用 volcenginecc_vpc_vpc.vpc-demo.id 关联到该 VPC。
- outputs.tf，声明 apply 后导出的资源属性。
- 完成上述文件编写后，请通过 git add → git commit → git push 将项目推送至远程仓库，确保 Infra Manager 能拉取到最新代码。
最近更新时间：2026.09.28 15:53:29
这个页面对您有帮助吗？
有用
有用
无用
无用