thnks/bitbucket_pipelines

镜像概述

本Docker镜像专为BitBucket流水线环境设计，集成了Rails应用开发和运行所需的PostgreSQL数据库与Redis服务，旨在简化Rails项目在BitBucket Pipelines中的配置流程，提供一致的开发、测试和持续集成/部署（CI/CD）环境。

核心功能与特性

1. 集成关键服务

• PostgreSQL数据库：内置PostgreSQL服务，通过su-exec postgres pg_ctl start命令自动启动，满足Rails应用的数据存储需求。
• Redis服务：集成Redis缓存/消息队列服务，通过redis-server /etc/redis.conf命令基于默认配置文件启动，支持Rails应用的缓存、会话存储及异步任务处理。

2. 适配BitBucket Pipelines

• 镜像构建符合BitBucket Pipelines环境要求，可直接用于bitbucket-pipelines.yml配置，无需额外安装依赖。

3. 环境一致性保障

• 统一封装Rails应用依赖的基础服务，避免因环境差异导致的"在我机器上能运行"问题，确保开发、测试和CI流程的环境一致性。

使用场景与适用范围

1. BitBucket CI/CD流水线

• 作为BitBucket仓库中Rails项目的CI/CD运行环境，用于执行自动化测试、代码检查及构建流程。

2. 开发环境快速部署

• 本地开发环境的快速搭建，通过单一镜像启动Rails应用所需的数据库和缓存服务，减少多服务配置复杂度。

3. 测试环境标准化

• 为Rails应用的单元测试、集成测试提供标准化环境，确保测试结果的可靠性。

使用方法与配置说明

基本使用流程

1. 在BitBucket Pipelines中配置

在项目根目录的bitbucket-pipelines.yml文件中引用本镜像，示例配置如下：

yaml
image: bitbucket-rails-pg-redis:latest

pipelines:
  default:
    - step:
        script:
          - # 启动Rails应用（假设应用代码已挂载或克隆至容器内）
          - bundle install
          - rails db:create db:migrate
          - rails test

2. 本地测试运行

通过docker run命令启动容器，示例：

bash
# 启动容器并映射必要端口（PostgreSQL默认5432，Redis默认6379）
docker run -d \
  --name rails-dev-env \
  -p 5432:5432 \
  -p 6379:6379 \
  bitbucket-rails-pg-redis:latest

服务启动说明

容器启动时会自动执行以下命令初始化服务：

• PostgreSQL启动：su-exec postgres pg_ctl start（以postgres用户权限启动PostgreSQL服务）
• Redis启动：redis-server /etc/redis.conf（基于默认配置文件启动Redis服务）

配置自定义（可选）

PostgreSQL服务自定义

默认PostgreSQL服务使用内置配置，可通过挂载自定义配置文件覆盖：

bash
docker run -d \
  --name rails-dev-env \
  -v /path/to/custom-postgres.conf:/var/lib/postgresql/data/postgresql.conf \
  bitbucket-rails-pg-redis:latest

Redis服务自定义

通过挂载自定义Redis配置文件修改服务参数：

bash
docker run -d \
  --name rails-dev-env \
  -v /path/to/custom-redis.conf:/etc/redis.conf \
  bitbucket-rails-pg-redis:latest

注意事项

• 本镜像主要面向开发和测试环境，生产环境使用需额外配置安全策略（如数据库密码、网络隔离等）。
• 容器启动后，PostgreSQL和Redis服务默认在后台运行，可通过docker exec进入容器验证服务状态：

  bash
  # 检查PostgreSQL状态
  docker exec -it rails-dev-env su-exec postgres pg_ctl status
  
  # 检查Redis状态
  docker exec -it rails-dev-env redis-cli ping