ganex/k8s-jenkins-toolbox

k8s-jenkins-toolbox 镜像文档

镜像概述

k8s-jenkins-toolbox是一个基于Alpine Linux的轻量级Docker镜像，集成了多种常用CI/CD工具，专门用于Jenkins流水线环境。该镜像旨在为Jenkins作业提供一站式工具集，减少在流水线中手动安装工具的复杂性，提升CI/CD流程的效率和一致性。

核心功能和特性

基础特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动速度快
• 多工具集成：预装多种CI/CD常用工具，满足流水线全流程需求
• 兼容性强：与Jenkins流水线无缝集成，支持各种自动化场景

包含的核心工具

• 版本控制：git
• 容器工具：docker、kubectl、helm
• 网络工具：curl、wget、ping
• 构建工具：make、gcc
• 包管理：apk（Alpine包管理器）
• 其他实用工具：jq（JSON处理）、bash、openssh-client

使用场景和适用范围

适用场景

• Jenkins自动化流水线中的构建、测试、打包环节
• Kubernetes集群应用的部署与管理
• 代码拉取、依赖下载、镜像构建、容器推送等CI/CD流程
• 跨平台一致的工具环境需求

适用用户

• DevOps工程师
• Jenkins管理员
• 负责CI/CD流程设计与维护的技术团队

使用方法和配置说明

拉取镜像

bash
docker pull gitlab.com/ganex-cloud/docker-images/k8s-jenkins-toolbox:latest

基本使用（Docker Run）

bash
docker run -it --rm gitlab.com/ganex-cloud/docker-images/k8s-jenkins-toolbox:latest /bin/bash

在Jenkins Pipeline中使用

在Jenkinsfile中指定该镜像作为构建代理：

groovy
pipeline {
    agent {
        docker {
            image 'gitlab.com/ganex-cloud/docker-images/k8s-jenkins-toolbox:latest'
            reuseNode true
        }
    }
    stages {
        stage('Check Tools') {
            steps {
                sh 'git --version'
                sh 'kubectl version --client'
                sh 'helm version --client'
                sh 'docker --version'
            }
        }
        stage('Build and Deploy') {
            steps {
                sh 'git clone https://your-repo.git'
                sh 'cd your-repo && make build'
                sh 'kubectl apply -f k8s/deployment.yaml'
            }
        }
    }
}

环境变量配置

该镜像支持通过环境变量进行工具配置，常用环境变量包括：

• KUBECONFIG：Kubernetes配置文件路径，默认 /root/.kube/config
• HELM_HOME：Helm配置目录，默认 /root/.helm
• GIT_CONFIG_USER_NAME：Git用户名配置
• GIT_CONFIG_USER_EMAIL：Git***配置

持久化配置

如需持久化工具配置（如kubectl上下文、helm仓库等），可通过挂载卷实现：

bash
docker run -it --rm \
    -v ~/.kube:/root/.kube \
    -v ~/.helm:/root/.helm \
    gitlab.com/ganex-cloud/docker-images/k8s-jenkins-toolbox:latest

注意事项

• 运行包含docker命令的流水线时，需确保Jenkins代理容器具有访问Docker daemon的权限（通常通过挂载/var/run/docker.sock实现）
• 使用kubectl时需提前配置Kubernetes集群访问凭证
• 定期更新镜像以获取最新工具版本和安全补丁