练习 - 使用适用于 Microsoft Power Platform 的 GitHub Actions

已完成

在本练习中,您将使用适用于 Microsoft Power Platform 的 GitHub Actions,将包含自定义连接器的解决方案导出到 GitHub。

重要提示

使用已预配 Microsoft Dataverse 的测试环境。 如无社区计划,您可以注册社区计划。 还需要 GitHub 帐户来完成练习。 您可在 GitHub.com 免费注册帐户。

注意

将以下文件下载到本地计算机来完成本练习:Contoso Invoicing ALM。 选择屏幕中部右侧的下载按钮。

任务 1:导入解决方案

在本任务中,您将导入包含“Contoso Invoicing”自定义连接器的非托管解决方案。 您将使用本连接器完成本练习中的任务。

  1. 转到 Power Apps Maker Portal 并确保您处于正确的环境中。

  2. 选择解决方案,然后选择导入解决方案

  3. 选择浏览

  4. 选择 ContosoInvoicingALM_1_0_0_0.zip 解决方案,然后选择打开

  5. 选择下一步

  6. 选择导入,然后等待导入完成。 您应在导入完成后收到成功消息。

  7. 选择发布所有自定义项并等待发布完成。

  8. 选择您导入的 Contoso Invoicing - ALM 解决方案。

    您应看到 Contoso Invoicing - ALM 自定义连接器组件。

  9. 选择屏幕右上角的设置图标,然后选择会话详细信息

    显示会话详细信息的屏幕截图。

  10. 在 Power Apps 会话详细信息对话框中选择并复制实例 url值以便稍后在练习中使用。

    显示会话详细信息以及实例 URL 值位置的屏幕截图。

任务 2:创建 GitHub 存储库

请按照以下步骤创建 GitHub 存储库:

  1. 转到 GitHub 并选择创建存储库

  2. 输入存储库名称ContosoInvoiceALM

  3. 选择添加 README 文件

  4. 选择创建存储库

  5. 在新存储库中,选择设置图标。

  6. 展开密码和变量部分并选择操作。 密码是加密的环境变量。 所有拥有本存储库协作者访问权限的人员都可将这些密码用于 GitHub Actions。 您将创建三个密码,确保您创建的操作中不包含敏感信息。

  7. 选择新建存储库密码

  8. 名称字段中输入环境

  9. 密码字段中粘贴您在上一项任务中复制的环境 URL。

    显示添加新操作密码的屏幕截图。

  10. 选择添加密码

  11. 添加另一个密码,名称为用户,并且密码** 中包含用于访问环境的帐户电子邮件

  12. 添加另一个密码,名称为密码,并且密码中包含用于访问环境的帐户密码

  13. 添加密码后,值列表应如以下屏幕截图所示。

    显示添加环境、密码和用户的三项操作的屏幕截图。

  14. 展开操作并选择常规

    显示常规操作链接按钮的屏幕截图。

  15. 向下滚动到工作流权限部分,选择读取和写入权限,然后选择保存

    显示“工作流权限”部分的屏幕截图。

任务 3:创建 GitHub 操作

请按照以下步骤创建 GitHub 操作:

  1. 在存储库导航中选择操作菜单项。

    显示选择操作的屏幕截图。

  2. 选择自行设置工作流选项。

    显示选定“自行设置工作流”的屏幕截图。

  3. 打开提供的 export-and-branch-solution.yml 文件并将内容粘贴到编辑新文件区域中。

    显示粘贴的新操作步骤的屏幕截图。

  4. 您已添加以下四个步骤:1) 测试连接的 Who-am-I 操作,2) 导出解决方案,3) 解包解决方案,4) 创建分支并签入解决方案文件。

    显示以上概述步骤的屏幕截图。

  5. 选择右侧的开始提交,然后选择提交新文件。 本步骤将保存您构建的操作。

    显示开始提交和提交所选新文件操作的屏幕截图。

您的操作已保存并且准备就绪可以运行。

任务 4:运行导出操作

请按照以下步骤运行导出操作:

  1. 转到操作存储库。

    显示选择操作查看列表的屏幕截图。

  2. 选择export-and-branch-solution操作,然后选择运行工作流

    显示选择您创建的操作并选择运行工作流的屏幕截图。

  3. 使用工作流部分中选择分支,然后选择运行工作流

    显示选择运行工作流的屏幕截图。

  4. 监视工作流进度,直至工作流成功完成。

    监视工作流运行进度的屏幕截图。

  5. 在导航中选择代码,然后选择分支

    显示代码选项、分支数和选择分支列表的屏幕截图。

  6. 您应看到 GitHub 操作实施创建的分支。 目前本分支未与主分支合并。 选择新建拉取请求启动合并流程。

    显示为最近创建的分支选择新建拉取请求的屏幕截图。

  7. 在注释区域中输入连接器初始版本

  8. 选择创建拉取请求选项。

  9. 此时通常会有人对拉取请求进行审核并合并,但由于只有您在进行练习,因此您应自行批准拉取请求。

  10. 展开合并拉取请求,然后选择Squash 并合并

    显示选择合并请求的屏幕截图。

  11. 选择Squash 并合并,然后选择确认 Squash 并合并

    分支与更改现已合并。

  12. 选择代码,然后选择solutions/ContosoInvoiciningALM。 本文件夹包含创建的解决方案文件。 您可以浏览本文件夹的内容,确定从解决方案提取的内容并将其存储为单个文件。

    合并后查看存储库内容的屏幕截图。

任务 5:更改和记录连接器定义

请按照以下步骤更改和记录连接器定义:

  1. 转到 Power Apps 制作者门户并确保您处于正确的环境中。

  2. 依次选择解决方案Contoso Invoicing - ALM解决方案。

  3. 选择自定义连接器组件旁边的省略号 (...),然后选择编辑

    显示编辑连接器以进行更改的屏幕截图。

  4. 图标背景色改为#0066ff,然后选择更新连接器

    显示更改颜色后选择更新连接器的屏幕截图。

  5. 重复任务 4中的步骤 1-12 运行工作流、新建拉取请求并将代码合并到主分支中。

  6. 在导航中选择代码,然后选择拉取请求名称打开详细信息。

    拉取请求屏幕截图。

  7. 验证记录的图标颜色从 #007ee5 到 #0066ff 更改。

    显示图标颜色更改差异的屏幕截图。

注意

保存连接器时可以应用其他自动更改,例如图标格式可能会从 JPEG 改为 PNG。

您现在拥有自动化流程,可在源代码管理系统中导出和记录自定义连接器更改。