adorsys/ci-build

[***]

概述

adorsys/ci-build是一个默认构建镜像，专为CI/CD环境设计，集成了多种开发和构建工具，支持各类软件项目的自动化构建流程。

核心功能和特性

基础软件列表

• Docker CE
• Maven
• NPM 及 YARN
• 构建工具（如gcc，部分Node依赖项所需）

full变体额外软件列表

• Java 8、11、17（可通过JABBA切换；默认8）
• Node 12、14、16（可通过NVM切换；默认10）
• Firefox（仅bootstrap版本）
• skopeo（容器镜像操作工具）
• jq（JSON处理工具）
• rush（命令行工具）

注：镜像尽量避免版本固定，通常提供最新版本软件。

标签说明

使用场景和适用范围

适用于各类软件项目的CI/CD流程，尤其适合需要多版本Java、NodeJS环境切换，或需进行Docker镜像操作、JSON处理的自动化构建任务。可用于GitLab CI、Jenkins等主流CI平台。

使用方法和配置说明

CI示例

在任务中使用Java 11（仅full变体）

在项目根目录创建.jabbarc文件，内容如下：

system@1.11

然后在CI流程中执行jabba use切换Java版本。

更多信息：[***]

在任务中使用Node 10（仅full变体）

在项目根目录创建.nvmrc文件，内容如下：

10

然后在CI流程中执行nvm use切换Node版本。

更多信息：[***]

Maven最佳实践默认配置

基于Gitlab CI推荐配置，可减少冗余输出：

yaml
variables:
  MAVEN_CLI_OPTS: "--batch-mode --errors --fail-at-end --show-version -DinstallAtEnd=true -DdeployAtEnd=true"
  MAVEN_OPTS: "-Dhttps.protocols=TLSv1.2 -Dmaven.repo.local=$CI_PROJECT_DIR/.m2/repository -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=WARN -Dorg.slf4j.simpleLogger.showDateTime=true -Djava.awt.headless=true"

无需Docker复制镜像

yaml
  script:
# 从Gitlab复制到Openshift
    - >-
      skopeo copy
      --src-creds=${CI_REGISTRY_USER}:${CI_REGISTRY_PASSWORD}
      --dest-creds=openshift:${OPENSHIFT_TOKEN}
      "docker://${OPENSHIFT_REGISTRY}/namespace/image:${CI_COMMIT_REF_NAME}"
      "docker://${HARBOR_REGISTRY}/project/imagename:${CI_COMMIT_REF_NAME}"
# 从Gitlab复制到Harbor
    - >-
      skopeo copy
      --src-creds=${CI_REGISTRY_USER}:${CI_REGISTRY_PASSWORD}
      --dest-creds=${HARBOR_USER}:${HARBOR_TOKEN}
      "docker://${CI_REGISTRY_IMAGE}:${CI_COMMIT_TAG}"
      "docker://${HARBOR_REGISTRY}/project/imagename:${CI_COMMIT_TAG}"
# 从Openshift复制到Harbor
    - >-
      skopeo copy
      --src-creds=openshift:${OPENSHIFT_TOKEN}
      --dest-creds=${HARBOR_USER}:${HARBOR_TOKEN}
      "docker://${OPENSHIFT_REGISTRY}/namespace/image:${CI_COMMIT_TAG}"
      "docker://${HARBOR_REGISTRY}/project/imagename:${CI_COMMIT_TAG}"

使用Docker缓存复用已有层

• 此方法需确保构建可重现：
  • Angular默认支持可重现构建
  • Java Maven项目需使用插件：[***]

yaml
  script:
    - >-
      docker pull "${CI_REGISTRY_IMAGE}/${IMAGE_NAME}:${CI_COMMIT_TAG:-$CI_COMMIT_REF_SLUG}" 
      || docker pull "${CI_REGISTRY_IMAGE}/${IMAGE_NAME}:develop" 
      || true
    - >-
      docker build --pull
      --cache-from "${CI_REGISTRY_IMAGE}/${IMAGE_NAME}:${CI_COMMIT_TAG:-$CI_COMMIT_REF_SLUG}"
      --cache-from "${CI_REGISTRY_IMAGE}/${IMAGE_NAME}:develop"
      -t "${CI_REGISTRY_IMAGE}/${IMAGE_NAME}:${CI_COMMIT_TAG:-$CI_COMMIT_REF_SLUG}" .
    - docker push "${CI_REGISTRY_IMAGE}/${IMAGE_NAME}:${CI_COMMIT_TAG:-$CI_COMMIT_REF_SLUG}"