2. Backstage服务模板基础：服务模板的定义、组成要素

在Backstage平台中，服务模板（Service Template）是开发者自服务创建新服务的标准化起点。它封装了组织内部的最佳实践、合规基线以及基础设施配置，确保每一个新服务从诞生之初就具备可观测、可运维、可扩容的基因。对于SRE和容量规划专家而言，理解服务模板的组成要素，是后续进行容量水位SLO复核的前提——因为模板决定了服务的基础资源规格、监控埋点以及弹性策略。

2.1 服务模板的定义

服务模板本质上是一个参数化的脚手架，它通过Backstage的软件模板插件（Scaffolder）驱动，将用户输入的变量（如服务名称、所属团队、技术栈版本）注入到预定义的模板文件中，最终生成一个完整的代码仓库和基础设施配置。模板不仅仅是代码的复制，更是一套治理规则的载体。

2.2 组成要素详解

2.2.1 软件模板（Software Template）

软件模板是服务模板的代码骨架，它决定了新服务的技术栈选型、目录结构、依赖管理以及基础代码规范。Backstage使用Nunjucks或Handlebars模板引擎，在生成时动态替换变量。

2.2.2 配置文件（Configuration Files）

配置文件是服务模板的元数据与运行时参数层。在Backstage生态中，最重要的配置文件包括：

• catalog-info.yaml：服务在Backstage目录中的注册信息，包含服务名称、所属系统、API文档链接、负责人等。
• app-config.yaml：Backstage应用级别的配置，用于控制插件行为、代理设置、认证方式。
• 环境变量模板：如 .env.example，定义服务运行所需的环境变量及其默认值。
• 资源配额声明：如 resource-quotas.yaml，声明CPU、内存、存储的初始请求与限制。

2.2.3 基础设施即代码（Infrastructure as Code, IaC）

IaC是服务模板中最直接影响容量水位的组成部分。它定义了服务运行所需的云资源、网络拓扑、扩缩容策略以及监控告警规则。常见的IaC工具包括：

• Terraform / OpenTofu：声明式云资源编排，定义VPC、子网、负载均衡器、数据库实例等。
• Pulumi：使用通用编程语言（TypeScript、Python、Go）定义基础设施，适合复杂逻辑场景。
• Kubernetes Manifests / Helm Charts：容器编排配置，定义Deployment、Service、HPA（水平自动扩缩容）、PDB（Pod预算）等。
• Crossplane：面向Kubernetes的控制平面，将云资源抽象为K8s CRD。

2.3 服务模板的完整生命周期

理解模板的组成后，还需要知道它在Backstage中的完整流转路径：

1. 模板注册：将模板仓库注册到Backstage的软件模板插件中。
2. 参数填写：开发者在Backstage UI中选择模板，填写服务名称、所属团队、环境等参数。
3. 模板渲染：Scaffolder插件根据参数，使用模板引擎生成最终代码和配置。
4. 仓库创建：将渲染后的内容推送到新的Git仓库（GitHub、GitLab、Bitbucket）。
5. 基础设施部署：CI/CD流水线触发IaC执行，创建或更新云资源。
6. 目录注册：catalog-info.yaml被Backstage目录解析，服务出现在软件目录中。

2.4 模板与容量水位SLO的关联

服务模板的每一个组成要素，最终都会影响服务的容量水位和SLO达成：

• 软件模板决定了应用的性能基线（如框架开销、依赖体积）。
• 配置文件中的 catalog-info.yaml 标签可用于将服务分类到不同的容量监控组。
• IaC直接定义了初始资源规格、弹性策略和监控告警阈值——这是SLO复核最核心的数据来源。