stakater/builder-clients

builder-clients 镜像文档

镜像概述

builder-clients是一个包含用于与服务器交互的二进制客户端的Docker镜像，主要用于在fabric8 Jenkins 2.0管道环境中执行与Kubernetes、OpenShift等平台相关的操作。

核心功能和特性

该镜像包含以下核心客户端工具：

• gofabric8：用于安装和初始配置基于Kubernetes的fabric8平台
• oc binary：用于与OpenShift API服务器交互的命令行工具
• kubectl binary：用于与Kubernetes API服务器交互的命令行工具

使用场景和适用范围

适用于需要在Jenkins 2.0 CI/CD管道中执行以下操作的场景：

• 自动化部署和配置基于Kubernetes的fabric8平台
• 与OpenShift集群进行交互（如部署应用、管理资源等）
• 与Kubernetes集群进行交互（如查看资源、执行命令、管理配置等）

使用方法和配置说明

基本使用方式

通过docker run命令直接使用镜像中的客户端工具：

shell
# 查看gofabric8版本
docker run --rm builder-clients gofabric8 version

# 使用kubectl查看Kubernetes集群节点
docker run --rm -v ~/.kube/config:/root/.kube/config builder-clients kubectl get nodes

# 使用oc查看OpenShift项目
docker run --rm -v ~/.kube/config:/root/.kube/config builder-clients oc projects

在Jenkins Pipeline中使用

在fabric8 Jenkins 2.0管道中集成使用：

groovy
pipeline {
    agent any
    stages {
        stage('Interact with Kubernetes') {
            steps {
                container('builder-clients') {
                    sh 'kubectl get pods'
                    sh 'oc status'
                    sh 'gofabric8 check'
                }
            }
        }
    }
}

挂载配置文件

为了让客户端工具能够访问集群，需要挂载Kubernetes/OpenShift配置文件：

shell
docker run --rm -v /path/to/kubeconfig:/root/.kube/config builder-clients kubectl get pods

注：默认情况下，客户端工具会读取/root/.kube/config路径下的配置文件，因此挂载本地kubeconfig文件到该路径即可实现集群访问。