文档中心

基础设施管理

用户指南

模板管理

模板管理是 InfraManager 中用于集中管理云上模板资产的能力，包含「模板广场」「我的模板」「Terraform Module」三个入口。您可以从官方公共模板、自有私有模板或可复用 Module 示例出发，一键创建资源栈，无需从零编写 HCL。

入口	说明	是否可直接创建资源栈
模板广场	官方维护的公共解决方案模板，只读，可查看详情、下载代码。	是
我的模板	用户通过 Github 代码仓库、存储桶或本地文件上传创建的私有模板，支持版本迭代。	是
Terraform Module	可复用的能力片段，本身不直接部署；每个 Module 附带可部署的示例（Example）。	通过 Module 示例创建

模板广场

模板广场是 InfraManager 提供的公共模板库，由火山引擎官方维护，按应用场景与云产品分类。您可以在模板广场中搜索模板、查看详情，并基于模板一键创建资源栈。

进入模板广场

在左侧导航选择「模板管理 > 模板广场」。

浏览、搜索与筛选模板

搜索：在顶部搜索框输入模板名称或适用场景关键词，列表实时过滤。

标签筛选：在标签栏按分类单选切换，具体标签以控制台线上为准。

卡片信息：每张卡片展示模板名称、业务标签、模板简介与架构图预览。

查看模板详情

在模板广场单击目标模板卡片，进入模板详情页。

在详情页查看基础信息：模板名称、模板描述、应用场景、版本号与发布时间。

通过「版本号」下拉切换版本，最新发布版本显示为「vX (LATEST)」；切换后部署说明、模板代码与下载内容同步切换到所选版本。

在内容区域切换「部署说明」与「模板代码」两个页签：

「部署说明」：以 Readme 形式展示参数说明、前置条件与部署步骤。

「模板代码」：只读展示该版本的完整 Terraform 代码，支持一键复制。

下载模板代码

在详情页右上角通过版本下拉选定目标版本。

单击「下载模板」，浏览器下载当前所选版本的代码压缩包。

注意：下载的代码与页面当前查看的版本保持一致；公共模板不可在线编辑，如需修改请下载后通过「我的模板 > 创建模板」以上传方式导入。

（可选）基于模板创建资源栈

在模板详情页右上角单击「创建资源栈」（从模板广场单击目标卡片即可进入详情页）。

系统跳转至创建资源栈页面，并自动回填在线模板分类、所选模板与默认（最新）版本。

按页面提示填写模板参数，确认后创建资源栈。

注意：跳转后的参数配置、资源预览与部署流程与「创建资源栈」一致，详见对应文档，本文不再重复。创建资源栈后，后续不因模板发布新版本而自动升级，需在资源栈侧显式选择新版本。

我的模板

我的模板是您通过 Github 代码仓库、存储桶或本地文件上传保存的私有模板集合，仅在您自身权限范围内可见与使用。您可以对模板进行版本迭代，并基于指定版本创建资源栈。

进入我的模板

在左侧导航选择「模板管理 > 我的模板」。

列表展示模板名称及模板 ID、描述、最新版本、创建时间与操作列；每条模板提供「查看详情」「编辑」「创建资源栈」操作。

创建我的模板

在我的模板列表页单击「创建模板」。

填写模板名称（必填）与模板描述（用于说明用途与适用场景，请按控制台要求填写）。

模板来源以卡片式单选提供「Github 代码仓库」「存储桶」「本地文件上传」三类，选择后在下方展开对应配置项。

系统对上传内容做轻量静态校验（至少包含一个 .tf 或 .tf.json 文件；ZIP 压缩包需可正常解压且未加密），校验通过后创建模板，首个版本号默认为 v1，只读展示。

单击「立即创建」。

来源：Github 代码仓库

选择来源为「Github 代码仓库」。

依次选择已授权的代码仓库用户、代码仓库名称与代码仓库分支。

填写模板名称、描述，单击「立即创建」。

注意：使用 Git 来源前，请先按「创建资源栈」中的说明完成代码仓库授权；未授权的仓库不会出现在可选列表中。

来源：存储桶

选择来源为「存储桶」。

选择存储桶与模板对象路径（指向 .tf 文件或 .zip 压缩包）。

填写模板名称、描述，单击「立即创建」。

来源：本地文件上传

