g4it/frontend

g4it前端Docker镜像文档

1. 镜像概述

g4it前端Docker镜像是专为g4it前端应用设计的容器化解决方案，旨在简化前端应用的部署与运维流程。该镜像基于轻量级基础镜像构建，包含g4it前端应用运行所需的完整环境及依赖，可直接用于开发、测试及生产环境，确保应用在不同环境中的一致性运行。

2. 核心功能与特性

• 预配置运行环境：集成Node.js运行时及前端依赖，无需手动安装配置，开箱即可运行
• 轻量级基础：基于Alpine或Slim版本基础镜像，减小镜像体积，提升部署效率
• 多环境支持：通过环境变量灵活配置开发、测试、生产等不同环境参数
• 易于扩展：支持自定义配置文件挂载，满足个性化部署需求
• CI/CD友好：可无缝集成主流CI/CD流程，实现自动化构建与部署

3. 使用场景

• 开发环境快速部署：简化本地开发环境搭建，一键启动前端应用进行调试
• 生产环境稳定运行：提供生产级稳定性，支持高可用部署架构
• 多环境一致性保障：统一开发、测试、生产环境配置，减少"在我电脑上能运行"问题
• 临时演示环境：快速搭建临时演示环境，用于产品展示或功能验证

4. 使用方法

4.1 基本使用（docker run）

通过docker run命令快速启动g4it前端应用：

bash
docker run -d \
  --name g4it-frontend \
  -p 80:80 \
  -e G4IT_API_URL="https://api.g4it.example.com" \
  -e NODE_ENV="production" \
  g4it/frontend:latest

参数说明：

• -p 80:80：将容器内80端口映射到主机80端口，可根据需求调整
• -e G4IT_API_URL：指定后端API服务地址，前端应用将通过该地址与后端通信
• -e NODE_ENV：指定运行环境，可选值：development（开发）、production（生产）、test（测试）

4.2 docker-compose配置

使用docker-compose.yml配置文件管理服务，适用于多服务协同部署场景：

yaml
version: '3.8'
services:
  g4it-frontend:
    image: g4it/frontend:latest
    container_name: g4it-frontend
    ports:
      - "80:80"
    environment:
      - G4IT_API_URL="https://api.g4it.example.com"
      - NODE_ENV="production"
      - PORT=80
    restart: always
    volumes:
      - ./custom-config:/app/config  # 挂载自定义配置文件（可选）

启动服务：

bash
docker-compose up -d

4.3 自定义配置

如需覆盖默认配置，可通过挂载配置文件实现。将自定义配置文件（如config.js）放置于主机目录，通过-v参数挂载到容器内指定路径：

bash
docker run -d \
  --name g4it-frontend \
  -p 80:80 \
  -v /path/to/custom-config:/app/config \
  g4it/frontend:latest

5. 配置参数

6. 注意事项

• 生产环境建议指定具体镜像版本（如g4it/frontend:1.2.0）而非latest，确保部署版本可控
• 环境变量G4IT_API_URL需根据实际后端服务地址配置，否则可能导致前后端通信失败
• 如需启用HTTPS，建议结合Nginx或Traefik等反向代理实现，容器内优先使用HTTP监听