Kubeapps CI 内部镜像文档

一、镜像概述和主要用途

本镜像为 Kubeapps 项目专用内部镜像，仅用于 Kubeapps 项目的持续集成（CI）系统。其核心用途是为 Kubeapps 项目的 CI 流程提供标准化运行环境，确保持续集成、自动化测试、构建验证等流程的一致性和可靠性。该镜像不对外公开，仅限 Kubeapps 开发团队内部使用。

二、核心功能和特性

1. CI 工具链集成：内置 Kubeapps CI 流程所需的全套工具（如构建工具、测试框架、容器化工具等），无需额外安装依赖。
2. 环境一致性：固化 CI 流程依赖的操作系统版本、库文件、运行时环境，避免因环境差异导致的 CI 流程失败。
3. 自动化脚本支持：包含 Kubeapps 项目定制化的 CI 自动化脚本，可直接触发构建、测试、打包等关键流程。
4. 轻量级设计：基于精简基础镜像构建，减小镜像体积，提升 CI 流程启动速度。

三、使用场景和适用范围

适用场景

• Kubeapps 项目代码提交后的自动化测试（单元测试、集成测试）。
• Kubeapps 组件的自动化构建与版本打包。
• Kubeapps CI 流水线的环境初始化与流程驱动。

适用范围

• 仅限 Kubeapps 开发团队内部使用。
• 仅限 Kubeapps 项目的官方 CI 系统（如 GitLab CI、Jenkins 等）集成。
• 不支持外部项目或非 CI 场景的使用。

四、使用方法和配置说明

前置条件

• 已接入 Kubeapps 内部 CI 系统（需项目权限）。
• 本地或 CI 环境已配置 Docker 环境（版本 ≥ 19.03）。

基本使用流程

1. 镜像拉取：通过 Kubeapps 内部镜像仓库拉取（需内部权限认证）：

   docker pull [内部仓库地址]/kubeapps-ci-internal:[版本标签]
   

   注：[内部仓库地址] 和 [版本标签] 由 Kubeapps 团队维护，需联系管理员获取。

2. CI 系统集成：在 Kubeapps CI 配置文件（如 .gitlab-ci.yml、Jenkinsfile）中指定本镜像作为运行环境，示例：

   # GitLab CI 配置示例
   stages:
     - test
     - build
   
   test_job:
     stage: test
     image: [内部仓库地址]/kubeapps-ci-internal:v1.2.0
     script:
       - /scripts/run-tests.sh  # 执行内置测试脚本
   
   build_job:
     stage: build
     image: [内部仓库地址]/kubeapps-ci-internal:v1.2.0
     script:
       - /scripts/build-kubeapps.sh  # 执行内置构建脚本
   

配置说明

环境变量

通过环境变量传递 CI 流程参数，常用变量（具体由内部团队定义）：

数据挂载

如需持久化 CI 流程输出（如测试报告、构建产物），可通过挂载卷传递：

docker run -v /local/output:/ci-output [内部仓库地址]/kubeapps-ci-internal:v1.2.0

注意事项

• 镜像版本需与 CI 流程版本同步，避免因版本不匹配导致流程失败。
• 内部脚本路径（如 /scripts/run-tests.sh）可能随版本更新变化，需参考团队内部文档。
• 禁止将镜像用于非 CI 场景或外部项目，违者将限制权限。

五、Docker 部署方案示例

示例 1：本地调试（需内部权限）

# 拉取镜像（需内部认证）
docker login [内部仓库地址]
docker pull [内部仓库地址]/kubeapps-ci-internal:v1.2.0

# 运行镜像并进入交互式终端（用于调试 CI 脚本）
docker run -it --rm \
  -e KUBEAPPS_BRANCH=dev \
  -v $(pwd)/local-scripts:/scripts/local \
  [内部仓库地址]/kubeapps-ci-internal:v1.2.0 \
  /bin/bash

示例 2：Jenkins Pipeline 集成

// Jenkinsfile 示例
pipeline {
  agent {
    docker {
      image '[内部仓库地址]/kubeapps-ci-internal:v1.2.0'
      registryUrl '[内部仓库地址]'
      registryCredentialsId 'kubeapps-ci-registry-creds'  // 内部凭证 ID
    }
  }
  stages {
    stage('Unit Test') {
      steps {
        sh '/scripts/run-unit-tests.sh'
      }
    }
    stage('Build') {
      steps {
        sh '/scripts/build-kubeapps.sh'
        stash includes: 'dist/**', name: 'build-artifacts'
      }
    }
  }
}

六、配置参数说明

注：详细参数及更新日志请参考 Kubeapps 内部团队文档。