webdevops/helm-azure-tpl

镜像概述

本镜像为Helm插件，专注于在Helm工作流中集成Azure资源模板，旨在简化Azure云环境中基于Helm的应用部署流程。通过该插件，开发者和运维人员可高效管理结合Kubernetes资源与Azure基础设施的应用部署，实现Azure资源模板与Helm图表的统一处理和生命周期管理。

核心功能与特性

1. Azure资源模板集成

• 支持Azure资源管理器（ARM）模板与Helm图表的无缝集成，实现Kubernetes资源与Azure基础设施资源（如存储账户、虚拟网络、数据库等）的协同管理。
• 提供模板片段复用能力，允许在Helm图表中嵌入或引用外部Azure资源模板，减少重复配置。

2. 模板渲染与参数处理

• 支持从Helm值文件（values.yaml）、命令行参数或环境变量中动态注入Azure资源配置，实现模板参数的灵活替换。
• 提供模板验证功能，可在部署前检查Azure资源模板的语法正确性和参数完整性。

3. Azure认证与权限支持

• 兼容多种Azure认证方式：支持Service Principal、Managed Identity及Azure CLI认证，满足不同场景下的安全访问需求。
• 支持基于Azure RBAC的权限控制，可通过配置限制插件对Azure资源的操作范围。

4. Helm CLI无缝集成

• 作为Helm原生插件，可直接通过helm命令调用（如helm azure-template render），无需额外工具链，与现有Helm工作流无缝衔接。
• 支持与Helm核心命令（如install、upgrade、rollback）协同，在Helm操作过程中自动触发Azure资源模板的处理和部署。

5. 部署生命周期管理

• 支持Azure资源模板的部署前预览（what-if操作），可提前查看模板执行后的资源变更。
• 集成部署状态跟踪，可查询Azure资源的部署进度和结果，并与Helm发布状态关联。

使用场景与适用范围

1. Azure Kubernetes Service (AKS) 应用部署

适用于在AKS集群中部署应用时，需同时管理Kubernetes资源（如Deployment、Service）和Azure基础设施资源（如负载均衡器、存储卷）的场景，实现应用与底层资源的一体化部署。

2. Helm图表开发（Azure环境）

为Azure环境开发Helm图表时，需嵌入Azure资源配置（如AKS集群扩展、Azure密钥保管库引用）的场景，通过插件简化图表中Azure模板的开发、测试和维护。

3. 多云/混合云部署管理

在包含Azure的多云环境中，需统一使用Helm管理跨平台资源模板的场景，通过插件标准化Azure资源的处理逻辑，降低多云部署复杂度。

使用方法与配置说明

安装插件

通过Helm插件安装命令从指定源安装（需替换实际仓库或镜像地址）：

bash
# 从GitHub仓库安装（示例）
helm plugin install https://github.com/example/azure-helm-template-plugin

# 从OCI镜像仓库安装（示例）
helm plugin install oci://registry.example.com/helm/plugins/azure-template:v1.0.0

配置参数

插件运行需通过环境变量或命令行参数指定以下核心配置（根据认证方式选择）：

常用命令示例

1. 渲染Azure资源模板

将Helm值文件中的参数注入Azure模板并输出渲染结果：

bash
helm azure-template render ./my-helm-chart \
  --azure-resource-group my-aks-resource-group \
  --template-path ./templates/azure-storage-template.json \
  --values ./values-prod.yaml

2. 验证Azure模板配置

检查模板语法及参数完整性，输出验证结果：

bash
helm azure-template validate ./my-helm-chart \
  --azure-resource-group my-aks-resource-group \
  --template-path ./templates/azure-network-template.json

3. 部署Helm图表并关联Azure资源

通过Helm安装应用时，自动部署关联的Azure资源模板：

bash
# 使用Service Principal认证（提前配置环境变量）
export AZURE_TENANT_ID="xxxx-xxxx-xxxx-xxxx"
export AZURE_SUBSCRIPTION_ID="xxxx-xxxx-xxxx-xxxx"
export AZURE_CLIENT_ID="xxxx-xxxx-xxxx-xxxx"
export AZURE_CLIENT_SECRET="xxxx-xxxx-xxxx-xxxx"

helm install my-app ./my-helm-chart \
  --set azure.storageAccountName=myappstorage \
  --azure-resource-group my-aks-resource-group \
  --template-path ./templates/azure-resources.json

4. 预览模板部署效果 (What-If)

在实际部署前预览Azure资源模板的执行效果：

bash
helm azure-template what-if ./my-helm-chart \
  --azure-resource-group my-aks-resource-group \
  --template-path ./templates/azure-db-template.json \
  --values ./values-staging.yaml

注意事项

• 版本兼容性：需确保Helm CLI版本≥3.5.0，避免因版本不兼容导致插件功能异常。
• 权限配置：使用Service Principal认证时，需确保其拥有目标Azure资源组的“资源部署者”（Resource Deployer）或更高权限。
• 模板规范：Azure资源模板需符合ARM模板规范（Schema版本≥2019-04-01），避免因模板格式错误导致渲染失败。