Azure 開發人員 CLI (azd
)透過azd pipeline config
命令來簡化 CI/CD 設定。 此命令會使用範本中包含的 azd
管線定義檔案,為 Azure 上的應用程式資源自動布建和部署管線。 藉由整合範本和管線, azd
可讓您順暢地使用 CI/CD 體驗,讓您專注於開發,同時確保一致且可靠的部署。
管線功能
當您執行 azd pipeline config
命令時, azd
請執行下列步驟來設定 CI/CD 管線:
- 使用 Azure 進行驗證:確認您已登入並具有必要許可權。
- 選取 CI/CD 平臺:提示您選擇 GitHub Actions 或 Azure Pipelines。
- 設定存放庫:引導您連線或建立存放庫。
- 設定服務主體:自動建立及設定服務主體以進行安全部署。
-
設定驗證:
- 針對 GitHub:設定 OpenID Connect (OIDC) 或客戶端認證。
- 針對 Azure Pipelines:設定客戶端認證並要求個人存取令牌 (PAT)。
-
布建管線檔案:將適當的管線定義檔案 (
azure-dev.yml
) 從範本複製到您的存放庫。 - 設定管線變數和秘密:設定部署所需的變數和秘密。
- 認可和推送變更:認可並推送管線組態至您的存放庫。
- 觸發管線執行:建立或更新 Azure 資源,並部署應用程式。
平臺特定詳情
此命令 azd pipeline config
同時支援 GitHub Actions 和 Azure Pipelines,每個都有獨特的考慮:
GitHub Actions:
- 可處理托管於 GitHub 的儲存庫。
- 使用
.github/workflows
組態檔的azure-dev.yml
目錄。 - 根據預設,支援 OpenID Connect (OIDC) 進行安全驗證。
- 可以使用客戶端認證作為替代驗證方法。
Azure Pipelines:
- 使用 Azure Pipelines 託管的儲存庫。
- 使用
.azuredevops/pipelines
或.azdo/pipelines
目錄來放置azure-dev.yml
組態檔案。 - 使用客戶端認證進行驗證(目前不支援 OIDC)。
- 需要具有特定範圍的「個人存取令牌」(PAT)。
- 透過提取要求工作流程支援受保護的主要分支。
範本整合
Azure 開發人員 CLI 樣本可以包含預先設定的 CI/CD 管線定義檔案 (azure-dev.yml
) 與 azd pipeline config
命令相容。 當您複製範本時,您可以立即執行 azd pipeline config
來設定 CI/CD 管線,而不需要從頭開始建立組態檔。
範本也可以透過 azure.yaml
檔案包含具有更多變數、秘密和環境特定設定的自定義管線組態,讓您輕鬆地調整管線以符合不同的專案需求。
範例工作流程
使用 azd pipeline config
的典型工作流程包括:
- 將所需的
azd
範本存放庫複製到本機計算機。 -
azd pipeline config
執行 命令並遵循提示來設定管線。 初始運行條款需要 Azure 資源,並觸發工作流程以部署您的應用程式。 - 建立管線之後,認可並將任何變更推送至存放庫,以觸發部署管線並更新您的應用程式。
- 在 CI/CD 平台上監控管線執行,以確保成功部署或排除問題。
探索每個平台的詳細工作流程:
瞭解如何建立您自己的管線定義檔案,或探索進階組態: