ls1tum/openjdk-node-yarn

docker-jdk-node-yarn 镜像文档

镜像概述和主要用途

docker-jdk-node-yarn 是一个集成JDK、Node.js、Yarn及Maven的Docker容器，旨在为Java后端开发、前端构建及混合项目测试提供统一的运行和构建环境。通过预装多种开发工具，解决跨平台环境差异问题，简化Java与前端混合应用（如Spring Boot项目）的开发、测试及部署流程。

核心功能和特性

• 多环境集成：预装JDK、Node.js、Yarn及Maven，满足Java编译、前端依赖管理（Yarn）、前端构建（Node.js）及项目构建（Maven）的全流程需求。
• 环境一致性：提供标准化运行环境，避免因本地开发环境差异导致的“在我电脑上能运行”问题，保障团队协作及测试环境一致性。
• 混合项目支持：支持Java后端与前端混合开发的项目验证，可直接运行包含Java代码编译、前端资源构建的集成测试。

使用场景和适用范围

• Java与前端混合开发项目（如Spring Boot + Vue/React等前端框架的应用）。
• 需要同时进行Java代码编译、前端依赖安装及资源打包的场景。
• 项目集成测试环境搭建，特别是需要验证Java后端与前端模板交互的集成测试（如Spring Boot应用的前端模板生成测试）。

使用方法和配置说明

镜像构建

通过以下命令从Dockerfile构建镜像（假设当前目录存在Dockerfile）：

bash
docker build --no-cache -t docker-jdk-node-yarn .

--no-cache 选项用于禁用缓存，确保镜像基于最新配置构建。

容器运行与交互

启动容器

使用以下命令后台运行容器，并映射端口（示例映射80端口，可根据需求调整）：

bash
docker run -itd -p 80:80 --name docker-jdk-node-yarn docker-jdk-node-yarn /bin/bash

• -itd：以交互模式后台运行容器；
• -p 80:80：将容器的80端口映射到宿主机的80端口（可根据应用需求修改端口映射规则）；
• --name：指定容器名称为 docker-jdk-node-yarn，便于后续操作。

进入容器终端

通过以下命令进入运行中的容器交互终端：

bash
docker exec -it docker-jdk-node-yarn /bin/bash

环境验证

进入容器后，可通过以下命令验证预装工具版本：

bash
# 验证Java版本
java -version

# 验证Maven版本
mvn -v

# 验证Node.js版本
node --version

项目测试验证

以Spring Boot项目（如Artemis）的集成测试为例，验证环境可用性：

1. 克隆项目代码（示例为Artemis项目的特定集成测试）：

   bash
   git clone --depth 1 --single-branch https://github.com/ls1intum/Artemis.git artemis
   

2. 进入项目目录并运行集成测试：

   bash
   cd artemis
   ./gradlew test --tests ProgrammingExerciseTemplateIntegrationTest
   

该测试将验证Java后端与前端模板的交互功能，需确保容器内环境满足项目依赖要求。

注意事项

• 端口映射：示例中使用 -p 80:80，实际部署时需根据应用监听端口调整。
• 资源需求：运行集成测试等任务可能需要较多内存，建议为容器分配足够资源（如通过 --memory 参数限制或调整）。
• 版本兼容性：容器内预装工具版本需与项目依赖匹配，若项目有特定版本要求，建议在Dockerfile中指定对应版本。