README

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

概述

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

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

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

拉取请求工作流程

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

设置

有关设置说明，请参阅使用GitHub拉取请求与Composer和Drupal 8。

环境变量

Terminus Build Tools Plugin会自动配置Circle CI以构建您的网站。以下环境变量被定义：

• TERMINUS_TOKEN：之前创建的Terminus Machine token。
• GITHUB_TOKEN：由CircleCI用于在拉取请求中发布评论。
• 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、本地机器或直接在Pantheon上应用。

使用Terminus更新

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

terminus composer <sitename>.<dev> update

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

在本地机器上更新

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