genusbiz/az-cli-helm

Azure CLI with Helm 2 镜像文档

镜像概述

本Docker镜像预集成了Azure CLI和Helm 2，提供开箱即用的容器化环境，无需本地手动安装配置即可同时使用这两款工具。旨在简化需要同时管理Azure云资源和Kubernetes应用的场景，确保工具版本一致性和操作环境隔离。

核心功能与特性

• 工具链集成：预安装Azure CLI（最新稳定版）和Helm 2，满足Azure资源管理与Kubernetes包管理双重需求
• 即开即用：容器启动后可直接执行az（Azure CLI命令）和helm（Helm 2命令），省去手动安装步骤
• 环境隔离：容器化运行避免与本地工具版本冲突，支持多项目并行操作
• 轻量基础：基于官方轻量级基础镜像（如Alpine/Debian Slim）构建，减少镜像体积

使用场景

1. CI/CD流水线：在自动化部署流程中执行Azure资源配置（如创建AKS集群、资源组）和Kubernetes应用部署（Helm 2 chart安装）
2. 本地开发测试：开发者无需在本地系统安装工具，通过容器快速启动操作环境，避免系统环境污染
3. 多环境一致性：确保开发、测试、生产环境使用相同版本工具链，消除版本差异导致的部署问题
4. 临时操作环境：快速启动容器完成Azure/Kubernetes临时操作，结束后自动销毁，无环境残留

使用方法

1. 拉取镜像

bash
docker pull [镜像仓库地址]/azure-cli-helm2:latest

注：请将[镜像仓库地址]替换为实际镜像仓库（如Docker Hub、私有仓库等）

2. 基本运行命令

以交互式终端模式启动容器：

bash
docker run -it --rm [镜像仓库地址]/azure-cli-helm2:latest /bin/bash

• -it：启用交互式终端，支持命令输入输出
• --rm：容器退出后自动删除，避免资源残留

3. Azure CLI 操作

容器内通过az命令管理Azure资源，首先需完成Azure认证：

bash
# 交互式登录Azure（支持浏览器登录或设备码登录）
az login

# 示例：列出Azure订阅
az account list --output table

# 示例：创建Azure资源组
az group create --name myResourceGroup --location eastus

# 示例：管理AKS集群
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster

4. Helm 2 操作

使用Helm 2管理Kubernetes应用，需先确保容器可访问Kubernetes集群（通常通过挂载kubeconfig实现）：

bash
# 挂载本地Kubernetes配置文件（宿主机需已配置kubectl访问集群）
docker run -it --rm -v ~/.kube/config:/root/.kube/config [镜像仓库地址]/azure-cli-helm2:latest /bin/bash

# 初始化Helm 2客户端（首次使用时，如需服务端Tiller请确保集群已部署）
helm init --client-only

# 示例：添加Helm仓库并更新
helm repo add stable https://charts.helm.sh/stable
helm repo update

# 示例：安装应用chart
helm install stable/nginx-ingress --name my-nginx-release

配置说明

数据持久化与挂载

• Kubernetes配置：通过-v ~/.kube/config:/root/.kube/config挂载宿主机Kubernetes配置，使Helm 2可访问目标集群
• Azure配置：通过-v ~/.azure:/root/.azure挂载宿主机Azure CLI配置目录，实现登录状态持久化

环境变量

当前镜像无预定义环境变量，工具配置通过命令行参数或挂载配置文件实现。如需自定义Azure CLI/Helm 2行为，可在容器运行时执行对应配置命令。

注意事项

• Helm 2兼容性：Helm 2已停止官方维护，建议仅用于兼容旧有Helm 2 charts或依赖Tiller的场景，新环境优先使用Helm 3
• 版本管理：镜像中Azure CLI为构建时最新稳定版，如需特定版本可通过自定义Dockerfile构建或获取对应版本标签
• 安全建议：生产环境中避免直接挂载包含敏感信息的配置文件，建议通过密钥管理服务（如Azure Key Vault）注入认证信息