教學：透過使用 GitHub Actions for Microsoft Power Platform 自動化解決方案部署

在這個教學中，你會學到如何：

工作流程可以從開發環境自動匯出應用程式 (作為非受管理的解決方案)、生成建置成品 (受管理的解決方案)，並將應用程式部署至生產環境中。本教學課程會使用您組建的 ALMLab 解決方案，以及您在先前教程中設定的環境。

建立一個 GitHub 帳號

移至您的存放庫，然後選取 [ 設定]。展開 Secrets，然後選取操作。
在祕密頁面，請將祕密命名為 PowerPlatformSPN。在 Microsoft Entra 中建立的應用程式註冊中，將客戶端密碼輸入到 Value 欄位，然後選擇 新增秘密。你會在本教學稍後，於定義 GitHub 工作流程的 YML 檔案中引用 client secret。

現在，用戶端密碼會安全地儲存為 GitHub secret。

選擇「動作」，然後選擇「自己設定工作流程」。或者，在「建議此儲存庫」區塊的簡單工作流程框中選擇配置。
你會看到一個新的 YAML 檔案，裡面有基本工作流程，幫助你開始使用 GitHub Actions。
刪除預先建立的內容，然後將 export-and-branch-solution-with-spn-auth.yml 檔案中的內容貼上。將檔案重新命名為 export-and-branch-solution.yml.
將 <ENVIRONMENTURL> 更新為您要從中匯出之開發環境的 URL (例如：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 的官方文件。
你現在已準備好提交變更。選擇 Start commit，在標題欄位中輸入Create export yml，然後新增說明 (可選)。接下來，選擇提交新檔案。

恭喜你，透過以下操作建立了你的第一個 GitHub 工作流程：

Who Am I：確保你能成功連接到想要輸出的環境。
匯出解決方案：從開發環境匯出解決方案檔。
解包方案：伺服器匯出的方案檔案是一個壓縮（zip）檔案，並整合了設定檔。這些初始檔案不適合用於原始碼管理，因為其結構方式使原始碼管理系統難以正確地對檔案進行差異比對並擷取你想提交給原始碼控制的變更。你需要將方案檔案解包，使其適合用於原始碼控制的儲存與處理。
分支方案：建立一個新分支來儲存匯出的方案。

接下來，測試工作流程是否會執行。到動作，選擇 執行工作流程，然後選擇 執行工作流程。如果您使用的解決方案名稱與 ALMLab 不同，請在此更改值，但其他值則保持不變。
5到10秒後，工作流程開始。你可以選擇正在運行的工作流程來監控進度。
工作流程結束後，檢查是否建立了新的分支，並將解決方案解包到 solutions/ALMLab 資料夾中。 到 程式碼 標籤 並 展開分支下拉選單。
選擇該動作所建立的分支。
檢查新分支中是否已建立 solutions/ALMLab 資料夾。接著，建立一個 Pull Request，將變更合併到主分支。選擇 「貢獻 」，在飛出視窗中選擇 「開啟拉取請求」。
在 「開啟拉取請求」 畫面，如果你願意，可以新增標題和描述，然後選擇 「建立拉取請求」。
畫面更新顯示新的提取要求。當你建立 pull request 時，你會得到確認你的分支與主分支沒有衝突。這個確認表示你可以自動將變更合併到主分支。選擇 合併提取要求，然後選擇 確認合併。可選擇刪除分支以移除已失效的分支。
回到預設（主）分支，檢查解決方案是否可用。

在本節中，建立一個額外的工作流程：

到操作區，選擇 新工作流程。
選擇 自己建立工作流程。
將工作流程的標題改為 release-solution-to-prod-with-inputs。從 release-solution-to-prod-with-inputs.yml 檔案複製內容，貼到 編輯新檔案 畫面。
提交變更。選擇開始提交，然後新增標題和說明 (選用)。接下來，選擇提交新檔案。

在這個區段，你會在發佈事件時呼叫可重用的工作流程。

到操作區，選擇 新工作流程。
選擇自行設定工作流程。
將工作流程的標題改為 release-action-call。從 release-action-call.yml 檔案複製內容，貼到 編輯新檔案 畫面。
在新工作流程檔案中，更新下列變數：
- 更新 <BUILD_ENVIRONMENT> 為你用來產生受管理解決方案的建置環境的網址。例如：https://poweractionsbuild.crm.dynamics.com。
- 將 <PROD_ENVIRONMENT> 更新為你要部署到的生產環境網址。例如：https://poweractionsprod.crm.dynamics.com。
- 請使用你在本教學中先前建立的註冊（可在 Microsoft Azure 入口網站的應用程式註冊刀鋒視窗中選取）裡找到的應用程式（用戶端）ID 來更新 <APP_ID>。
- 請使用你在 Microsoft Azure 入口網站應用程式註冊刀片中，選取你在本教學中先前建立的註冊後所找到的目錄（租戶）ID 來更新 <TENANT_ID>。
提交變更。選擇開始提交，然後新增標題 (選用) 和說明 (選用)。接下來，選擇提交新檔案。