progressoft/ubi8

UBI CI/CD基础镜像文档

镜像概述

本镜像基于Red Hat UBI（Universal Base Image，通用基础镜像）构建，专为CI/CD（持续集成/持续部署）流程设计，提供标准化、安全且稳定的容器运行环境。旨在解决开发、测试与生产环境差异导致的"在我机器上能运行"问题，简化流水线配置，提升构建部署效率。

核心功能与特性

基础特性

• 基于官方UBI：遵循Red Hat UBI规范，确保与RHEL生态兼容性，满足企业级安全标准
• 轻量化设计：精简镜像体积，减少资源占用，加速CI/CD流程
• 多版本支持：提供UBI8、UBI9等多个版本分支，适配不同应用需求

CI/CD增强特性

• 预装基础工具：集成git、curl、wget等CI/CD常用工具，减少额外安装步骤
• 环境一致性：固化依赖版本，避免因工具版本差异导致的构建失败
• 安全合规：定期同步UBI官方安全更新，降低容器环境安全风险
• 缓存优化：支持CI/CD缓存机制，加速重复构建流程

使用场景

开发阶段

• 本地开发环境容器化，确保与团队成员环境一致
• 依赖库安装与测试验证，避免污染本地系统

CI/CD流水线

• 构建阶段：作为编译环境，用于源代码编译、打包（如Java、Go、Python等项目）
• 测试阶段：运行单元测试、集成测试，生成测试报告
• 部署验证：在预发布环境中部署应用，进行功能验证

企业级应用

• 符合Red Hat认证标准，适用于***、政务等对安全合规要求高的领域
• 作为微服务架构的基础镜像，构建稳定的服务容器

使用方法

镜像获取

从GitLab Container Registry拉取镜像：

bash
docker pull gitlab.com/progressoft/cicd6/ubi-images:latest
# 拉取特定版本（如UBI8）
docker pull gitlab.com/progressoft/cicd6/ubi-images:ubi8-latest

基本使用示例

交互式运行

启动容器并进入交互式shell：

bash
docker run -it --rm gitlab.com/progressoft/cicd6/ubi-images:latest /bin/bash

在CI/CD流水线中使用（GitLab CI示例）

在.gitlab-ci.yml中作为构建阶段基础镜像：

yaml
build-stage:
  image: gitlab.com/progressoft/cicd6/ubi-images:ubi8-latest
  stage: build
  script:
    - echo "使用UBI镜像构建应用"
    - ./build.sh  # 项目构建脚本
  artifacts:
    paths:
      - dist/  # 输出构建产物

Docker Compose配置示例

创建docker-compose.yml，用于本地开发环境：

yaml
version: '3.8'
services:
  dev-env:
    image: gitlab.com/progressoft/cicd6/ubi-images:latest
    volumes:
      - ./:/app  # 挂载本地代码目录
    working_dir: /app
    command: tail -f /dev/null  # 保持容器运行

启动服务：

bash
docker-compose up -d

配置参数

环境变量

构建参数（如需自定义构建镜像）

注意事项

1. 镜像需在支持Red Hat UBI的环境中运行（如Docker、Podman）
2. 使用非root用户运行时，需确保挂载目录权限正确
3. 定期拉取最新版本以获取安全更新：docker pull gitlab.com/progressoft/cicd6/ubi-images:latest
4. 详细版本信息及更新日志请参考https://gitlab.com/progressoft/cicd6/ubi-images

参考链接

• Red Hat UBI官方文档
• https://docs.gitlab.com/ee/ci/
• https://gitlab.com/progressoft/cicd6/ubi-images