README

使用Pantheon的构建工具和CircleCI Orb安装Drupal 9

在https://github.com/pantheon-systems/drupal-9-with-circleci-orb README.md中了解更多关于使用Pantheon的构建工具和CircleCI Orb安装Drupal 9的信息。

Open Social项目

在Drupal.org的特色案例研究和访问专门的网站www.GetOpenSocial.com或关注@OpenSocialHQ在Twitter上了解更多关于Open Social、团队和流程的信息。

开始之前

请确保您

• 熟悉您的操作系统的命令行。
• 使用基于Unix的系统（Linux或Mac OS X）。Windows命令可能略有不同。
• 已创建Pantheon账户：https://dashboard.pantheon.io/register。Pantheon账户始终免费用于开发。
• 已生成SSH密钥：https://pantheon.io/docs/ssh-keys，添加到您的Pantheon仪表板，并在本地SSH代理中加载。
• 您已在本地计算机上安装并配置了Git和Composer。

  • Composer：https://getcomposer.org.cn/download/，PHP的包管理器，已安装到您的机器上。

  • Mac用户可以使用Homebrew：https://brew.sh.cn/安装Git和Composer及其依赖项。

    brew install git composer
    

安装Terminus

一个命令行界面，允许您控制您的Pantheon账户和站点。您可以在Terminus中编写几乎任何您可以在Pantheon仪表板上执行的操作。它还可以在本地未安装Drush的情况下在您的环境中进行远程Drush调用，消除本地和远程安装的Drush版本之间的兼容性问题。由于您的站点基于Composer，当在平台上运行Drush命令时，Terminus将使用在vendor/bin/drush中找到的Drush版本。

• 如果您尚未在系统上安装它，请参阅此文档https://pantheon.io/docs/terminus/install以安装Terminus。

• 在Pantheon仪表板中通过点击用户仪表板 > 账户 > 机器令牌生成Pantheon机器令牌生成Pantheon机器令牌。使用机器令牌验证Terminus。

  terminus auth:login --machine-token=‹machine-token›
  

• 安装后验证会话

  terminus site:list
  

  如果您的Pantheon站点在列表中，则安装和身份验证成功！

• 安装Terminus构建工具

  terminus self:plugin:install terminus-build-tools-plugin
  

访问令牌

构建工具插件将提示您为使用的服务创建访问令牌，作为密码的替代。访问令牌存储为环境变量。访问令牌的要求因服务而异。请阅读以下具体访问令牌要求。

• GitHub：GitHub令牌检查以下作用域
  • repo（必需）
  • delete-repo（可选）
  • workflow（如果使用GitHub Actions而不是CircleCI，则为必需）
• CircleCI：此令牌不可配置任何作用域。

在Pantheon上安装您的Open Social站点

要创建一个包含单独的GitHub仓库、CircleCI配置和带有OpenSocial的Pantheon沙箱的此仓库的副本，请运行以下命令。请确保将machine-name-for-new-site替换为您选择的机器名称，将optional-pantheon-organization-name替换为您的Pantheon组织名称。请注意，拥有Pantheon组织是可选的，不是必需的。

terminus build:project:create "SalifT/opensocial-drops-9:dev-master" machine-name-for-new-site --stability=dev --team='optional-pantheon-organization-name'

该命令完成后，请通过浏览器访问以验证在Pantheon Dev环境中已安装了带有Drupal 9的Open Social。此命令将为您提供一次性的登录链接到开发环境。请确保将machine-name-for-new-site替换为您上面选择的机器名称。

terminus drush machine-name-for-new-site.dev -- user-login

安装可选模块

如果您要在浏览器中使用/core/install.php页面的安装程序安装，在浏览过程中，Open Social会建议选择要安装的可选模块。然而，在当前情况下并非如此。您的网站已经安装，并且目前只安装了推荐的模块。您可以使用terminus安装可选模块。

使用terminus安装可选模块

确保您的网站处于SFTP模式，然后运行

