Digger项目中多项目环境下的Azure凭证隔离方案

背景介绍

在基础设施即代码(IaC)实践中，使用Terraform管理多云环境时，经常需要为不同项目配置独立的云服务凭证和状态存储。Digger作为一款开源工具，能够帮助团队实现Terraform工作流的自动化管理。本文将详细介绍如何在Digger中实现Azure环境下多项目的凭证隔离配置。

核心挑战

当团队同时管理多个Azure项目时，通常会遇到以下需求：

1. 每个项目需要独立的服务主体(Service Principal)凭证
2. 不同项目需要隔离的状态存储账户
3. 需要避免凭证在配置文件中硬编码
4. 需要保持配置的可维护性和安全性

解决方案架构

1. 基础凭证配置

对于Azure认证的基础参数，可以在GitHub Actions工作流中全局设置：

env:
  DIGGER_AZURE_AUTH_METHOD: CLIENT_SECRET
  DIGGER_AZURE_TENANT_ID: ${{ secrets.ARM_TENANT_ID }}

这些参数通常是跨项目共享的，如认证方法和租户ID。

2. 项目级隔离配置

针对每个项目的特有参数，应在digger.yml配置文件中通过工作流定义：

projects:
- name: sandbox
  dir: ./sandbox/
  workflow: sandbox_workflow

workflows:
  sandbox_workflow:
    env_vars:
      commands:
        - name: DIGGER_AZURE_CLIENT_ID
          value: ${{ secrets.ARM_CLIENT_ID_SANDBOX }}
        - name: DIGGER_AZURE_CLIENT_SECRET
          value: ${{ secrets.ARM_CLIENT_SECRET_SANDBOX }}
        - name: DIGGER_AZURE_SA_NAME
          value: "stmysotrageaccounttfstate"

3. 安全最佳实践

• 所有敏感凭证必须通过GitHub Secrets管理
• 为每个环境创建独立的Azure服务主体
• 为每个项目分配专用的存储账户
• 遵循最小权限原则配置Azure RBAC

实现细节

环境变量继承机制

Digger采用分层环境变量管理：

1. 全局级：在CI/CD工作流中定义
2. 项目级：在digger.yml的工作流部分定义
3. 执行级：在terraform命令中传递

状态存储隔离

通过为每个项目设置不同的DIGGER_AZURE_SA_NAME，可以实现：

• 独立的状态文件存储
• 细粒度的访问控制
• 隔离的锁定机制

多订阅支持

当项目跨越多个Azure订阅时，可以通过：

1. 为每个订阅创建独立的服务主体
2. 在项目配置中指定对应的客户端ID/密钥
3. 配置订阅级的存储账户

常见问题解决

环境变量未生效

确保：

1. 工作流名称与项目配置匹配
2. 变量名称前缀正确(DIGGER_AZURE_)
3. Secrets已在仓库设置中正确配置

权限问题

检查：

1. 服务主体对目标订阅的权限
2. 存储账户的访问控制列表
3. Key Vault访问策略(如使用)

扩展应用

此模式同样适用于：

• AWS的跨账户管理
• GCP的多项目配置
• 混合云环境下的凭证管理

通过合理设计Digger配置，团队可以实现安全、灵活的多云基础设施管理，同时保持配置的清晰和可维护性。