共用方式為

使用 Azure 開發人員 CLI 建立 Azure DevOps CI/CD 管線

本文說明如何使用 Azure 開發人員 CLI (azd)，透過 Azure DevOps Pipelines (Azure Pipelines) 為 azd 範本建立 CI/CD 管線。 管線可讓您將更新推送至程式代碼存放庫，並讓變更自動布建並部署至 Azure 環境。

備註

命令 azd pipeline config 處於beta中。 如需詳細資訊，請參閱 功能版本控制與發行策略。

先決條件

初始化範本

此範例使用 Hello-AZD 範本，但您可以針對包含管線定義檔案的任何範本執行這些步驟（在 或 .github 資料夾中找到.azdo）。

  1. 在空的目錄中，初始化 hello-azd 範本：

    azd init -t hello-azd

  2. 出現提示時，請輸入環境的名稱（例如 hello-azd）。

設定 Azure Pipelines

備註

如果您在 Windows 上使用適用於 Java 範本的 Azure Pipelines，請參閱 疑難解答指南。

建立或使用 Azure Pipelines 組織

若要使用 Azure Pipelines，您需要組織。 https://dev.azure.com如果您還沒有帳戶，請在 建立一個 。

建立個人存取權杖 （PAT）

Azure 開發人員 CLI 需要個人存取令牌 （PAT） 來設定 Azure Pipelines。 建立新的PAT，使用下列範圍：

  • 代理池（讀取、管理）
  • 編譯（讀取與執行）
  • 程式代碼 （完整）
  • 專案和團隊（讀取、寫入和管理）
  • 發行（讀取、寫入、執行和管理）
  • 服務連線（讀取、查詢和管理）

設定管線

  1. 執行下列命令，以設定 Azure Pipelines 專案及存放庫的部署管線：

    azd pipeline config --provider azdo

    備註

    根據預設， azd pipeline config 針對 Azure Pipelines 會使用客戶端認證。 目前不支援 OIDC/同盟認證。 深入瞭解 OIDC 支援在 azd 中的應用。

  2. 回應提示：

    • 個人存取權杖 (PAT)：

      • 貼上您的 PAT。

      • 或者，將 PAT 匯出為系統環境變數，以避免重複出現提示：

        export AZURE_DEVOPS_EXT_PAT=<PAT>

    • Azure Pipelines 組織名稱：

      • 輸入您的組織名稱。 此值會儲存在目前環境的檔案中 .env 。

    • 找不到名為 「origin」 的遠端。 您要設定一個嗎？

      • 是的

    • 您要如何設定專案？

      • 建立新的 Azure Pipelines 專案

    • 輸入新 Azure Pipelines 項目的名稱，或按 Enter 以使用此名稱：（{預設名稱} ）

      • 選取 Enter，或建立唯一的項目名稱。

    • 您要提交並推送本機變更以啟動已設定的 CI 流程嗎？

      • 是的

  3. 若要確認組建，請移至 Azure Pipelines 入口網站中的專案 （https://dev.azure.com）。

進行並推送程式碼變更

  1. 在 /src/components/pages 目錄中，開啟 Home.razor。

  2. 將 Hello AZD! 標頭文字更改為 Hello, pipeline!，然後儲存檔案。

  3. 建立分支並提交您的變更。 分支 main 受到保護，因此請從新的分支推送變更，並在 Azure Pipelines 中建立提取要求。 拉取請求會觸發管線，並在管線失敗時阻止合併。

  4. 核准並合併提取要求，以再次啟動管線。

    進行變更並提交至測試檔案的步驟螢幕快照。

  5. 在瀏覽器中，打開專案的存放庫，查看您的認可和 Azure Pipeline 的執行。

    測試更新後執行的 GitHub 工作流程螢幕快照。

  6. 請流覽 Web 前端 URL 以檢查更新。

將 azd 用於 Azure Pipelines 任務

新增 azd 為 Azure Pipelines 工作 ，以在您的管線中安裝 azd 。 將下面內容新增至 .azdo/pipelines/azure-dev.yml：

trigger:
  - main
  - branch

pool:
  vmImage: ubuntu-latest
  # vmImage: windows-latest

steps:
  - task: setup-azd@0
    displayName: Install azd

清理資源

當您不再需要本文中建立的 Azure 資源時，請執行：

azd down

後續步驟

使用 Azure 開發人員 CLI 監控您的應用程式 （azd）

  • Last updated on