Ruby 2.2.x 构建镜像

镜像概述

本镜像是基于 RS Ops 提供的 ops_ruby22x_base 基础镜像构建的专用构建镜像，主要用于 Ruby 2.2.x 应用的开发阶段构建及 CI/CD 流程中的构建环节。其核心设计目标是集成开发与构建过程中必需的工具链，同时避免包含生产环境中无需的组件，以保持生产镜像的精简性。

核心功能与特性

基础特性

• 基于稳定基础：构建于 ops_ruby22x_base 镜像之上，继承 Ruby 2.2.x 运行环境及基础依赖。
• 开发/CI 工具集成：包含构建过程中常用的工具（生产镜像中通常避免包含），如 git（版本控制）、ssh（远程资源访问）等。

关键优势

• 环境一致性：确保开发与 CI 构建环境统一，减少"本地可运行，CI 构建失败"的环境差异问题。
• 生产隔离：将构建工具与生产运行环境分离，避免生产镜像因包含非必要工具导致的安全风险及体积膨胀。

使用场景与适用范围

适用场景

• Ruby 2.2.x 应用开发构建：本地开发阶段，用于执行代码拉取、依赖安装、资产编译等构建操作。
• CI/CD 流程集成：在 CI/CD 流水线中作为构建容器，自动化执行测试、打包等流程。

不适用场景

• 生产环境部署：本镜像包含非必要工具，不建议直接用于生产环境应用部署。

使用方法与配置说明

前提条件

• 已安装 Docker 环境（版本 1.13+ 或兼容版本）。

镜像拉取

bash
docker pull [镜像仓库地址]/ops_ruby22x_build:latest

注：请将 [镜像仓库地址] 替换为实际镜像仓库地址（如私有仓库或 RS Ops ***仓库）。

基本使用命令

1. 交互式运行（本地开发构建）

bash
docker run -it --rm \
  -v $(pwd):/app \  # 挂载本地项目目录到容器内 /app
  [镜像仓库地址]/ops_ruby22x_build:latest \
  /bin/bash  # 进入容器交互式终端，执行构建命令（如 bundle install、rake build 等）

2. 非交互式执行构建命令（CI 流程）

bash
docker run --rm \
  -v $(pwd):/app \
  -e GIT_SSH_COMMAND="ssh -i /root/.ssh/id_rsa" \  # 示例：配置 SSH 密钥路径（如需通过 SSH 拉取私有依赖）
  [镜像仓库地址]/ops_ruby22x_build:latest \
  sh -c "git clone [私有代码仓库地址] && cd project && bundle install && rake assets:precompile"

配置说明

• 环境变量：无特殊自定义环境变量，默认继承自 ops_ruby22x_base 基础镜像。如需自定义（如代理配置、SSH 密钥路径等），可通过 docker run -e 参数传入。
• 数据挂载：建议将项目代码目录、构建产物目录挂载到容器内，确保构建结果可持久化到宿主机或 CI 工作目录。

Docker 部署示例

docker-compose 配置示例（本地开发构建环境）

yaml
version: '3'
services:
  ruby-build:
    image: [镜像仓库地址]/ops_ruby22x_build:latest
    volumes:
      - ./:/app  # 挂载本地项目目录
      - ~/.ssh:/root/.ssh:ro  # 只读挂载本地 SSH 密钥（如需访问私有仓库）
    working_dir: /app
    command: sh -c "bundle install && rake test && rake build"  # 执行构建命令

使用方式：

bash
# 在 docker-compose.yml 目录下执行
docker-compose up

注意事项

1. 生产环境禁用：本镜像仅用于构建环节，生产环境部署请使用精简的 ops_ruby22x_base 或其他专用生产镜像。
2. 工具版本：镜像中包含的工具（如 git、ssh）版本以 ops_ruby22x_base 基础镜像及构建时的配置为准，如需特定版本工具，建议通过容器内命令手动升级或联系镜像维护团队。
3. 安全最佳实践：在 CI 环境中使用时，避免将敏感信息（如 SSH 密钥）直接嵌入镜像，建议通过环境变量或挂载方式临时注入，并在构建完成后清理。