教程：使用适用于 Microsoft Power Platform 的 GitHub Actions 自动部署解决方案

在本教程中，您将了解如何：

这些工作流可以从开发环境中自动导出您的应用（作为非托管解决方案），生成生成项目（托管解决方案），然后将应用部署到生产环境中。本教程使用您构建的 ALMLab 解决方案和您在以前的教程中设置的环境。

创建 GitHub 帐户

导航到您的存储库并单击 Settings（设置），然后展开 Secrets（密钥），然后单击 Actions（操作）。
在密码页上，将密码命名为“PowerPlatformSPN”。使用在 Microsoft Entra 中创建的应用程序注册中的客户端密码，将其输入到值字段，然后选择添加密码。此客户端密码将在本实验室后面用于定义 GitHub 工作流的 YML 文件中引用。

客户端密码现在已安全地存储为 GitHub 密码。

单击操作并单击自己设置工作流，或单击建议用于此存储库部分下的简单工作流框中的“配置”。
这将使用基本工作流启动一个新 YAML 文件，以帮助您开始使用 GitHub Actions。
删除预先创建的内容，粘贴 export-and-branch-solution-with-spn-auth.yml 文件中的内容，然后将文件重命名为 ‘export-and-branch-solution’.yml。
使用要从中导出的开发环境的 URL 更新 <ENVIRONMENTURL>（例如：https://poweractionsdev.crm.dynamics.com）。
用您的值更新 <APPID> 和 <TENANT ID>。
- 如果要使用凭据，请粘贴 export-and-branch-solution.yml 文件，而不是粘贴 export-and-branch-solution-with-spn-auth.yml 文件内容。使用您用于连接到环境的用户名更新 <USERNAME>。
小费

如果您不熟悉 GitHub Actions，并且想要了解详情，请查看 https://docs.github.com/en/actions 中的正式文档。
现在您可以提交更改了。选择开始提交，在标题字段中键入创建导出 yml，然后添加说明（可选）。接下来，单击提交新文件。

恭喜，您已经使用以下操作创建了第一个 GitHub 工作流：

我是谁：确保您可以成功连接到要从中导出的环境。
导出解决方案：从开发环境导出解决方案文件。
解压缩解决方案：从服务器导出的解决方案文件是包含合并配置文件的压缩（zip）文件。这些初始文件不适合用于源代码管理，因为它们的结构不便于源代码管理系统正确地对文件进行区分和捕获要提交给源代码管理的更改。您需要“解包”解决方案文件，以使其适合用于源代码管理的存储和处理。
Branch Solution：创建一个新分支来存储导出的解决方案。

接下来，测试工作流是否运行。导航到操作、运行工作流，选择运行工作流。如果您的解决方案名称与“ALMLab”不同，请更改此处的值，但保留其他值不变。
5–10 秒后，工作流将开始，您可以选择正在运行的工作流来监视进度。
工作流完成后，验证是否已创建新分支，并将解决方案解包到 solutions/ALMLab 文件夹。 导航到 Code 选项卡并 展开 branches 下拉列表。
选择操作创建的分支。
验证是否在新分支中创建了 solutions/ALMLab 文件夹，然后创建一个拉取请求来将更改合并到主分支中。单击 Contribute（贡献 ），然后在浮出控件中单击 Open Pull request（打开拉取请求）。
在打开拉取请求屏幕上，根据需要添加标题和说明，然后单击创建拉取请求。
屏幕将更新，并显示新创建的拉取请求。在创建拉取请求时，将会提供确认，以表明我们的分支与主分支没有冲突。此确认意味着更改可自动合并到主分支中。单击 Merge pull request （合并拉取请求），然后单击 Confirm merge（ 确认合并）。或者，单击“删除分支”以清理现已失效的分支。
导航回默认的（主）分支并验证解决方案现在也可用。

在本节中，我们将再创建一个工作流，该工作流：

导航到操作，选择新建工作流。
选择自行设置工作流。
将工作流的标题重命名为“release-solution-to-prod-with-inputs”，从 release-solution-to-prod-with-inputs.yml 文件中复制内容并粘贴到编辑新文件屏幕中。
提交更改。选择开始提交，然后添加标题和说明（可选）。接下来，选择提交新文件。

在本节中，我们将在发布事件上调用可重用工作流。

导航到操作，选择新建工作流。
选择自己设置工作流。
将工作流的标题重命名为“release-action-call”，从 release-action-call.yml 文件中复制内容并粘贴到编辑新文件屏幕中。
在新工作流文件中更新以下变量：
- 使用用于生成托管解决方案的生成环境的 URL 更新 <BUILD_ENVIRONMENT>。例如：https://poweractionsbuild.crm.dynamics.com。
- 使用要在其中进行部署的生产环境的 URL 更新 <PROD_ENVIRONMENT>。例如：https://poweractionsprod.crm.dynamics.com。
- 单击进入本教程之前创建的注册，使用可在 Microsoft Azure 门户的应用注册边栏选项卡中找到的应用程序（客户端）ID 更新 <APP_ID>。
- 单击进入本教程之前创建的注册，使用可在 Microsoft Azure 门户的应用注册边栏选项卡中找到的目录（租户）ID 更新 <TENANT_ID>。
提交更改。选择开始提交，然后添加标题（可选）和说明（可选）。接下来，选择提交新文件。