README

此存储库是 Pantheon 基于 Composer 的 Drupal 工作流程的起始状态。它旨在由 Terminus Build Tools 插件复制，该插件将为您设置全新的

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 pantheon-systems/example-drops-8-composer my-new-site --team="Agency Org Name"

此处显示的参数是

源仓库的名称，pantheon-systems/example-drops-8-composer。如果您对其他源仓库（如 WordPress）感兴趣，请参阅 Terminus Build Tools 插件。
将被即将创建的 Pantheon 站点和 GitHub 仓库使用的机器名称。将 my-new-site 更改为您有意义的内容。
--team 标志是可选的，并指代 Pantheon 组织。Pantheon 组织通常是网络开发机构或大学。设置此参数会导致新创建的站点位于指定的组织内。运行 Terminus 命令 terminus org:list 以查看您是成员的组织。可能没有。

重要文件和目录

`/web`

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

`/config`

移动到 git 根目录的目录之一是 /config。此目录包含 Drupal 的 .yml 配置文件。在更传统的仓库结构中，这些文件将位于 /sites/default/config/。感谢此行中的 settings.php，配置已完全移出 web 根目录。

`composer.json`

如果您只是在GitHub上浏览此存储库，您可能会注意到Drupal核心本身的文件不包括在此存储库中。这是因为Drupal核心和贡献模块是通过Composer安装的，并在.gitignore文件中被忽略。特定的贡献模块通过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。

philltran / example-drops-8-composer

维护者

详细信息