CENCOR Java CI 基础镜像文档

维护方

由 CENCOR 开发团队维护

支持的标签及 Dockerfile 链接

一、镜像概述和主要用途

概述

本镜像基于 Amazon Linux 系统构建，集成了 Amazon Corretto Java 运行时环境、Gradle 构建工具、openssh 及 git，提供了完整的 Java 项目构建环境。

主要用途

作为 CENCOR 内部 Java 组件持续集成（CI）流程的基础镜像，用于支持使用 Gradle 构建的 Java 项目的自动化构建、测试及部署流程。

二、核心功能和特性

1. 基础系统：基于 Amazon Linux，提供稳定、安全的操作系统环境。

2. Java 环境：集成 Amazon Corretto（Oracle 认证的 OpenJDK 发行版），不同标签对应不同 Java 版本：

   • jdk17/latest：Amazon Corretto 17
   • jdk11/jdk-gradle6：Amazon Corretto 11
   • jdk8：Amazon Corretto 8

3. 构建工具：内置 Gradle，支持 Java 项目的自动化构建、依赖管理及测试。

4. 开发工具：包含 openssh（支持 SSH 远程操作）和 git（版本控制），满足 CI 流程中代码拉取、远程部署等需求。

三、使用场景和适用范围

使用场景

• CENCOR 内部 Java 项目的持续集成流程，用于自动化构建、单元测试、集成测试等环节。
• 需要基于 Amazon Corretto 运行时和 Gradle 构建工具的 Java 项目开发/测试环境。

适用范围

• 依赖 Amazon Corretto Java 17/11/8 的 Java 应用。
• 使用 Gradle 作为构建工具的项目。
• 需要集成 git 和 SSH 工具的 CI/CD 流水线。

四、使用方法和配置说明

1. 拉取镜像

根据项目所需的 Java 版本，拉取对应标签的镜像：

# 拉取 Java 17 版本（最新版）
docker pull cencor/ci-docker-image:jdk17

# 拉取 Java 11 版本
docker pull cencor/ci-docker-image:jdk11

# 拉取 Java 8 版本
docker pull cencor/ci-docker-image:jdk8

2. 运行容器

交互式终端（用于调试或手动操作）

docker run -it --rm cencor/ci-docker-image:jdk17 /bin/bash

进入容器后，可直接使用 java -version、gradle -v、git --version 等命令验证工具是否正常安装。

在 CI 流程中执行构建命令

例如，在项目根目录下执行 Gradle 构建：

docker run --rm -v $(pwd):/app -w /app cencor/ci-docker-image:jdk17 gradle clean build

• -v $(pwd):/app：将本地项目目录挂载到容器内 /app 路径。
• -w /app：设置工作目录为 /app（项目根目录）。
• gradle clean build：执行 Gradle 清理并构建项目。

3. Docker Compose 配置示例

创建 docker-compose.yml 文件，定义服务用于项目构建：

version: '3.8'
services:
  java-ci:
    image: cencor/ci-docker-image:jdk17
    volumes:
      - ./:/app  # 挂载本地项目目录
    working_dir: /app
    command: gradle clean test  # 执行测试命令

启动服务：

docker-compose up

五、注意事项

• 标签与 Java 版本对应：不同标签对应不同 Amazon Corretto 版本，使用时需根据项目 Java 版本选择正确标签，避免版本不兼容。
• Gradle 版本：jdk-gradle6 标签可能集成特定版本的 Gradle（如 Gradle 6.x），其他标签的 Gradle 版本请参考对应 Dockerfile 定义。
• 权限配置：在 CI 流程中挂载本地目录时，需确保容器内用户对挂载目录有读写权限，必要时通过 --user 参数指定用户。

如需进一步定制，可参考各标签对应的 Dockerfile 进行修改和构建。# CENCOR Java CI 基础镜像文档

维护方

由 CENCOR 开发团队维护

支持的标签及 Dockerfile 链接

一、镜像概述和主要用途

概述

本镜像基于 Amazon Linux 系统构建，集成 Amazon Corretto Java、Gradle、openssh 及 git 工具，提供一站式 Java 项目构建环境。

主要用途

作为 CENCOR 内部 Java 组件持续集成（CI）的基础镜像，支持使用 Gradle 构建、测试 Java 应用，满足自动化 CI/CD 流程需求。

二、核心功能和特性

1. 基础系统：基于 Amazon Linux，提供稳定、安全的操作系统环境。
2. Java 环境：集成 Amazon Corretto（Oracle 认证的 OpenJDK 发行版），不同标签对应版本：
   • jdk17/latest：Amazon Corretto 17
   • jdk11/jdk-gradle6：Amazon Corretto 11
   • jdk8：Amazon Corretto 8
3. 构建工具：内置 Gradle，支持 Java 项目的依赖管理、构建及测试。
4. 开发工具：包含 openssh（SSH 远程操作）和 git（版本控制），满足代码拉取、远程部署等 CI 流程需求。

三、使用场景和适用范围

使用场景

• CENCOR 内部 Java 项目的持续集成流程（构建、测试、部署）。
• 基于 Amazon Corretto 和 Gradle 的 Java 项目开发/测试环境。

适用范围

• 依赖 Amazon Corretto 17/11/8 的 Java 应用。
• 使用 Gradle 构建的项目。
• 需要集成 git 和 SSH 工具的 CI/CD 流水线。

四、使用方法和配置说明

1. 拉取镜像

根据 Java 版本选择标签：

# Java 17（最新版）
docker pull cencor/ci-docker-image:jdk17

# Java 11
docker pull cencor/ci-docker-image:jdk11

# Java 8
docker pull cencor/ci-docker-image:jdk8

2. 运行容器

交互式终端（调试/手动操作）

docker run -it --rm cencor/ci-docker-image:jdk17 /bin/bash

进入容器后可验证工具：java -version、gradle -v、git --version。

CI 构建命令示例

挂载项目目录并执行 Gradle 构建：

docker run --rm -v $(pwd):/app -w /app cencor/ci-docker-image:jdk17 gradle clean build

• -v $(pwd):/app：挂载本地项目到容器 /app。
• -w /app：设置工作目录为 /app。

3. Docker Compose 配置示例

version: '3.8'
services:
  java-ci:
    image: cencor/ci-docker-image:jdk17
    volumes: ["./:/app"]
    working_dir: /app
    command: gradle clean test  # 执行测试命令

启动服务：docker-compose up

五、注意事项

• 版本匹配：根据项目 Java 版本选择标签，避免版本冲突。
• Gradle 版本：jdk-gradle6 标签集成特定 Gradle 版本（如 6.x），其他标签版本参考对应 Dockerfile。
• 权限配置：挂载目录时确保容器用户对挂载路径有读写权限，必要时通过 --user 指定用户。

详细配置可参考各标签对应的 Dockerfile。