juampynr/drupal9ci

Drupal 9 CI

该镜像提供在Drupal 9项目中实现持续集成的基础，支持以下CI提供商：

• CircleCI
• Travis CI
• GitLab CI
• GitHub Actions
• Bitbucket Pipelines

安装时，只需运行相应的安装程序，并允许所选CI提供商监控仓库变更，即可在每次拉取请求时自动开始构建。

如需测试单个模块而非整个Drupal项目，可参考Andrew Berry的https://github.com/deviantintegral/drupal_tests%E3%80%82

查看CircleCI工作演示。

要求

脚本假设您的Drupal 9项目是使用https://github.com/drupal-composer/drupal-project%E5%88%9B%E5%BB%BA%E7%9A%84%EF%BC%8C%E8%AF%A5%E9%A1%B9%E7%9B%AE%E6%8F%90%E4%BE%9B%E4%BA%86%E6%A0%87%E5%87%86%E7%9A%84%E5%9F%BA%E7%A1%80%E7%BB%93%E6%9E%84%E3%80%82%E5%A6%82%E6%9E%9C%E6%82%A8%E7%9A%84%E9%A1%B9%E7%9B%AE%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84%E4%B8%8Edrupal-project%E4%B8%8D%E5%90%8C%EF%BC%8C%E9%9C%80%E8%A6%81%E8%B0%83%E6%95%B4CI%E8%84%9A%E6%9C%AC%E3%80%82

建议将settings.php的部分内容添加到版本控制中，并依赖settings.local.php设置数据库连接。参考https://github.com/juampynr/drupal8-circleci/commit/817d0b6674c42dba73165b047b6b89d72ee72d11%E4%B8%AD%E7%9A%84%E7%9B%B8%E5%85%B3%E6%9B%B4%E6%94%B9%E3%80%82CI%E8%84%9A%E6%9C%AC%E5%8C%85%E5%90%AB%E8%87%AA%E5%B7%B1%E7%9A%84%60settings.local.php%60%EF%BC%8C%E4%BC%9A%E5%9C%A8%E6%9E%84%E5%BB%BA%E6%97%B6%E5%A4%8D%E5%88%B6%E5%88%B0%60web/sites/default%60%E7%9B%AE%E5%BD%95%E3%80%82

文档根目录：web vs docroot

默认情况下，Apache及其他代码将DocumentRoot设置为web目录。如果项目使用docroot，最简单的方法是创建符号链接，可在运行Apache前添加类似https://github.com/Lullabot/drupal9ci/blob/master/dist/bitbucket/RoboFile.php#L187%E7%9A%84%E5%91%BD%E4%BB%A4%EF%BC%88%E9%9C%80%E8%B0%83%E6%95%B4%E8%B7%AF%E5%BE%84%EF%BC%89%E3%80%82

或者，您可以手动替换相关文件中的路径，受影响文件列表可参考https://github.com/Lullabot/drupal9ci/issues/74#issuecomment-884238645%E3%80%82

安装

每个CI工具都有自己的安装程序，可提取运行作业所需的文件，并添加带测试的演示模块。

选择以下CI工具并按照安装步骤操作。

https://circleci.com

https://github.com/juampynr/drupal8-circleci | 深入文章

在项目根目录打开终端，运行安装程序：

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

在https://circleci.com/%E6%B3%A8%E5%86%8C%E5%B9%B6%E5%85%81%E8%AE%B8%E8%AE%BF%E9%97%AE%E9%A1%B9%E7%9B%AE%E4%BB%93%E5%BA%93%E3%80%82

!CircleCI监控

完成后，每次创建拉取请求时，CircleCI将运行作业集并报告结果，如下截图所示：

!CircleCI拉取请求

CircleCI功能概述可参考Lullabot博客文章。

使用自定义Docker镜像

CircleCI配置文件使用https://hub.docker.com/r/juampynr/drupal8ci/%EF%BC%8C%E8%AF%A5%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8Ehttps://hub.docker.com/_/drupal/%E6%9E%84%E5%BB%BA%E5%B9%B6%E6%89%98%E7%AE%A1%E5%9C%A8https://hub.docker.com/r/juampynr/drupal8ci/%E3%80%82%E5%A6%82%E6%9E%9C%E8%AF%A5%E9%95%9C%E5%83%8F%E4%B8%8D%E7%AC%A6%E5%90%88%E9%A1%B9%E7%9B%AE%E6%9E%B6%E6%9E%84%EF%BC%8C%E5%8F%AF%E8%80%83%E8%99%91https://circleci.com/docs/2.0/custom-images/%E3%80%82