terminus drush machine-name-for-new-site.dev -- pm-enable module_machine_name -y

将module_machine_name替换为您要安装的模块的机器名称。在撰写本文时，下表列出了OpenSocial 11.2.2在浏览器中core/install.php安装期间建议的模块列表

一次性安装多个模块

terminus drush machine-name-for-new-site.dev -- pm-enable module_machine_name_1 module_machine_name_2 module_machine_name_3 -y

运行以下命令以安装所有可选模块：请确保将machine-name-for-new-site替换为您网站的机器名称。您可以将不需要安装的可选模块的modle_machine_name从命令中删除。

terminus drush machine-name-for-new-site.dev -- pm-enable dynamic_page_cache inline_form_errors page_cache social_file_private social_gdpr social_graphql social_lets_connect_contact social_lets_connect_usage social_activity_filter social_album social_album social_book social_comment_upload social_content_block social_content_report social_embed social_event_addtocal social_event_an_enroll social_event_an_enroll social_event_enrolments_export social_event_managers social_event_max_enroll social_event_type social_follow_user social_footer social_group_default_route social_group_flexible_group social_group_secret social_landing_page social_private_message social_profile_fields social_profile_organization_tag social_profile_preview social_profile_privacy social_sharing social_tagging social_user_export data_policy -y

添加演示内容

安装社交演示模块。

terminus drush machine-name-for-new-site.dev -- pm-enable social_demo -y

之后，您可能希望清除远程drush应用程序在开发环境中的缓存。

terminus drush machine-name-for-new-site.dev -- cc drush

运行drush cache rebuild。

terminus drush machine-name-for-new-site.dev -- cr

运行以下命令，查看social-demo命令是否可用于Drush：在撰写本文时，Open Social 11.2.2支持与Pantheon兼容的Drush版本10。在您阅读本文时，Drush版本可能是11或其他。请注意，根据您的Drush版本，命令的语法可能略有不同。

terminus drush machine-name-for-new-site.dev

您应该在drush^10可用的命令列表中看到social-demo下的以下命令

要添加内容，请使用以下terminus drush命令

terminus drush machine-name-for-new-site.dev demo-content:add file user group topic event event_enrollment comment post like

顺序（例如file -> user -> group）很重要，因为内容相互依赖。

要删除内容，请使用以下命令

terminus drush machine-name-for-new-site.dev demo-content:remove file user group topic event event_enrollment comment post like

使用terminus drush的其他social-demo命令用法

从EEA配置文件生成用户和主题的演示内容

terminus drush machine-name-for-new-site.dev social-demo:add user topic --profile=EEA

从EEA配置文件删除用户和主题的演示内容

terminus drush machine-name-for-new-site.dev social-demo:remove user topic --profile=EEA

生成100个演示用户和2000个主题

terminus drush machine-name-for-new-site.dev social-demo:generate user:100 topic:2000 event:500 group:100

开发工作流程

使用Pantheon构建工具集成指南，通过GitHub、CircleCI和Multidev/Dev环境开发您的项目，以实现真正优秀的开发工作流程。接下来，将项目部署到Pantheon测试和实时环境。当在您的GitHub仓库中创建pull请求时，它们将在Pantheon上生成Multidev环境，该环境从实时环境复制数据库和文件。请确保将machine-name-for-new-site替换为您上面选择的机器名称。

terminus env:deploy machine-name-for-new-site.test
terminus env:deploy machine-name-for-new-site.live

Terminus和Drush的力量

本指南仅触及了使用Terminus和Drush可以做到的一小部分。虽然Terminus提供了管理大多数方面的能力，但像Drush这样的工具则赋予你管理在Pantheon上运行的Open Social站点内部运作的能力。现在你已经准备好，可以探索你设置的沙盒站点，自行看看还有哪些可能性。

另请参阅

https://pantheon.io/docs/guides/drupal-commandline 以及更多内容，请访问 https://pantheon.io