cypress/factory

Cypress Docker Factory 镜像文档

镜像概述

该Docker镜像（factory）设计用于在自定义Dockerfile中作为基础镜像，帮助用户生成具有特定依赖版本的新Docker镜像。它旨在解决依赖版本控制问题，确保生成的镜像包含精确指定的依赖版本，从而提升环境一致性和构建可靠性。

核心功能和特性

• 特定依赖版本控制：支持指定多种依赖（如Node.js、Cypress等）的精确版本，满足自定义环境需求。
• 简化构建流程：作为基础镜像使用，减少自定义Dockerfile的编写复杂度，简化新镜像构建步骤。
• 环境一致性：通过统一的依赖版本管理，确保不同环境（开发、测试、生产）中的依赖一致性。
• 灵活性：适用于多种依赖组合场景，支持根据项目需求定制不同版本组合。

使用场景和适用范围

• 需要构建包含特定版本依赖的自定义Docker镜像的场景。
• CI/CD流程中，需确保构建环境依赖版本固定的场景。
• 开发团队需要统一开发或测试环境，避免“在我机器上能运行”问题。
• 多环境部署（如开发、测试、生产）需要不同依赖版本配置的场景。

使用方法和配置说明

基本使用步骤

1. 创建自定义Dockerfile：在自定义Dockerfile中，以该factory镜像为基础。
2. 指定依赖版本：通过构建参数或Dockerfile指令设置所需依赖版本。
3. 构建新镜像：执行docker build命令生成包含特定依赖版本的新镜像。

详细使用说明

完整使用指南及高级配置请参考官方文档：https://github.com/cypress-io/cypress-docker-images/tree/master/factory

Dockerfile示例

dockerfile
# 使用factory镜像作为基础
FROM cypress/factory:latest

# 通过ARG指定依赖版本（示例）
ARG NODE_VERSION=18.17.1
ARG CYPRESS_VERSION=13.6.0

# 可添加额外自定义配置
RUN echo "Using Node.js version: $NODE_VERSION"

构建命令示例

bash
# 构建包含指定Node.js和Cypress版本的自定义镜像
docker build \
  --build-arg NODE_VERSION=18.17.1 \
  --build-arg CYPRESS_VERSION=13.6.0 \
  -t my-custom-image:latest .

配置参数

支持通过--build-arg指定的常用参数（具体以官方文档为准）：

• NODE_VERSION：指定Node.js版本（如18.17.1）
• CYPRESS_VERSION：指定Cypress版本（如13.6.0）
• 其他依赖版本参数：根据项目需求添加（如npm_version等）

注意事项

• 建议固定factory镜像标签（如:latest或具体版本号），避免基础镜像更新导致构建异常。
• 构建过程需保证网络通畅，以便正确拉取指定版本的依赖包。
• 详细依赖支持列表及版本兼容性请查阅官方文档。