https://travis-ci.org

https://github.com/juampynr/drupal8-travis-ci | 深入文章

在项目根目录打开终端，运行安装程序：

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

在https://travis-ci.com/%E6%B3%A8%E5%86%8C%E5%B9%B6%E5%85%81%E8%AE%B8%E8%AE%BF%E9%97%AE%E9%A1%B9%E7%9B%AE%E4%BB%93%E5%BA%93%EF%BC%9A

!Travis监控

完成后，每次拉取请求将触发Travis构建，进度如下截图所示：

!Travis拉取请求

要查看单个作业结果，需点击上述截图中的"Details"链接：

!Travis CI作业

设置代码覆盖率报告

https://coveralls.io/%E6%98%AF%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%8F%AF%E5%9C%A8%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E4%B8%AD%E6%89%98%E7%AE%A1%E5%92%8C%E5%B1%95%E7%A4%BAPHPUnit%E4%BB%A3%E7%A0%81%E8%A6%86%E7%9B%96%E7%8E%87%E6%8A%A5%E5%91%8A%E3%80%82%E8%AE%BE%E7%BD%AE%E6%96%B9%E6%B3%95%E5%A6%82%E4%B8%8B%EF%BC%9A

使用GitHub账户在https://coveralls.io%E6%B3%A8%E5%86%8C%EF%BC%8C%E7%84%B6%E5%90%8E%E6%B7%BB%E5%8A%A0%E4%BB%93%E5%BA%93%EF%BC%8C%E5%A6%82%E4%B8%8B%E6%88%AA%E5%9B%BE%E6%89%80%E7%A4%BA%EF%BC%9A

!Coveralls添加仓库

调整设置以获得更清晰的拉取请求反馈：

!Coveralls设置

完成后，点击拉取请求状态消息中的"Details"可查看示例报告：

!Coveralls报告

https://about.gitlab.com/features/gitlab-ci-cd/

https://gitlab.com/juampynr/drupal8-gitlab | 深入文章

在项目根目录打开终端，运行安装程序：

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

检查、提交并推送更改。然后在GitLab项目主页导航至"CI / CD >> Pipelines"部分，将看到运行中的管道：

!GitLab管道

https://github.com/features/actions

https://github.com/juampynr/drupal8-github-actions

在项目根目录打开终端，运行安装程序：

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

检查、提交并推送更改。然后在GitHub仓库主页导航至"Actions"标签，将看到运行中的工作流：

!GitHub Actions

https://support.atlassian.com/bitbucket-cloud/docs/get-started-with-bitbucket-pipelines

在项目根目录打开终端，运行安装程序：

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

检查、提交并推送更改。然后在Bitbucket仓库主页导航至"Pipelines"标签，将看到运行中的工作流：

!Bitbucket Pipelines

为所有平台设置Behat和Cypress作业

Behat和Cypress作业需要运行中的Drupal 9站点。仓库包含代码，但要在真实环境中运行测试，需：

1. 生产环境的最新数据库副本

Travis

如果有Drush站点别名且仓库为私有，按照https://docs.travis-ci.com/user/private-dependencies/#User-Key%E7%9A%84%E8%AF%B4%E6%98%8E%E6%93%8D%E4%BD%9C%E3%80%82%E7%84%B6%E5%90%8E%E8%AE%BE%E7%BD%AEDrush%E7%AB%99%E7%82%B9%E5%88%AB%E5%90%8D%EF%BC%8C%E6%9C%80%E5%90%8E%E8%B0%83%E6%95%B4Behat%E4%BD%9C%E4%B8%9A%E4%BB%A5%E8%BF%90%E8%A1%8C%60drush @my.alias sql-cli`。

CircleCI

如果有Drush站点别名，在CircleCI仪表板的项目权限中添加SSH密钥。然后在.circleci/config.yml的Behat作业中添加drush @my.alias sql-cli。

替代方案

或者，上传清理后的数据库转储，并设置DB_DUMP_URL环境变量，以便作业下载。

例如： !Travis CI数据库环境变量 !CircleCI数据库环境变量

2. 生产环境的文件目录

如果有站点别名，在Behat作业中添加drush rsync @my.alias @self。或者使用https://www.drupal.org/project/stage_file_proxy%E6%A8%A1%E5%9D%97%E3%80%82