README

此存储库是一个基于 Composer 的 Drupal (Lightning Distro) 工作流程的初始状态，适用于 Pantheon。它旨在被 Terminus Build Tools Plugin 复制，该插件将为您设置一个全新的站点。

• GitHub 仓库
• 免费的 Pantheon 沙盒站点
• CircleCI 配置，用于运行测试并将源存储库 (GitHub) 推送到 Pantheon。

有关此类型工作流程的更多背景信息，请参阅 Pantheon 文档。

安装

先决条件

在运行 terminus build:project:create 命令之前，请确保您已具备所有先决条件

• Pantheon 账户
• Terminus，Pantheon 命令行工具
• Terminus Build Tools 插件
• 具有 GitHub 账户并具有创建新仓库权限的认证令牌。
• 具有 CircleCI 账户并具有认证令牌。

您可能发现将 GitHub 和 CircleCI 令牌作为变量导出到您的命令行中更容易，以便 Build Tools 插件可以自动检测它们

export GITHUB_TOKEN=[REDACTED]
export CIRCLE_TOKEN=[REDACTED]

一键设置

一旦您已满足所有先决条件，您可以使用一个命令创建此存储库的副本

terminus build:project:create ui-research/lightning-drops-8-composer:dev-master my-new-site --org="UI-Research"

如果这是 Urban "团队" 的一部分，则有一个额外的标志，如下所示

terminus build:project:create ui-research/lightning-drops-8-composer:dev-master my-new-site --org="UI-Research" --team="The Urban Institute"

此处显示的参数是

• 源存储库的名称，UI-Research/lightning-drops-8-composer。如果您对其他源存储库（如 WordPress）感兴趣，请参阅 Terminus Build Tools Plugin。
• 即将创建的 Pantheon 站点和 GitHub 存储库将使用的机器名称。将 my-new-site 更改为对您有意义的名称。
• --org 标志是可选的，并指向一个 GitHub 组织。
• --team 标志是可选的，并指向一个 Pantheon 组织。

重要文件和目录

/web

由于 pantheon.yml 中的配置，Pantheon 将从 /web 子目录中提供站点服务，从而便于使用基于 Composer 的工作流程。将您的网站放在此子目录中还允许将与您的项目相关的测试、脚本和其他文件存储在您的存储库中，而不会污染您的 Web 文档根目录。

/config

移动到 git 根目录的目录之一是 /config。此目录包含 Drupal 的 .yml 配置文件。在更传统的存储库结构中，这些文件将位于 /sites/default/config/。多亏了 此处的 settings.php 行，配置完全移动到了 Web 根目录之外。

composer.json

如果您只是在 GitHub 上浏览此存储库，您可能会注意到 Drupal 核心本身的文件不包括在此存储库中。这是因为 Drupal 核心和 contrib 模块通过 Composer 安装，并在 .gitignore 文件中忽略。特定的 contrib 模块通过 composer.json 添加到项目中，composer.lock 跟踪每个模块（或其他依赖项）的确切版本。模块和主题通过 composer.json 中的 "installer-paths" 部分放置在正确的目录中。 composer.json 还包含有关 drupal-scaffold 的说明，该说明负责将一些单个文件放置在正确的位置，例如 settings.pantheon.php。

Behat测试

为了让CircleCI有一些可运行的测试，这个仓库包含Behat测试的配置。您可以在/tests/features/目录下添加自己的.feature文件。

更新您的站点

当使用这个仓库来管理您的Drupal站点时，您将不再使用Pantheon仪表板来更新您的Drupal版本。相反，您将使用Composer来管理更新。确保您的站点处于Git模式，本地克隆它，然后从那里运行composer命令。像往常一样提交并推送您的文件回Pantheon。