hyroai/helm-kubectl-gamla

Docker镜像文档：helm + kubectl + python with gamla

镜像概述和主要用途

本Docker镜像集成了helm（Kubernetes包管理工具）、kubectl（Kubernetes命令行客户端）和Python运行环境，并包含gamla工具，旨在提供一站式开发和运行环境，用于执行Kubernetes相关的自动化脚本、部署流程管理及集群运维任务，简化工具链配置，确保环境一致性。

核心功能和特性

• 集成helm：支持Kubernetes应用的打包、版本管理、依赖处理及部署生命周期管理
• 集成kubectl：提供完整的Kubernetes集群命令行操作能力，支持资源查询、创建、更新、删除等操作
• Python环境：包含Python运行时及基础依赖库，支持编写复杂逻辑的自动化脚本
• 包含gamla：提供特定功能支持（如函数式编程工具或领域特定工具），增强脚本开发效率
• 环境一致性：封装完整工具链，避免因本地环境差异导致的脚本执行问题

使用场景和适用范围

• Kubernetes自动化部署：结合Python脚本与helm、kubectl，实现应用的自动构建、部署及版本更新
• 集群运维脚本开发：编写集群监控、资源清理、日志分析、配置同步等运维自动化脚本
• CI/CD流水线集成：作为CI/CD流程中的执行环境，运行部署前检查、配置生成、版本控制等任务
• 本地开发测试：为开发者提供统一的Kubernetes工具链环境，快速验证脚本逻辑

使用方法和配置说明

基本使用前提

• 已安装Docker环境
• 如需连接Kubernetes集群，需准备kubeconfig文件（通常位于~/.kube/config）

镜像拉取

bash
docker pull <镜像仓库地址>/<镜像名称>:<标签>  # 替换为实际镜像地址

基本运行命令

启动交互式终端，验证工具可用性：

bash
docker run -it --rm <镜像名称> /bin/bash

连接Kubernetes集群

挂载本地kubeconfig文件，使kubectl和helm能访问集群：

bash
docker run -it --rm \
  -v ~/.kube/config:/root/.kube/config \  # 挂载Kubernetes配置
  <镜像名称> /bin/bash

执行Python脚本

挂载本地脚本目录并运行Python脚本：

bash
docker run -it --rm \
  -v ~/.kube/config:/root/.kube/config \  # 连接集群（如需）
  -v $(pwd)/scripts:/app/scripts \        # 挂载本地脚本目录
  <镜像名称> python /app/scripts/your_script.py  # 执行目标脚本

使用helm和kubectl

在容器内直接执行helm和kubectl命令：

bash
# 查看helm版本
helm version

# 查看集群pods
kubectl get pods -A

# 使用helm部署应用（需先配置集群连接）
helm install my-app ./charts/my-app

docker-compose配置示例

创建docker-compose.yml文件，简化多参数启动：

yaml
version: '3'
services:
  k8s-tools:
    image: <镜像名称>
    volumes:
      - ~/.kube/config:/root/.kube/config  # Kubernetes配置
      - ./scripts:/app/scripts            # 本地脚本目录
    command: /bin/bash  # 可替换为具体脚本执行命令，如"python /app/scripts/deploy.py"

启动：docker-compose up -d，进入容器：docker-compose exec k8s-tools /bin/bash

配置说明

• Kubernetes连接配置：通过挂载~/.kube/config文件实现，无需额外环境变量
• Python依赖管理：如需添加自定义Python库，可在脚本中使用pip install或基于此镜像构建新镜像
• gamla工具使用：直接在Python脚本中import gamla调用其功能（具体API参考gamla官方文档）

注意事项

• 确保挂载的kubeconfig文件具有目标集群的访问权限
• 执行敏感操作前，建议在测试环境验证脚本逻辑
• 如需要持久化工具配置（如helm仓库），可额外挂载配置目录（如~/.helm）