共用方式為


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

在本文中,您將瞭解如何使用 Azure 開發人員 CLI (azd) 建立範本的 azd GitHub Actions CI/CD 管線。 此管線可讓您將範本更新推送至程式代碼存放庫,並讓變更自動布建並部署至 Azure 環境。

Note

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

Prerequisites

初始化範本

此範例使用 Hello-AZD 範本,但您可以針對包含管線定義檔案的任何 azd 範本執行這些步驟(通常位於 .github.azdo 資料夾中)。

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

    azd init -t hello-azd
    
  2. 出現提示時,請輸入環境的名稱,例如 helloazd

使用 GitHub Actions 建立管線

請遵循下列步驟來建立及設定管線:

  1. 在範本根目錄的終端機中,執行:

    azd pipeline config
    
  2. 當系統提示您選取提供者時,請選擇 [GitHub]。

    ? Select a provider:  [Use arrows to move, type to filter]
    > GitHub
      Azure DevOps
    
  3. 選取您想要的 Azure 訂用帳戶和區域。

  4. 當系統提示您設定遠端存放庫時,請選擇 [建立新的私人 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
    
  5. 輸入新存放庫的名稱。

  6. 當系統提示您提交並推送本地變更以開始新的 GitHub Actions 執行時,請輸入 y

  7. 檢閱終端機中的輸出。 此命令 azd pipeline config 會顯示專案的 GitHub 存放庫名稱。

    Note

    根據預設, azd pipeline config 會設定 OpenID Connect (OIDC),也稱為 同盟認證 。 若要改用客戶端認證,請執行 azd pipeline config --auth-type client-credentials

    Terraform 不支援 OIDC/同盟認證。

    深入瞭解 OIDC 支援在 azd 中的應用。

  8. 在您的瀏覽器中,開啟專案的 GitHub 存放庫。

  9. 選擇 [動作] 以查看工作流程正在運行。

    執行 GitHub 工作流程的螢幕快照。

使用程式代碼變更測試管線

  1. 在項目的 /src/components/pages 目錄中,開啟 Home.razor

  2. 在檔案頂端附近找出 Hello AZD! 的標頭文字。

  3. 將文字變更為 Hello, pipeline!

  4. 儲存檔案。

  5. 提交並推送您的變更。 此動作會觸發 GitHub Actions 管線來部署更新。

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

  6. 在瀏覽器中,開啟專案的 GitHub 存放庫,以查看:

    • Your commit
    • 來自 GitHub Actions 設定的提交

    GitHub 中已認可變更的螢幕快照。

  7. 選取 [動作 ] 以查看工作流程中反映的測試更新。

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

  8. 若要檢視已部署的更新,請瀏覽輸出中 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 資源。

Next steps