pantheon-systems/terminus-conversion-tools-plugin

转换工具是一个Terminus插件,包含将标准Drupal站点转换为Composer管理的站点的命令。


README

GitHub Actions Early Access

Terminus 3.x Compatible

转换工具项目的主要目的是简化将基于Drupal的站点转换为Pantheon composer管理的Drupal站点的过程。使用此插件,您可以执行以下操作:

  • 将现有Drupal站点转换为Composer管理的Drupal站点
  • 在非官方上游中启用集成Composer
  • 将站点从外部托管平台导入到Pantheon
  • 从已弃用的上游更新到当前支持的上游

安装

要使用Terminus 3安装此插件

terminus self:plugin:install terminus-conversion-tools-plugin

用法

此插件添加了以下Terminus命令

  • conversion:advise
  • conversion:composer
  • conversion:create-project
  • conversion:convert-upstream-from-site
  • conversion:enable-ic
  • conversion:import-site
  • conversion:push-to-multidev
  • conversion:release-to-dev
  • conversion:restore-dev
  • conversion:update-from-deprecated-upstream
  • conversion:upgrade-d9
  • conversion:validate-gitignore

conversion:advise

运行terminus conversion:advise以分析站点的当前状态并提供下一步操作的建议

选项

  • skip-upgrade-checks: 跳过PHP版本和composer/upstream更新的检查。

conversion:composer

运行terminus conversion:composer将站点转换为由Composer管理的Drupal站点。此命令可以用于从以下状态转换站点

  • drupal8上游
  • 空上游
  • 基于构建工具的站点
  • 基于自定义上游的站点

选项

  • branch: 多dev环境的目标分支名称。
  • dry-run: 跳过创建多dev环境和推送composerified分支。
  • ignore-build-tools: 如果在基于构建工具的站点上使用,此命令将忽略构建工具设置,好像它不存在,并将删除它。
  • run-updb: 转换后运行drush updb。
  • run-cr: 转换后运行drush cr。

conversion:create-project

运行terminus conversion:create-project从Drupal发行版创建Pantheon站点。

选项

  • composer-options: 额外的composer选项。
  • label: 站点标签。
  • org: 创建站点的组织名称。
  • region: 创建站点的区域。

conversion:convert-upstream-from-site

运行terminus conversion:convert-upstream-from-site将示例站点转换为上游。

选项

  • commit-message: 推送到目标分支时使用的提交消息。
  • repo: 推送到上游仓库。如果省略,它将在composer extra部分中查找。

conversion:enable-ic

运行terminus conversion:enable-ic为站点启用Pantheon集成Composer。

选项

  • branch: 多dev环境的目标分支名称。
  • run-cr: 转换后运行drush cr。

conversion:import-site

运行terminus conversion:import-site根据导入的代码、数据库和文件创建站点。

选项

  • overwrite: 如果存在,覆盖存档提取时的文件。
  • org: 新站点的组织名称。
  • site-label: 新站点的站点标签。
  • region: 指定站点应创建的服务区域。有关有效区域的信息,请参阅文档
  • code: 导入代码。
  • code_path: 从指定目录导入代码。比"路径"参数有更高优先级。
  • db: 导入数据库。
  • db_path: 从指定的备份文件导入数据库。比"路径"参数有更高优先级。
  • files: 导入Drupal文件。
  • files_path: 从指定目录导入Drupal文件。比"路径"参数有更高优先级。
  • run-cr: 转换后运行drush cr

conversion:push-to-multidev

运行terminus conversion:push-to-multidev将转换后的站点推送到多dev环境。

选项

  • branch: 多dev环境的目标分支名称。
  • run-updb: 转换后运行drush updb。
  • run-cr: 转换后运行drush cr。

conversion:release-to-dev

运行 terminus conversion:release-to-dev 将由Composer管理的转换后的Drupal站点发布到开发环境。

选项

  • branch: 多dev环境的目标分支名称。
  • run-updb: 转换后运行drush updb。
  • run-cr: 转换后运行drush cr。

conversion:restore-dev

运行 terminus conversion:restore-dev 将开发环境分支恢复到其原始状态。

选项

  • run-cr: 转换后运行drush cr。

conversion:update-from-deprecated-upstream

运行 terminus conversion:update-from-deprecated-upstream 将基于"drupal9"或"drupal-recommended"的上游站点转换为基于"drupal-composer-managed"的上游站点。

选项

  • branch: 多dev环境的目标分支名称。
  • dry-run: 跳过创建多dev环境和推送composerified分支。
  • run-cr: 转换后运行drush cr。
  • target-upstream-git-url: 目标上游Git仓库URL。默认为https://github.com/pantheon-upstreams/drupal-composer-managed.git
  • target-upstream-git-branch: 目标上游Git仓库分支。默认为main

conversion:upgrade-d9

运行 terminus conversion:upgrade-d9 将集成Composer的Drupal 8升级到Drupal 9。

选项

  • branch: 多开发环境的目标分支名称。
  • skip-upgrade-status: 跳过升级状态检查。
  • dry-run: 跳过创建多开发环境和推送分支。
  • run-updb: 转换后运行 drush updb
  • run-cr: 转换后运行drush cr

conversion:validate-gitignore

运行 conversion:validate-gitignore 验证Git/Composer项目和相应更新.gitignore文件。

Terminus插件文档中了解更多关于Terminus插件的信息。