在 WordPress.com 上使用 GitHub 部署

GitHub 部署会将您的 GitHub 存储库直接集成到 WordPress.com 站点上，为您提供一个版本受控的自动化工作流，用于部署对插件、主题或整个站点的更改。本指南涵盖设置流程以及管理已连接存储库的方法。

采用 WordPress.com 商务版和电商版套餐的站点可使用此功能。如果您有商务版套餐，请确保将其激活。对于免费站点和使用个人版及高级版套餐的站点，请升级您的套餐以使用此功能。

此视频为英文内容。
YouTube 提供自动翻译功能，帮助您以母语观看：

开启自动翻译字幕的方法：

1. 播放视频。
2. 点击视频右下角的 ⚙️ 设置 图标。
3. 选择 字幕/CC。
4. 选择 自动翻译。
5. 从列表中选择您的首选语言。

使用自动配音（实验功能）的方法：

1. 点击 ⚙️ 设置 图标。
2. 选择 音轨。
3. 选择您想收听的语言：

ℹ️ 翻译和配音由 Google 自动生成，可能不够准确，且自动配音功能仍在测试中，暂未向所有语言开放。

在将 GitHub 存储库部署到您的 WordPress.com 站点之前，您需要先通过以下步骤在两者之间建立连接：

1. 访问您的“站点”页面：https://wordpress.com/sites/
2. 点击您站点的名称以查看站点概览。
3. 点击“部署”选项卡。
4. 点击“连接存储库”按钮。然后，如果您看到列出的存储库，则表示您已连接 GitHub 账户。继续执行步骤 11。
5. 点击“安装 WordPress.com 应用程序”按钮。
6. 新窗口将打开，如果您尚未登录 GitHub 账户，系统将提示您进行登录。然后，您将看到此屏幕：

7. 点击“授权 WordPress.com for Developers”按钮。
8. 选择您的存储库所在的 GitHub 组织或账户。
9. 选择您要连接的一个或多个存储库：
   • 所有存储库：选择此选项将授权 WordPress.com 访问所选 GitHub 账户拥有的所有当前和未来存储库。这包括只读的公共存储库。
   • 仅特定存储库：选择此选项将允许您选择 WordPress.com 可以在所选 GitHub 账户上访问的存储库。 
10. 选定选项后，点击“安装”按钮。
11. 新窗口将关闭，您将返回 WordPress.com。您所选的存储库应与关联该存储库的 GitHub 账户一并列出：

12. 点击要连接的存储库旁边的“选择”。

此时，您应该能在您的“已授权的 GitHub 应用程序”和“已安装的 GitHub 应用程序”下看到 WordPress.com for Developers。

选定存储库后，您需要调整部署设置：

• 部署分支：默认为存储库的默认分支（通常为“main”），但可更改为您想使用的分支。
• 目标目录：您要在其中部署文件的服务器文件夹。对于插件，目标目录为 /wp-content/plugins/my-plugin-name。对于主题，目标目录为 /wp-content/themes/my-theme-name。如需部署部分站点内容（即多个插件或主题），您可以使用 /wp-content。存储库的内容将与 WordPress 站点在指定目录中的现有内容合并。
• 自动部署：您可以通过两种方式将内容部署到 WordPress.com：
  • 自动：代码一经提交，将部署到您的 WordPress.com 站点。建议对暂存站点启用自动部署。
  • 手动：代码将在您请求部署后部署。建议对生产站点启用手动部署。
• 部署模式：存在两种部署类型：
  • 简单：此模式会将所有文件从存储库的分支复制到站点，然后直接部署，不进行任何后处理。
  • 高级：此模式支持使用工作流脚本，可实现自定义构建步骤，例如安装 Composer 依赖项、执行部署前代码测试以及控制文件部署。非常适合需要 Composer 或 Node 软件的存储库。更多信息请参阅下文的“高级部署”部分。

配置完所有设置后，点击“连接”按钮。您的存储库将被添加：

请注意，您必须触发首次部署，无论是自动还是手动。然后，您可以随时通过点击“连接存储库”按钮连接另一个存储库。

借助高级部署功能，您可以在部署前提供工作流脚本来处理存储库中的文件。这将开启诸多可能性，例如检查代码是否符合团队编码规范、运行单元测试、将文件从部署范围中排除、安装依赖项等。开始使用前，请参阅我们的工作流示例。

要设置高级部署，请执行以下步骤：

1. 系统将显示一个表单，您可以在其中配置部署。
2. 点击存储库的名称以管理连接。
3. 在右侧的“选择您的部署模式”下，选择“高级”。

4. 如果存储库中已包含工作流文件，您可在此处进行选择。系统将检查文件是否存在任何错误。如果未发现错误，请继续执行步骤 7。
5. 您也可以选择“创建新工作流”选项来添加预配置的工作流文件。选择此选项将覆盖 wpcom.yml 工作流文件（如果您的存储库中已存在）。
6. 点击“为我安装工作流”按钮，将工作流文件提交到存储库。
7. 添加并验证工作流后，点击“更新”。您的存储库现在将使用高级部署功能。

