melopt/ci-runner-default-image

Docker构建镜像

镜像概述和主要用途

本镜像基于https://hub.docker.com/_/ubuntu构建，预装多种常用开发工具和CI辅助命令，旨在作为Gitlab CI/CD runner的基础镜像，简化CI/CD流程的配置与执行。

核心功能和特性

预装软件包

• git：版本控制工具
• curl：HTTP请求工具
• jq：JSON解析工具
• nodejs和npm：JavaScript运行环境及包管理工具
• perl：Perl编程语言
• docker：容器化工具
• docker-compose：多容器编排工具
• redis client：Redis数据库客户端
• mysql client：MySQL数据库客户端

全局安装的npm模块

• uglifyjs：JavaScript代码压缩工具
• csso：语义化CSS压缩工具

全局安装的Perl模块

• App::cpanminus：Perl模块安装工具
• Carton：Perl依赖管理工具

CI辅助命令

cmd-retry

重复执行指定命令，直到输出中不再包含特定字符串。重试间隔为5秒，最大重试时间为60秒。

示例：

bash
cmd-retry "502 Bad Gateway" docker login -u gitlab-ci-token -p $CI_BUILD_TOKEN $CI_REGISTRY

（当命令输出包含"502 Bad Gateway"时重试docker login操作）

ci-bootstrap

通常用于before_script阶段，输出诊断CI任务问题的关键信息，并使用CI_BUILD_TOKEN登录Gitlab Registry。具体包括：

• Gitlab Registry信息
• 所有以_IMAGE结尾的环境变量（如BUILD_IMAGE、RELEASE_IMAGE）
• git、docker、docker-compose的版本信息
• 若检测到Perl项目，还会输出perl版本及cpanfile*文件列表

docker-pull-build

docker build的包装工具，会读取Dockerfile并对所有FROM指令引用的镜像执行docker pull。若指定-t或--tag选项，也会拉取该标签镜像以优化构建缓存。解决了Docker在私有 registry 认证场景下无法拉取FROM镜像的问题。

docker-prime-cache

接受镜像列表并尝试拉取，拉取失败时忽略错误，始终返回0。用于预加载Docker构建缓存，通过拉取现有镜像（如x:latest）减少构建时间，提高层复用率。

示例：

bash
docker-prime-cache x:latest y:1.0

docker-push-retry

docker push的包装工具，使用cmd-retry '502 Bad Gateway'包装推送操作，解决部分Docker Registry不稳定导致的502错误问题。

使用场景和适用范围

适用于Gitlab CI/CD runner环境，特别适合需要执行以下任务的CI/CD流程：

• Git版本控制操作
• Docker镜像构建、推送与多容器编排
• 数据库（MySQL、Redis）交互
• 前端资源（JS/CSS）压缩
• Perl项目依赖管理与构建

使用方法和配置说明

在Gitlab CI配置中使用

在.gitlab-ci.yml中指定本镜像作为基础镜像：

yaml
image: docker.xuanyuan.run/[镜像名称]

before_script:
  - ci-bootstrap  # 输出环境信息并登录Gitlab Registry

build:
  script:
    - docker-pull-build -t $BUILD_IMAGE .  # 拉取基础镜像并构建
    - docker-push-retry $BUILD_IMAGE       # 重试推送镜像

本地测试

通过以下命令启动容器进行本地测试：

bash
docker run -it --rm [镜像名称] /bin/bash

辅助命令使用示例

• 重试命令执行：

  bash
  cmd-retry "Connection refused" curl http://example.com
  

• 预加载构建缓存：

  bash
  docker-prime-cache $RELEASE_IMAGE
  docker build -t $RELEASE_IMAGE .