iserv/webpack

镜像概述

本Docker镜像专为IServ Portalserver环境设计，集成Webpack工具链，提供前端资源（JavaScript、CSS、图片等）的自动化构建、打包与优化能力，确保生成的资源与IServ Portalserver架构兼容，简化前端资源管理流程。

核心功能与特性

• Webpack原生集成：内置Webpack及常用插件（如css-loader、style-loader、file-loader），支持模块化资源处理
• 多类型资源支持：覆盖JavaScript转译（ES6+至ES5）、CSS预处理器（Sass/Less）编译、图片压缩、字体打包等场景
• IServ环境适配：优化资源输出路径与格式，确保与IServ Portalserver的资源加载机制兼容
• 灵活配置：支持自定义Webpack配置文件，适配不同项目的构建需求
• 轻量高效：基于Alpine Linux基础镜像，减少镜像体积，提升构建效率

使用场景

• IServ Portalserver前端项目的资源构建流程自动化
• 开发环境中实时资源编译与热更新（配合webpack-dev-server）
• 生产环境资源压缩、混淆与哈希命名（避免缓存问题）
• IServ Portalserver插件或模块的前端资源打包

使用方法

基本使用（docker run）

通过挂载项目目录与输出目录，执行基础构建：

bash
docker run -v $(pwd)/src:/app/src \
  -v $(pwd)/dist:/app/dist \
  -e MODE=production \
  iserv-webpack-integration

• -v $(pwd)/src:/app/src：挂载本地项目源码目录至容器内工作区
• -v $(pwd)/dist:/app/dist：挂载本地输出目录，持久化构建结果
• -e MODE=production：指定生产环境模式（启用压缩与优化）

自定义Webpack配置

通过WEBPACK_CONFIG环境变量指定自定义配置文件路径：

bash
docker run -v $(pwd):/app \
  -e WEBPACK_CONFIG=/app/webpack.custom.config.js \
  iserv-webpack-integration

注：自定义配置文件需确保输出路径与IServ Portalserver资源目录匹配（通常为/app/dist）。

环境变量配置

Docker Compose示例

适用于多环境或依赖管理场景：

yaml
version: '3.8'
services:
  webpack-builder:
    image: iserv-webpack-integration
    volumes:
      - ./src:/app/src           # 源码目录
      - ./dist:/app/dist         # 输出目录
      - ./webpack.config.js:/app/webpack.config.js  # 自定义配置文件
    environment:
      - MODE=development
      - OUTPUT_DIR=/app/dist/iserv-assets  # 自定义IServ资源子目录

注意事项

• 确保IServ Portalserver有权限访问输出目录（OUTPUT_DIR）的资源
• 开发模式下可添加-e DEV_SERVER=true启用webpack-dev-server（需映射端口：-p 8080:8080）
• 生产环境建议通过--env production参数或MODE=production启用代码压缩与tree-shaking
• 自定义配置文件中应避免修改基础输出路径（/app），以免破坏容器内文件结构