devopsdsk/dsk-ui-preprod Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

dsk-ui-preprod Docker镜像文档

镜像概述

dsk-ui-preprod是专为预生产(pre-production)环境设计的用户界面(UI)应用Docker镜像，旨在提供与生产环境接近的运行环境，用于UI应用在正式发布前的预验证、功能测试和兼容性检查，确保UI应用在预生产阶段的稳定性和一致性。

核心功能与特性

• 预生产环境适配：镜像配置针对预生产环境特性优化，模拟生产环境的依赖和网络条件，减少环境差异导致的部署问题
• 测试支持：内置基础测试工具接口，支持集成自动化测试框架（如Selenium、Cypress）和手动验证流程
• 环境一致性：通过容器化封装UI应用及其依赖，确保开发、测试、预生产环境中应用运行环境一致，避免"在我机器上能运行"的环境差异问题
• 轻量级部署：优化镜像构建流程，减小镜像体积，支持快速启动和资源高效利用，适合频繁部署的预生产场景

使用场景

• 预发布功能验证：开发团队在UI应用正式发布前，通过该镜像在预生产环境验证新功能、UI样式和交互逻辑
• QA测试环境：QA团队基于此镜像部署UI应用，进行功能测试、兼容性测试（不同浏览器/设备）和性能评估
• 环境一致性保障：确保开发本地测试、CI流程和预生产环境使用相同的UI应用版本和配置，降低部署风险
• CI/CD集成：作为CI/CD流水线的关键环节，在代码合并后自动部署到预生产环境，触发自动化测试流程

使用方法

基本部署

通过docker run命令快速启动预生产UI应用容器：

bash
docker run -d -p 8080:80 --name dsk-ui-preprod-instance dsk-ui-preprod:latest

• -d：后台运行容器
• -p 8080:80：将容器内80端口（UI应用默认端口）映射到主机8080端口，可根据实际需求调整主机端口
• --name：指定容器名称，便于后续管理（如停止、重启、日志查看）

环境变量配置

镜像支持通过环境变量自定义应用配置，常用环境变量说明如下：

配置示例：指定自定义API地址和调试日志级别

bash
docker run -d -p 8080:80 \
  -e API_BASE_URL="[***]" \
  -e LOG_LEVEL="debug" \
  -e FEATURE_TOGGLES='{"new-dashboard":true, "legacy-menu":false}' \
  --name dsk-ui-preprod-instance dsk-ui-preprod:latest

数据持久化

若需持久化应用日志或配置文件，可通过挂载主机目录实现：

bash
docker run -d -p 8080:80 \
  -v ./local-logs:/app/logs \  # 挂载日志目录到主机
  -v ./custom-config:/app/config \  # 挂载自定义配置目录
  dsk-ui-preprod:latest

Docker Compose配置

在多容器环境中（如需关联后端API服务），可使用docker-compose.yml配置：

yaml
version: '3.8'
services:
  dsk-ui-preprod:
    image: dsk-ui-preprod:latest
    ports:
      - "8080:80"
    environment:
      - API_BASE_URL=[***]
      - LOG_LEVEL=info
      - FEATURE_TOGGLES='{"new-ui":true}'
    depends_on:
      - dsk-api-preprod  # 依赖后端API服务
    volumes:
      - ./ui-logs:/app/logs

  dsk-api-preprod:  # 后端API服务（示例）
    image: dsk-api-preprod:latest
    ports:
      - "8081:8080"

启动命令：docker-compose up -d

配置参数说明

容器端口

• 默认暴露端口：80（UI应用HTTP服务端口），可通过-p参数映射到主机任意端口

持久化路径

• 日志目录：/app/logs（应用运行日志输出路径）
• 配置目录：/app/config（自定义配置文件挂载路径，支持覆盖默认配置）

注意事项

• 该镜像仅用于预生产环境，不建议直接部署到生产环境
• 部署前需确保预生产环境网络可访问依赖服务（如后端API、CDN等）
• 建议通过环境变量注入敏感配置（如API密钥），避免硬编码到镜像中
• 定期更新镜像版本以获取最新功能和安全补丁，更新命令：docker pull dsk-ui-preprod:latest