cicoub13/gladys

Gladys PR开发镜像

镜像概述和主要用途

本镜像为Gladys项目的Pull Request（PR）开发提供专用开发环境，旨在为开发者提供一致、预配置的运行环境，简化PR开发流程并提升协作效率。主要用于支持PR相关的代码开发、功能测试及兼容性验证工作。

核心功能和特性

• 预配置开发环境：集成Gladys项目开发所需的依赖包、工具链及运行时环境，无需手动配置基础开发组件。
• PR流程适配：针对Gladys项目PR开发流程优化，确保与项目代码库及CI/CD流程的兼容性。
• 轻量级设计：基于精简基础镜像构建，平衡功能完整性与资源占用，适合本地开发及CI环境部署。
• 灵活扩展：支持通过环境变量及挂载卷自定义配置，满足不同开发场景需求。

使用场景和适用范围

• 本地PR开发：Gladys项目开发者在提交PR前，可使用本镜像进行本地代码编写、功能调试和单元测试。
• PR兼容性验证：在CI/CD流程中，通过本镜像运行PR代码，验证其与项目主分支的兼容性及功能正确性。
• 团队协作环境：统一团队开发环境，避免因本地配置差异导致的环境不一致问题。

使用方法和配置说明

基本使用（docker run）

bash
# 拉取镜像（假设镜像标签为gladys/pr-dev:latest）
docker pull gladys/pr-dev:latest

# 运行容器并挂载本地代码目录
docker run -it --rm \
  -v /本地/gladys代码目录:/app \
  -w /app \
  gladys/pr-dev:latest \
  /bin/bash

上述命令启动容器并进入交互式终端，本地代码目录挂载至容器内/app路径，可直接执行开发命令（如npm install、npm run dev等）。

环境变量配置

通过-e参数设置环境变量，调整容器运行行为：

• NODE_ENV：开发环境类型，默认值为development，可选test（测试环境）。
• PORT：应用运行端口，默认值为3000，需映射端口时配合-p参数（如-p 3000:3000）。

示例（指定测试环境并映射端口）：

bash
docker run -it --rm \
  -v /本地/gladys代码目录:/app \
  -w /app \
  -e NODE_ENV=test \
  -p 3000:3000 \
  gladys/pr-dev:latest \
  npm run test

配合docker-compose使用

创建docker-compose.yml文件：

yaml
version: '3'
services:
  pr-dev:
    image: gladys/pr-dev:latest
    volumes:
      - /本地/gladys代码目录:/app
    working_dir: /app
    environment:
      - NODE_ENV=development
      - PORT=3000
    ports:
      - "3000:3000"
    tty: true

启动服务：

bash
docker-compose up -d
# 进入容器终端
docker-compose exec pr-dev /bin/bash

常用开发命令示例

容器内可执行Gladys项目标准开发命令：

• 安装依赖：npm install
• 启动开发服务器：npm run dev
• 运行单元测试：npm run test
• 构建项目：npm run build

注意事项

• 本地代码目录需包含完整的Gladys项目代码（如从GitHub克隆的仓库），确保容器内可访问项目配置文件。
• 首次运行时可能需要等待依赖安装完成，具体时间取决于网络环境。
• 如需持久化容器状态，可移除--rm参数（建议通过挂载卷管理依赖以保持环境一致性）。