README

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

概览

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

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

设置说明取决于您选择哪个选项。

拉取请求工作流程

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

设置

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

环境变量

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

TERMINUS_TOKEN：之前创建的Terminus Machine令牌。
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，或在您的本地机器上应用。

使用 Terminus 更新

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

terminus composer <sitename>.<dev> update

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

在您的本地机器上更新

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

my-profile-upstream / upstream-test-project

维护者

详细信息