2.0 KiB
2.0 KiB
title, type, tags, sources, last_updated
| title | type | tags | sources | last_updated | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| cross-account.json | concept |
|
|
2026-05-15 |
Overview
cross-account.json 是部署在 Terraform 模块目录中的一个约定俗成的标记文件（Marker File），用于告知 Jenkins CI/CD 流水线该模块需要调用跨账号部署逻辑。
Purpose
在复杂的 AWS Landing Zone 环境中，并非所有 Terraform 模块都需要跨账号部署：
- 普通模块：仅在单一账号内运行，使用标准 Jenkins → EDR 流水线
- 跨账号模块：需要在多个账号中同时创建资源（如 DNS 配置 + 应用部署）
cross-account.json 作为信号标记，区分这两类模块。
How It Works
module-directory/
├── main.tf
├── variables.tf
├── outputs.tf
└── cross-account.json ← 标记文件（Jenkins 检测此文件）
- Jenkins 扫描：Jenkins 在检测模块时，检查目录中是否存在
cross-account.json - 识别类型：存在 → 触发跨账号部署流程；不存在 → 标准单账号流程
- 调用 EDR：触发 ECS-Deploy-Runner 执行跨账号 Terraform 操作
Content Example
cross-account.json 通常可以为空文件（文件名本身即标记），或包含简单配置：
{
"description": "This module deploys resources across multiple accounts",
"target_accounts": ["InfoBlocks", "Workload"],
"execution_order": ["InfoBlocks", "Workload"]
}
Relationships
- Jenkins ← detects ← cross-account.json
- ECS-Deploy-Runner ← triggered_by ← cross-account.json
- Cross-account-Terraform-Modules ← signaled_by ← cross-account.json
Related Concepts
- CI/CD Pipeline：Jenkins 是 CI/CD 流水线的大脑，通过此标记决定执行路径
- Cross-account-Terraform-Modules：该标记是跨账号 Terraform 模块的识别机制
- Marker-Pattern：约定优于配置（Convention over Configuration）的典型应用