ruby-docker 镜像文档

1. 镜像概述和主要用途

ruby-docker 是为 epulse 项目构建的专用 Docker 镜像，主要用于支持该项目在 CircleCI 平台上的持续集成流程。镜像基于 Ruby 环境构建，集成必要依赖组件，确保 epulse 项目在 CircleCI 中高效执行自动化测试、构建等任务。

2. 核心功能和特性

• Ruby 环境支持：内置指定版本的 Ruby 运行时（如标签中的 2.7.4 对应 Ruby 2.7.4 版本），满足项目基础运行需求。
• 浏览器环境集成：包含 Chrome 浏览器（标签中 chrome 标识），支持依赖浏览器的自动化测试场景。
• CircleCI 兼容性：针对 CircleCI 持续集成流程优化，确保镜像可直接用于 CI 任务配置。
• 版本化管理：通过标签命名空间（如 2.7.4-chrome-circleci）实现版本控制，便于维护不同环境需求。

3. 使用场景和适用范围

适用场景

• epulse 项目在 CircleCI 上的持续集成任务（如单元测试、集成测试、构建流程等）。
• 需要 Ruby 2.7.4 环境及 Chrome 浏览器支持的自动化任务。

适用范围

epulse 开发团队及相关依赖项目，用于统一 CI 环境配置，提升流程一致性。

4. 使用方法和配置说明

4.1 镜像构建与推送流程

4.1.1 前置准备

1. 创建命名空间文件夹：按目标镜像标签创建同名文件夹（如目标标签为 2.7.4-chrome-circleci，则创建 2.7.4-chrome-circleci 文件夹）。
2. 添加构建文件：在文件夹中放入 Dockerfile、依赖配置文件等镜像构建所需资源。

4.1.2 本地构建与标记镜像

在目标文件夹内执行以下命令，完成镜像本地构建并标记：

# 格式：docker image build -t [仓库名]:[标签] .
docker image build -t knowink/ruby-docker:2.7.4-chrome-circleci .

说明：knowink/ruby-docker 为镜像仓库名，2.7.4-chrome-circleci 为具体标签（格式：[Ruby版本]-[组件标识]-circleci）。

4.1.3 推送镜像至仓库

构建完成后，将镜像推送至 Docker 仓库（需提前通过 docker login 登录仓库）：

# 格式：docker push [仓库名]:[标签]
docker push knowink/ruby-docker:2.7.4-chrome-circleci

5. 配置参数说明

当前镜像无需额外环境变量或配置参数，基础环境通过 Dockerfile 及文件夹内文件定义。如需自定义环境，可在构建前修改目标文件夹内的配置文件。