churtadotech/k8s-tools

镜像概述

本镜像为alpine/k8s的派生版本，在其基础上新增了helmfile工具，旨在提供一个轻量级、集成化的Kubernetes管理环境。基于Alpine Linux构建，保持了原alpine/k8s的轻量特性，同时扩展了对helmfile的支持，便于用户通过helmfile实现Helm图表的声明式配置、部署与管理。

核心功能与特性

1. 继承alpine/k8s工具链

• 包含alpine/k8s镜像的全部Kubernetes管理工具，如kubectl、helm、kubeadm、kubectx、kubens等
• 支持标准Kubernetes集群操作，如资源查看、部署管理、集群配置等

2. 新增helmfile支持

• 集成最新稳定版helmfile，支持声明式管理Helm发布
• 支持通过单一配置文件定义多环境、多版本Helm图表部署
• 提供helmfile sync、helmfile diff、helmfile apply等核心命令

3. 轻量级基础

• 基于Alpine Linux，镜像体积小，启动速度快
• 精简的系统环境，降低资源占用，适合容器化部署场景

4. 多架构支持

• 继承alpine/k8s的多架构支持，可运行于x86_64、arm64等主流架构

使用场景

• Kubernetes集群日常管理：通过集成的kubectl、helm及新增的helmfile，一站式完成集群资源操作与Helm应用管理
• 多环境Helm部署：利用helmfile的声明式配置，统一管理开发、测试、生产等多环境的Helm发布策略
• CI/CD流水线集成：作为CI/CD流程中的工具容器，执行Kubernetes资源部署、Helm图表同步等操作
• 本地开发环境：为开发者提供一致的Kubernetes工具链环境，避免本地工具版本冲突

使用方法

Docker Run 示例

基本交互式使用

bash
docker run --rm -it \
  -v $HOME/.kube/config:/root/.kube/config \  # 挂载本地Kubeconfig
  -v $(pwd):/workspace \                      # 挂载工作目录（含helmfile配置）
  --name k8s-helmfile-env \
  [镜像名称] /bin/sh

直接执行helmfile命令

bash
docker run --rm \
  -v $HOME/.kube/config:/root/.kube/config \
  -v $(pwd)/helmfile.yaml:/workspace/helmfile.yaml \
  [镜像名称] helmfile -f /workspace/helmfile.yaml sync

配置说明

必要挂载

• Kubeconfig文件：需挂载/root/.kube/config以访问Kubernetes集群，路径可通过KUBECONFIG环境变量自定义
• helmfile配置文件：建议将包含helmfile.yaml及相关Helm图表的目录挂载至容器内（如/workspace），便于helmfile读取配置

环境变量（可选）

• KUBECONFIG：自定义Kubeconfig文件路径，默认值为/root/.kube/config
• HELMFILE_CONFIG：默认helmfile配置文件路径，未设置时需通过-f参数指定

工具版本查看

容器内可通过以下命令验证工具版本：

bash
kubectl version --client
helm version
helmfile --version

注意事项

• 镜像基于alpine/k8s构建，其基础工具版本与上游保持一致，使用前建议确认与目标Kubernetes集群版本兼容性
• helmfile配置文件需符合其语***范，具体可参考helmfile官方文档
• 敏感信息（如Kubeconfig、Helm仓库认证）建议通过安全挂载或 Secrets 管理，避免直接嵌入镜像

维护与更新

• 镜像版本跟随alpine/k8s上游版本更新，同步更新内置Kubernetes工具链
• helmfile版本将定期更新至最新稳定版，确保兼容性与安全性