stardif/java-nodejs

多工具集成开发与DevOps镜像

镜像概述

本镜像基于node:18.16-bullseye-slim构建，集成了Java、Node.js、代码质量分析、基础设施即代码及容器化工具，旨在提供一站式开发与DevOps环境，简化CI/CD流水线中的工具配置流程。

核心功能与特性

基础环境

• 操作系统：Debian Bullseye（slim版本）
• Node.js：18.16（继承自基础镜像）
• Java：17（OpenJDK Headless）

开发工具

• 构建工具：Maven（Java项目构建）
• 版本控制依赖：OpenSSH客户端（代码拉取）
• 脚本支持：Python 3及pip（含AWS CLI）

代码质量与分析

• Sonar Scanner：4.7.0（代码质量检测与分析）

DevOps工具链

• 容器化：Docker引擎及Docker Compose 2.17.2（容器构建与编排）
• 基础设施即代码：Terraform 1.4.6（云资源编排）
• 云服务交互：AWS CLI（Amazon Web Services命令行工具）

辅助工具

• 网络工具：curl、wget
• 数据处理：jq（JSON解析）
• 压缩工具：unzip
• 显示服务：xvfb（虚拟X服务器，支持图形化工具运行）

使用场景与适用范围

1. CI/CD流水线
   适用于Jenkins、GitLab CI等平台，支持从代码拉取、构建（Java/Node.js项目）、质量分析（Sonar Scanner）到基础设施部署（Terraform）的全流程自动化。

2. 多语言项目开发
   提供Java、Node.js双语言开发环境，满足前后端分离项目的本地开发与测试需求。

3. 基础设施即代码管理
   通过Terraform与AWS CLI，便捷管理云资源（如AWS）的创建与配置。

4. 代码质量管控
   集成Sonar Scanner，可直接在环境中执行代码质量检测，生成分析报告。

使用方法与配置说明

前提条件

• Docker引擎已安装并运行
• （可选）如需使用容器内Docker功能，需挂载宿主机Docker套接字

镜像拉取

假设镜像名称为devops-toolkit:latest（实际使用时需替换为具体镜像名或构建本地镜像）：

bash
docker pull devops-toolkit:latest
# 或本地构建
docker build -t devops-toolkit:latest -f Dockerfile .

基础运行示例

启动交互式终端，挂载Docker套接字以使用容器内Docker功能：

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 允许容器内操作宿主机Docker
  -v $(pwd):/workspace \                          # 挂载工作目录
  devops-toolkit:latest \
  bash

工具使用示例

1. Sonar Scanner代码质量分析

在工作目录中执行Sonar Scanner（需提前配置sonar-project.properties）：

bash
cd /workspace
sonar-scanner -Dsonar.projectKey=my-project -Dsonar.sources=.

2. Terraform基础设施部署

初始化并应用Terraform配置：

bash
cd /workspace/terraform
terraform init   # 初始化工作目录
terraform plan   # 预览部署计划
terraform apply  # 应用配置（需确认）

3. Docker Compose服务编排

启动多容器应用：

bash
cd /workspace
docker-compose up -d  # 后台启动服务

4. Maven构建Java项目

bash
cd /workspace/java-project
mvn clean package  # 清理并构建JAR包

自定义配置

如需调整工具版本（如Terraform、Sonar Scanner），可修改Dockerfile中的环境变量后重新构建：

• JAVA_VERSION：Java版本（默认17）
• SONAR_SCANNER_URL：Sonar Scanner下载URL（默认4.7.0版本）
• TERRAFORM_VERSION：Terraform版本（默认1.4.6）
• DOCKER_COMPOSE_URL：Docker Compose下载URL（默认2.17.2版本）

注意事项

• 容器内Docker功能依赖宿主机Docker引擎，需确保宿主机Docker服务正常运行。
• Sonar Scanner依赖Java环境，镜像已配置使用系统Java（非嵌入式JRE），无需额外安装。
• 敏感操作（如AWS CLI、Terraform云资源操作）需提前通过环境变量或挂载配置文件注入凭证（如~/.aws/credentials、Terraform变量文件）。