nathanielwroblewski/eks-helm-command

Helm命令执行镜像（EKS/K8s环境）

镜像概述

该Docker镜像提供了一个预配置的环境，用于在Amazon EKS（Elastic Kubernetes Service）、Helm和Kubernetes集群环境中运行任意Helm命令。通过集成必要的工具链，无需在本地系统单独安装配置Helm及Kubernetes客户端，即可实现容器化的Helm操作，确保环境一致性和操作便捷性。

核心功能与特性

• 完整工具链集成：预安装Helm客户端（支持v3+版本）和Kubernetes CLI（kubectl）
• EKS环境适配：内置AWS CLI及EKS认证相关工具，支持与EKS集群无缝集成
• 灵活命令支持：可执行任意Helm命令（install、upgrade、uninstall、list、repo管理等）
• 轻量级基础：基于Alpine或类似精简基础镜像，减小镜像体积
• 配置隔离：支持通过挂载外部配置文件（如kubeconfig）实现环境隔离

使用场景与适用范围

• CI/CD流水线：在自动化部署流程中执行Helm chart部署、更新操作
• 临时集群管理：无需本地配置Helm环境，快速在EKS集群上执行临时Helm命令
• 多环境一致性：确保开发、测试、生产环境使用统一版本的Helm工具链
• 环境隔离需求：避免本地Helm配置与集群环境冲突，提供独立操作空间

使用方法与配置说明

基本使用方式

通过docker run命令启动容器并执行Helm命令，需挂载Kubernetes配置文件（kubeconfig）以访问目标集群：

bash
docker run -v /path/to/local/kubeconfig:/root/.kube/config my-helm-image helm <command> [options]

与EKS集群集成

若目标为EKS集群，需配置AWS认证信息（可通过环境变量或挂载AWS凭证文件）：

bash
docker run \
  -v ~/.kube/config:/root/.kube/config \
  -v ~/.aws/credentials:/root/.aws/credentials \
  -e AWS_REGION=us-west-2 \
  my-helm-image \
  helm list --all-namespaces

常用命令示例

1. 安装Helm chart：

bash
docker run -v ~/.kube/config:/root/.kube/config my-helm-image helm install my-release ./my-chart

2. 更新Helm chart：

bash
docker run -v ~/.kube/config:/root/.kube/config my-helm-image helm upgrade my-release ./my-chart

3. 查看已安装release：

bash
docker run -v ~/.kube/config:/root/.kube/config my-helm-image helm list -n my-namespace

4. 添加Helm仓库：

bash
docker run my-helm-image helm repo add bitnami https://charts.bitnami.com/bitnami

环境变量配置

持久化配置

如需保留Helm配置（如仓库信息、release历史），可挂载Helm配置目录：

bash
docker run \
  -v ~/.kube/config:/root/.kube/config \
  -v ~/.helm:/root/.helm \
  my-helm-image \
  helm repo update

docker-compose配置示例

yaml
version: '3'
services:
  helm-runner:
    image: my-helm-image
    volumes:
      - ~/.kube/config:/root/.kube/config
      - ~/.aws/credentials:/root/.aws/credentials
      - ~/.helm:/root/.helm
    environment:
      - AWS_REGION=us-west-2
      - HELM_DEBUG=true
    command: helm list --all-namespaces