stephen001/oc

oc 镜像文档

镜像概述和主要用途

本镜像为包含OpenShift客户端二进制文件的小型精简容器。在OpenShift集群内使用时，它会自动获取运行所在服务账户的TLS证书。该镜像旨在作为基础镜像进行扩展，或组合到Pod中，用于Jenkins代理、小型OpenShift感知服务、集群调试等场景。

核心功能和特性

• 内置OpenShift客户端：包含完整的OpenShift客户端二进制文件，支持标准oc命令操作
• 自动证书配置：在OpenShift集群内运行时，自动获取服务账户的TLS证书，无需手动配置认证信息
• 精简镜像体积：采用基础精简设计，镜像体积小，资源占用低
• 灵活扩展能力：可作为基础镜像扩展，或直接组合到Pod中实现特定功能

使用场景和适用范围

• 基础镜像扩展：作为构建其他OpenShift相关应用的基础镜像，减少重复配置
• Jenkins代理：集成到CI/CD流水线，作为执行OpenShift集群操作的代理节点
• 轻量级服务：构建需要与OpenShift集群交互的小型服务
• 集群调试工具：快速部署到集群中，执行oc命令进行集群诊断和调试

使用方法和配置说明

集群内基本使用

在OpenShift集群内使用时，镜像会自动利用服务账户权限和证书：

bash
# 在OpenShift集群内创建临时Pod并进入交互模式
oc run oc-client --image=<镜像名称> --rm -it -- sh

进入容器后可直接执行oc命令：

bash
# 查看集群项目列表
oc projects

# 查看当前服务账户信息
oc whoami

作为基础镜像扩展

通过Dockerfile扩展镜像功能：

dockerfile
FROM docker.xuanyuan.run/<镜像名称>
# 示例：添加额外工具
RUN yum install -y curl jq

配置为Jenkins代理

在Jenkins中定义Pod模板：

yaml
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: oc-client
    image: docker.xuanyuan.run/<镜像名称>
    command: ["cat"]
    tty: true

Jenkins流水线中使用：

groovy
pipeline {
  agent {
    kubernetes {
      yaml """
        apiVersion: v1
        kind: Pod
        spec:
          containers:
          - name: oc-client
            image: docker.xuanyuan.run/<镜像名称>
            command: ['cat']
            tty: true
      """
    }
  }
  stages {
    stage('OpenShift操作') {
      steps {
        container('oc-client') {
          sh 'oc get pods -n default'
        }
      }
    }
  }
}

集群外使用（手动配置）

集群外使用需挂载kubeconfig文件：

bash
# 挂载本地kubeconfig到容器
docker run -it --rm -v ~/.kube/config:/root/.kube/config <镜像名称> sh