将您的 GitHub 存储库连接到站点后，下一步实际上是部署您的代码。您可通过两种方法进行部署：自动和手动。

不建议对实时生产站点启用自动部署，因为存储库中的任何代码更改都会自动从 GitHub 部署到实时站点。相反，请考虑设置自动部署到暂存站点，待准备就绪后再同步到生产站点。

手动部署能让您更自主地控制代码变更何时上线，因为每次部署都需要您手动触发。如果您不想使用暂存站点，我们建议您启用手动部署。

要手动触发部署，请执行以下步骤：

1. 访问您的“站点”页面：https://wordpress.com/sites/
2. 点击您站点的名称以查看站点概览。
3. 点击“部署”选项卡。
4. 点击您要部署的存储库上的省略号菜单 (⋮)。
5. 选择“触发手动部署”。您应该会看到一条横幅通知提示“部署运行已创建”，并且部署状态将变更为“已排队”。
6. 等待部署完成（状态将变更为“已部署”）。

7. 再次点击省略号菜单 (⋮)，然后选择“查看部署运行”。 
8. 部署运行日志会显示作者和已部署的提交信息。如果您点击部署运行条目，则可以查看更多信息。

要管理您的现有 GitHub 存储库连接，请执行以下步骤：

1. 访问您的“站点”页面：https://wordpress.com/sites/
2. 点击您站点的名称以查看站点概览。
3. 点击“部署”选项卡。
4. 然后，您应该会看到连接列表。 

当 GitHub 存储库与您的站点之间存在至少一个连接时，系统将显示连接列表。该列表包含每个连接的相关信息，例如存储库名称和分支、最后部署到站点的提交信息、发生时间、代码放置位置、部署运行耗时及其状态。

点击省略号菜单 (⋮) 后，您还可以执行以下额外操作：

• 触发手动部署：在已配置分支的最新提交信息上启动部署运行。
• 查看部署运行：打开已连接存储库的部署运行日志视图。
• 配置连接：打开存储库的管理连接视图。
• 断开存储库连接：移除存储库与站点之间的连接。

部署运行日志可提供每次部署的详细分步记录，无论是自动触发还是手动触发。这些日志可帮助您追踪更改、监控部署状态并排查出现的任何问题。通过访问最近 30 天内最后 10 次运行的日志，您可以轻松查看每次部署期间发生的情况，并确保一切运行顺畅。

要检查部署日志，请执行以下步骤：

1. 访问您的“站点”页面：https://wordpress.com/sites/
2. 点击您站点的名称以查看站点概览。
3. 点击“部署”选项卡。
4. 点击要查看其日志的存储库旁边的省略号菜单 (⋮)。
5. 选择“查看部署运行”。
6. 部署运行列表视图会显示已部署到站点的提交信息、部署状态、日期和持续时间。
7. 点击运行条目的任意位置即可展开并查看有关该部署的更多信息。

日志记录了所有已执行的命令，包括从 GitHub 获取代码，以及将其放置在目标目录中。您可以通过点击“显示更多”来展开日志行以查看更多信息。

在您断开 GitHub 存储库与您站点的连接后，将来对该存储库的任何更改都不会再影响您的站点。默认情况下，已部署的文件仍会保留在您的站点上，但您可以选择在断开连接的过程中将其删除。

要删除存储库，请执行以下步骤：

1. 访问您的“站点”页面：https://wordpress.com/sites/
2. 点击您站点的名称以查看站点概览。
3. 点击“部署”选项卡。
4. 点击存储库上的省略号菜单 (⋮)。
5. 选择“断开存储库连接”。
6. 屏幕上将出现一个对话框窗口。点击开关即可将关联文件从站点中移除。
7. 点击“断开存储库连接”，以关闭对话框并断开存储库连接。

请注意，WordPress.com for Developers 仍会出现在您的已安装的 GitHub 应用程序和已授权的 GitHub 应用程序中。这是因为 WordPress.com 仍然可以访问该存储库，但连接已被删除。

您还可以选择撤销 WordPress.com 对您的 GitHub 账户的访问权限。您随时可通过访问 GitHub 上的应用程序设置来执行此操作。 

要撤销授权应用程序对您 GitHub 账户的访问权限，请执行以下步骤：

1. 转到“已授权的 GitHub 应用程序”。
2. 点击 WordPress.com for Developers 旁边的“撤销”。
3. 点击“我已知晓，撤销访问权限”按钮。

即使您撤销了已授权的应用程序访问权限，代码仍然可以部署，因为 WordPress.com for Developers 应用程序仍然安装在所选账户上。

要撤销对 WordPress.com 安装的访问权限并禁用向您的 WordPress.com 站点部署代码的功能，请执行以下步骤：

1. 转到“已安装的 GitHub 应用程序”。
2. 点击 WordPress.com for Developers 旁边的“配置”。
3. 在“危险区”区域中，点击“卸载”，然后在系统提示时点击“确定”。

从授权应用程序列表中移除 WordPress.com 并不意味着这些存储库将被删除或停止工作；在您撤销 WordPress.com 的访问权限后，您的存储库仍将存在于 GitHub 上，但 WordPress.com 将不能再部署代码。