juampynr/drupal8ci

Drupal 9 CI

https://circleci.com/gh/Lullabot/drupal9ci.svg?style=svg](https://circleci.com/gh/Lullabot/drupal9ci)

本仓库提供在Drupal 9项目中实现持续集成的基础框架，支持多种CI服务提供商，包括CircleCI、Travis CI、GitLab CI、GitHub Actions和Bitbucket Pipelines。通过运行对应安装程序并配置CI服务监控仓库变更，可实现在每次拉取请求时自动执行构建和测试。

核心功能与特性

• 多CI平台支持：兼容主流CI服务，包括CircleCI、Travis CI、GitLab CI、GitHub Actions和Bitbucket Pipelines
• 自动化测试流程：自动运行代码测试、构建验证和结果报告
• 灵活配置：支持自定义Docker镜像以适应特定项目架构
• 测试环境准备：提供数据库和文件目录同步方案，支持Behat和Cypress等测试框架

适用范围

• 使用https://github.com/drupal-composer/drupal-project%E5%88%9B%E5%BB%BA%E7%9A%84Drupal 9项目
• 需要实现持续集成流程的Drupal开发团队
• 需在拉取请求阶段自动验证代码质量和功能完整性的项目

环境要求

• 项目目录结构需符合drupal-project标准，否则需调整CI脚本
• 建议将settings.php部分内容纳入版本控制，使用settings.local.php管理数据库连接
• 文档根目录默认为web，若使用docroot需创建符号链接或修改相关配置文件

安装与使用

CircleCI

安装步骤

1. 从项目根目录运行安装脚本：

   bash
   curl -L https://github.com/lullabot/drupal9ci/raw/master/setup-circleci.sh | bash
   

2. 在https://circleci.com/%E6%B3%A8%E5%86%8C%E5%B9%B6%E6%8E%88%E6%9D%83%E8%AE%BF%E9%97%AE%E9%A1%B9%E7%9B%AE%E4%BB%93%E5%BA%93
3. 仓库变更后，CircleCI将自动监控并在拉取请求时执行构建

自定义Docker镜像

默认使用基于官方Drupal镜像扩展的https://hub.docker.com/r/juampynr/drupal8ci/%E3%80%82%E5%A6%82%E9%9C%80%E8%B0%83%E6%95%B4%EF%BC%8C%E5%8F%AF%E5%9F%BA%E4%BA%8E%E6%AD%A4%E9%95%9C%E5%83%8Fhttps://circleci.com/docs/2.0/custom-images/%E3%80%82

Travis CI

安装步骤

1. 从项目根目录运行安装脚本：

   bash
   curl -L https://github.com/lullabot/drupal9ci/raw/master/setup-travis-ci.sh | bash
   

2. 在https://travis-ci.com/%E6%B3%A8%E5%86%8C%E5%B9%B6%E6%8E%88%E6%9D%83%E8%AE%BF%E9%97%AE%E9%A1%B9%E7%9B%AE%E4%BB%93%E5%BA%93
3. 拉取请求将自动触发构建，可通过"Details"链接查看作业结果

代码覆盖率报告

1. 在https://coveralls.io/%E4%BD%BF%E7%94%A8GitHub%E8%B4%A6%E6%88%B7%E6%B3%A8%E5%86%8C%E5%B9%B6%E6%B7%BB%E5%8A%A0%E4%BB%93%E5%BA%93
2. 调整Coveralls设置以优化拉取请求反馈
3. 构建后可在拉取请求状态中查看覆盖率报告

GitLab CI

安装步骤

1. 从项目根目录运行安装脚本：

   bash
   curl -L https://github.com/lullabot/drupal9ci/raw/master/setup-gitlab-ci.sh | bash
   

2. 提交并推送更改后，在GitLab项目页面的"CI / CD >> 流水线"中查看运行状态

GitHub Actions

安装步骤

1. 从项目根目录运行安装脚本：

   bash
   curl -L https://github.com/lullabot/drupal9ci/raw/master/setup-github-actions.sh | bash
   

2. 提交并推送更改后，在GitHub仓库的"Actions"选项卡中查看工作流运行状态

Bitbucket Pipelines

安装步骤

1. 从项目根目录运行安装脚本：

   bash
   curl -L https://github.com/lullabot/drupal9ci/raw/master/setup-bitbucket.sh | bash
   

2. 提交并推送更改后，在Bitbucket仓库的"Pipelines"选项卡中查看运行状态

高级配置

Behat和Cypress作业设置

1. 数据库准备

• 使用Drush别名：配置SSH密钥后，在作业中执行drush @my.alias sql-cli
• 数据库Dump：上传清理后的数据库备份，设置DB_DUMP_URL环境变量供作业下载

2. 文件目录同步

• 使用Drush命令：drush rsync @my.alias @self
• 安装https://www.drupal.org/project/stage_file_proxy%E6%A8%A1%E5%9D%97%E5%AE%9E%E7%8E%B0%E6%96%87%E4%BB%B6%E4%BB%A3%E7%90%86%E8%AE%BF%E9%97%AE