在本文中,您將瞭解如何使用 Azure 開發人員 CLI (azd) 建立範本的 azd GitHub Actions CI/CD 管線。 此管線可讓您將範本更新推送至程式代碼存放庫,並讓變更自動布建並部署至 Azure 環境。
Note
命令 azd pipeline config 處於beta中。 如需詳細資訊,請參閱 功能版本控制與發行策略。
Prerequisites
- 安裝 Azure 開發人員 CLI
- Visual Studio Code (選擇性,用於編輯檔案)
- GitHub 帳戶
- Azure 訂用帳戶
初始化範本
此範例使用 Hello-AZD 範本,但您可以針對包含管線定義檔案的任何 azd 範本執行這些步驟(通常位於 .github 或 .azdo 資料夾中)。
在空的目錄中,初始化
hello-azd範本:azd init -t hello-azd出現提示時,請輸入環境的名稱,例如 helloazd。
使用 GitHub Actions 建立管線
請遵循下列步驟來建立及設定管線:
在範本根目錄的終端機中,執行:
azd pipeline config當系統提示您選取提供者時,請選擇 [GitHub]。
? Select a provider: [Use arrows to move, type to filter] > GitHub Azure DevOps選取您想要的 Azure 訂用帳戶和區域。
當系統提示您設定遠端存放庫時,請選擇 [建立新的私人 GitHub 存放庫]。 如果您有想要使用的現有專案,您也可以選擇 [ 選取現有的 GitHub 專案]。
? How would you like to configure your git remote to GitHub? [Use arrows to move, type to filter] Select an existing GitHub project > Create a new private GitHub repository Enter a remote URL directly輸入新存放庫的名稱。
當系統提示您提交並推送本地變更以開始新的 GitHub Actions 執行時,請輸入
y。檢閱終端機中的輸出。 此命令
azd pipeline config會顯示專案的 GitHub 存放庫名稱。Note
根據預設,
azd pipeline config會設定 OpenID Connect (OIDC),也稱為 同盟認證 。 若要改用客戶端認證,請執行azd pipeline config --auth-type client-credentials。Terraform 不支援 OIDC/同盟認證。
在您的瀏覽器中,開啟專案的 GitHub 存放庫。
選擇 [動作] 以查看工作流程正在運行。
使用程式代碼變更測試管線
在項目的
/src/components/pages目錄中,開啟Home.razor。在檔案頂端附近找出
Hello AZD!的標頭文字。將文字變更為
Hello, pipeline!。儲存檔案。
提交並推送您的變更。 此動作會觸發 GitHub Actions 管線來部署更新。
在瀏覽器中,開啟專案的 GitHub 存放庫,以查看:
- Your commit
- 來自 GitHub Actions 設定的提交
選取 [動作 ] 以查看工作流程中反映的測試更新。
若要檢視已部署的更新,請瀏覽輸出中
azd提供的 Web 前端 URL。
以 GitHub 動作的形式使用azd
您可以將 azd 安裝為 GitHub Action,使用 setup-azd 操作。 若要使用它,請將下列內容新增至您的 .github/workflows/azure-dev.yml 檔案:
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Install azd
uses: Azure/setup-azd@v1.0.0
Note
查看 setup-azd 發行版本 以確認最新版本號碼。
清理資源
當您不再需要本文中建立的 Azure 資源時,請執行下列命令:
azd down
此命令會移除與專案相關聯的所有 Azure 資源。