uniqdevops/web-build

镜像概述

本Docker镜像专为PHP和Node.js的基于Web的构建项目设计，集成了丰富的开发、部署、构建及运维工具。通过统一环境，简化开发者在项目构建、测试、代码质量检查和部署过程中的操作，提升开发效率并确保环境一致性。

核心功能与特性

工具集成详情

镜像预装以下工具，覆盖开发、构建、部署全流程：

关键特性

• 多语言支持：通过nvm提供Node.js v12至v20多版本，配合PHP 7.2及Composer，满足不同Web项目需求。
• 全流程覆盖：从代码拉取（git）、依赖管理（npm/composer）、代码质量检查（SonarScanner）、基础设施部署（terraform/helm）到容器化部署（docker/kubectl），集成完整开发部署链路。
• 环境一致性：统一工具版本，避免"本地可运行，线上出问题"的环境差异问题。

使用场景

1. PHP/Node.js Web项目开发：本地开发环境搭建，直接使用容器内工具进行代码编写、依赖安装（如npm install、composer install）和本地测试。
2. CI/CD流程集成：作为CI/CD流水线（如GitLab CI、Jenkins）的构建环境，执行自动化测试、代码扫描（sonar-scanner）、打包（docker build）和部署（kubectl apply）。
3. 多工具协同任务：处理需要多种工具配合的复杂任务，如"拉取代码→安装依赖→代码扫描→生成Terraform执行计划→部署至K8s集群"的全流程自动化。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+）及Docker Compose（可选）。
• 本地项目目录需挂载至容器内以进行文件操作。

快速启动

基础使用（交互式终端）

bash
docker run -it --rm -v $(pwd):/app web-build-php-node /bin/bash

• -v $(pwd):/app：将当前目录挂载至容器内/app路径，便于操作本地项目文件。
• --rm：退出容器后自动清理容器文件。
• 进入容器后，可直接使用预装工具，如：

  bash
  # 安装Node.js依赖
  cd /app && npm install
  
  # 执行PHP代码检查
  php -l index.php
  
  # 运行Sonar代码扫描
  sonar-scanner -Dsonar.projectKey=my-project -Dsonar.sources=.
  

直接执行命令（非交互式）

bash
# 使用Composer安装PHP依赖
docker run --rm -v $(pwd):/app web-build-php-node composer install -d /app

# 使用Terraform初始化
docker run --rm -v $(pwd):/app web-build-php-node terraform init /app/terraform

Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3.8'
services:
  build-env:
    image: web-build-php-node
    volumes:
      - ./:/app
      - ~/.kube/config:/root/.kube/config  # 挂载本地K8s配置（如需kubectl操作）
      - ~/.aws:/root/.aws                  # 挂载AWS凭证（如需aws-cli操作）
    command: /bin/bash -c "cd /app && npm run build && sonar-scanner -Dsonar.projectKey=my-app"

启动服务：

bash
docker-compose up

工具配置说明

• 工具配置文件：如需自定义工具配置（如aws-cli凭证、kubectl集群配置），可将本地配置文件（如~/.aws/credentials、~/.kube/config）挂载至容器对应路径（通常为/root/下的隐藏目录）。
• Node.js版本切换：使用nvm use <version>切换Node.js版本，如nvm use 18切换至v18.18.0。
• PHP扩展：默认提供PHP CLI环境，如需额外扩展，可基于此镜像构建新镜像并安装。

注意事项

• Terraform版本提示：容器内Terraform版本为v1.4.6，可通过tfenv install <version>安装其他版本（需联网）。
• 工具版本兼容性：部分工具（如kubectl v1.14.0）版本较旧，使用时需确认与目标服务端版本兼容性。