openiamdocker/circleci-docker-compose-java Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

本镜像为CircleCI持续集成(CI)环境优化，集成docker-compose、Git版本控制、Java开发工具链及Docker引擎，旨在简化CI流程配置，提供一致的构建、测试和部署环境，减少工具链配置时间。

核心功能与特性

1. 完整工具链集成

• docker-compose：支持多容器应用的定义、配置与编排，简化多服务依赖的CI流程。
• Git：内置Git客户端，支持代码拉取、分支管理、版本控制等CI基础操作。
• Java环境：包含JDK（Java Development Kit），支持Java项目编译、单元测试及打包（如Maven/Gradle依赖）。
• Docker引擎：集成Docker运行时，支持容器化构建、镜像构建与推送。

2. CI环境优化

• 预配置工具路径与环境变量，确保工具间兼容性（如Java PATH配置、Docker socket访问权限）。
• 精简镜像体积，平衡功能完整性与CI流程执行效率。

使用场景

• CircleCI CI流水线：作为CircleCI作业的执行环境，支持Java项目构建、多容器应用集成测试。
• 代码拉取与版本控制：通过Git自动化拉取代码仓库、切换分支，支持基于提交记录的构建触发。
• 容器化应用构建：利用Docker引擎构建应用镜像，结合docker-compose管理测试环境依赖服务（如数据库、缓存）。
• 跨平台一致性：确保开发、测试与CI环境工具版本一致，减少"本地可运行，CI失败"问题。

使用方法与配置说明

基础运行命令

bash
docker run -it --rm \
  --privileged \  # 需特权模式以支持Docker引擎运行
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载宿主机Docker socket（可选，用于镜像推送）
  circleci/ci-toolchain:latest \
  /bin/bash

CircleCI配置示例（.circleci/config.yml）

yaml
version: 2.1
jobs:
  build-java-app:
    docker:
      - image: circleci/ci-toolchain:latest  # 使用本镜像作为执行环境
    steps:
      - checkout  # 利用内置Git拉取代码
      - run:
          name: 编译Java项目
          command: javac -version && ./mvnw clean package  # 调用Java编译器与Maven
      - run:
          name: 启动测试环境
          command: docker-compose -f docker-compose.test.yml up -d  # 使用docker-compose启动测试服务
      - run:
          name: 执行集成测试
          command: ./mvnw test

可选配置

1. Java版本指定

通过环境变量 JAVA_HOME 切换JDK版本（需镜像支持多版本，具体版本需参考镜像标签）：

bash
docker run -e JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 ...

2. Git配置

设置全局Git用户信息（用于CI流程中的提交或标签操作）：

bash
docker run -e GIT_USER_NAME="CI Bot" -e GIT_USER_EMAIL="***" ...

注意事项

• Docker权限：运行含Docker引擎的命令时需启用 --privileged 模式或挂载 docker.sock。
• 工具版本：不同镜像标签可能对应不同工具版本（如jdk11、docker-20.10），需根据项目需求选择。
• 资源需求：CI作业建议分配至少2GB内存，以支持Docker引擎与Java编译并行运行。