fatsoma/ruby

镜像概述和主要用途

本镜像基于circleci/ruby构建，是一个扩展镜像。主要用途是在原基础上增加PostgreSQL客户端工具支持，并更新Ruby依赖管理工具bundler至1.16.3版本，以满足CI/CD流程中对PostgreSQL数据库交互及Ruby依赖管理的需求。

核心功能和特性

• 添加PostgreSQL客户端工具：集成postgresql-client，支持执行psql、pg_dump、pg_restore等PostgreSQL客户端命令，可直接在容器内与PostgreSQL数据库进行交互。
• 更新bundler版本：将Ruby依赖管理工具bundler更新至1.16.3，优化Ruby项目依赖的安装和管理流程。

使用场景和适用范围

• CircleCI构建环境：适用于基于CircleCI的Ruby项目构建流程，需在CI过程中执行数据库迁移、数据导入/导出、数据库备份等操作的场景。
• 本地开发辅助：可作为本地开发环境的辅助容器，用于模拟CI环境中的数据库交互操作，确保开发环境与CI环境的一致性。

使用方法和配置说明

基本使用（Docker Run）

直接运行镜像并验证功能：

bash
# 启动容器并检查postgresql-client版本
docker run --rm fatsoma/v2-service-core:latest psql --version

# 检查bundler版本
docker run --rm fatsoma/v2-service-core:latest bundle --version

在CircleCI配置中使用

在.circleci/config.yml中指定本镜像作为执行环境：

yaml
version: 2.1
jobs:
  build:
    docker:
      - image: fatsoma/v2-service-core:latest  # 使用本扩展镜像
    steps:
      - checkout
      - run: bundle install  # 使用更新后的bundler 1.16.3安装依赖
      - run: psql -h <postgres-host> -U <user> -d <dbname> -c "SELECT version();"  # 执行PostgreSQL客户端命令

注意事项

• 本镜像依赖circleci/ruby基础镜像，其版本需与基础镜像保持兼容，具体版本信息可参考基础镜像文档。
• 使用psql等命令时，需确保已配置正确的PostgreSQL连接参数（如主机、端口、用户名、密码等）。