选择来源为「本地文件上传」。

在文件选择区上传 .tf、.tf.json 或 .zip 文件。

填写模板名称、描述，单击「立即创建」。

注意：创建模板时仅做轻量静态解析与校验，不访问云资源、不下载外部依赖。

更新模板（创建新版本）

在我的模板列表单击目标模板的「编辑」，进入编辑模板页。

按需修改模板名称与模板描述；在「更新方式」中选择「使用当前模板」或「替换当前模板」。

选择「替换当前模板」后，在展开的来源区选择「Github 代码仓库」「存储桶」或「本地文件上传」，并提交新的模板代码。

单击「保存」。校验通过后，系统在当前最新版本基础上自动生成新版本（如 v1 更新为 v2）。

说明：新版本独立保存，不覆盖历史版本；模板详情中的代码查看、下载与部署均基于选定版本的不可变快照。已有资源栈不会因模板发布新版本而自动更新，需在资源栈更新流程中显式选择新版本。

注意：「编辑」可修改模板名称、模板描述，并通过「更新方式」选择「替换当前模板」提交新的模板代码以创建新版本；InfraManager 不支持在控制台内联编辑模板代码。

使用我的模板创建资源栈

在我的模板列表单击目标模板的「创建资源栈」。

系统跳转至创建资源栈页面，并自动回填该模板的最新版本。

按页面提示填写模板参数并完成部署，流程与「创建资源栈」一致。

删除模板与版本

删除版本：在模板详情页通过「版本号」下拉选定目标版本，单击右上角「…」操作并选择「删除版本」，仅删除当前选定的版本；当模板仅有一个版本时不可删除。

删除模板：在模板详情页单击右上角「…」操作并选择「删除模板」，在确认弹窗中单击「确定」；删除将移除该模板的全部版本与模板信息。

警告：删除模板或版本不会删除已基于其创建的资源栈及其底层云资源；资源栈需在「资源栈管理」中单独删除。被资源栈引用过的版本快照与来源信息仍会保留，以保证历史部署可追溯。

Terraform Module

Terraform Module（官网地址：https://github.com/terraform-volcenginecc-modules）是可复用的 Terraform 模块封装。InfraManager 在控制台提供官方 Module 索引，您可以查看 Module 的使用说明、输入输出、版本与源代码，并基于 Module 附带的可部署示例（Example）创建资源栈。

Module 与模板的区别

维度	模板（模板广场 / 我的模板）	Terraform Module
用途	描述一组完整、可直接部署的基础设施。	封装可复用的能力片段，被模板引用拼装。
部署方式	可直接基于模板创建资源栈并部署生产资源。	本身不直接部署；通过其附带的示例（Example）创建资源栈，可用于前期测试验证。
入口	模板广场 / 我的模板。	Terraform Module 索引页。

浏览与搜索 Module

在左侧导航选择「模板管理 > Terraform Module」。

在搜索框输入 Module 名称或功能关键词查找。

列表采用卡片式布局，每张卡片展示 Module 名称与功能描述。

查看 Module 详情

单击卡片的「查看详情」进入 Module 详情页。

在基础信息区查看 Module 名称、描述、版本、创建时间、更新时间与官方代码仓库地址。

通过版本下拉切换版本，切换后使用说明、Module 代码与下载内容同步更新。

在「使用说明」与「Module 代码」页签间切换：

「使用说明」：展示输入变量、输出变量与引用示例。

「Module 代码」：只读展示所选版本的源代码。

（可选）基于 Module 示例创建资源栈

在 Module 列表或详情页单击「创建资源栈」。

若该 Module 包含多个示例（Example），在弹出的选择框中选择一个目标示例（如 basic、complete）。

确认后跳转至创建资源栈页面，在线模板分类、Module、示例、版本与模板路径自动回填，路径不可编辑。

填写模板参数并完成部署。

（可选）在模板中引用 Module

在 main.tf 中添加 module 块，source 填入详情页提供的 Module 引用地址，并按输入变量说明传参。

保存模板后，在创建资源栈时选择该模板。

注意：Module 版本升级后，已部署的资源栈不会自动跟随升级；如需使用新版本，请在资源栈侧显式指定新版本并触发更新。

最近更新时间：2026.10.16 16:31:24

这个页面对您有帮助吗？

有用

无用