README

此存储库可用于在Pantheon（Pantheon）上设置Composer管理的Drupal 8站点。

概览

此项目仅包含用于在Pantheon上构建Drupal站点的规范资源。它可以通过两种不同的方式使用：

• 在GitHub上创建单独的规范存储库；使用pull request工作流程进行维护。推荐
• 构建完整的Drupal站点并将其安装到Pantheon；使用terminus composer和服务器端开发进行维护。

设置说明将根据您选择哪种选项而有所不同。

Pull Request工作流程

当使用pull request工作流程时，仅规范资源（代码、配置等）存在于GitHub上的master存储库中。使用构建步骤创建完整的Drupal站点并将其自动部署到Pantheon。这是推荐使用此项目的方式。

设置

有关设置说明，请参阅使用GitHub Pull Requests与Composer和Drupal 8。

环境变量

Terminus Build Tools插件会自动配置Circle CI以构建您的站点。以下环境变量已定义：

• TERMINUS_TOKEN：之前创建的Terminus Machine令牌。
• GITHUB_TOKEN：由CircleCI用于在pull请求上发布评论。
• TERMINUS_SITE：将用于测试站点的Pantheon站点名称。
• TEST_SITE_NAME：用于在安装Drupal时设置测试站点的名称。
• ADMIN_EMAIL：用于在安装Drupal时配置要使用的电子邮件地址。
• ADMIN_PASSWORD：用于在站点安装期间设置uid 1用户的密码。
• GIT_EMAIL：用于配置我们提交时使用的git用户电子邮件地址。

如果您需要修改任何这些值，可以在Circle CI环境变量配置页面中修改。

SSH密钥

创建并添加到Circle CI（私钥）和Pantheon站点（公钥）的公钥/私钥对。如果您需要更新公钥，可以使用Terminus进行更新。

$ terminus ssh-key:add ~/.ssh/id_rsa.pub

Pantheon "独立" 开发

此项目还可以用于在Pantheon上使用服务器端开发进行传统的"独立"开发。在此模式下，规范存储库立即构建为完整的Drupal站点，并将结果提交到Pantheon存储库。之后，不再使用规范存储库；所有开发都仅使用Pantheon数据库进行。

在进行"独立"开发时，此项目可以作为上游存储库使用，或者可以手动设置。有关如何进行操作的说明将在下面的部分中提供。

作为上游

根据Pantheon 自定义上游文档中的说明为该项目创建一个自定义上游。这样做时，每次您创建一个网站时，Pantheon 都会自动运行 composer install 来填充 web 和 vendor 目录。

手动设置

输入以下命令以在 Pantheon 上创建一个新的网站并将该项目的副本推送到它。

$ SITE="my-site"
$ terminus site:create $SITE "My Site" "Drupal 8" --org="My Team"
$ composer create-project pantheon-systems/example-drops-8-composer $SITE
$ cd $SITE
$ composer prepare-for-pantheon
$ git init
$ git add -A .
$ git commit -m "Initial commit"
$ terminus  connection:set $SITE.dev git
$ PANTHEON_REPO=$(terminus connection:info $SITE.dev --field=git_url)
$ git remote add origin $PANTHEON_REPO
$ git push --force origin master
$ terminus drush $SITE.dev -- site-install --site-name="My Drupal Site"
$ terminus dashboard:view $SITE

将 my-site 替换为您为您的 Pantheon 网站提供的名称。根据需要自定义 site:create 和 site-install 行的参数。

安装 Drupal

注意，此示例仓库在 settings.php 中将安装配置文件设置为 'standard'，因此安装程序不需要修改设置文件。如果您想安装不同的配置文件，请在安装您的网站之前适当修改 settings.php。

更新您的网站

当使用此仓库管理您的 Drupal 网站时，您将不再使用 Pantheon 仪表板来更新您的 Drupal 版本。相反，您将使用 Composer 来管理您的更新。更新可以直接在 Pantheon 上使用 Terminus，或在您的本地机器上应用。

使用 Terminus 更新

安装 Terminus 1 和 Terminus Composer 插件。然后，要更新您的网站，确保它在 SFTP 模式下，然后运行

terminus composer <sitename>.<dev> update

其他命令也可以使用；例如，您可以使用 terminus composer <sitename>.<dev> require drupal/pathauto 安装新的模块。

在您的本地机器上更新

您还可以将您的网站置于 Git 模式，本地克隆它，然后从那里运行 composer 命令。像往常一样提交并将您的文件推回 Pantheon。