共用方式為


搭配 Azure 部署環境使用 Azure 開發人員 CLI

在本文中,您將瞭解 Azure 開發人員 CLI (azd) 及其如何與 Azure 部署環境 (ADE) 搭配運作,以布建應用程式基礎結構,並將應用程式程式代碼部署至新的基礎結構。

Azure 開發人員 CLI (azd) 是開放原始碼命令行工具,可提供可對應至工作流程中關鍵階段的開發人員易記命令。 您可以在本機電腦上安裝 azd ,或在其他環境中使用它。

使用 ADE,您可以從連結至開發人員中心之目錄中的環境定義建立環境。 藉由新增 azd,您可以將應用程式程式代碼部署到新的基礎結構。

如何使用 azd ADE?

azd 與 ADE 搭配使用,可讓您從工作所在的位置建立環境。

使用 ADE 和 azd,個別開發人員可以使用想要上傳至雲端的獨特基礎結構和程式代碼,從本機資料夾建立環境。 他們可用來 azd 布建環境,並順暢地部署其程序代碼。

大規模使用 ADE 和 azd 一起可讓您為開發人員提供建立應用程式基礎結構和程式代碼的方式。 您的小組可以從相同的 azd 相容環境定義建立多個 ADE 環境,並以一致的方式將程式代碼布建至雲端。

了解 azd 範本

Azure 開發人員 CLI 命令是設計來使用標準化的範本。 每個範本都是遵守特定檔案和資料夾慣例的程式碼存放庫。 範本包含布建 Azure 部署環境環境所需的資產 azd 。 當您執行之類的 azd up命令時,此工具會使用範本資產來執行各種工作流程步驟,例如布建或部署資源至 Azure。

以下是典型的範本結構:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

所有 azd 範本都包括以下資產:

  • infra 資料夾 - 未搭配 ADE 使用 azd infra 資料夾。 它包含所有 Bicep 或 Terraform 基礎結構作為 azd 範本的程式代碼檔案。 ADE 提供基礎結構作為範本的程式 azd 代碼檔案。 您不需要在範本中包含 azd 這些檔案。

  • azure.yaml 檔案 - 組態檔 ,定義專案中的一或多個服務,並將其對應至 Azure 資源以進行部署。 例如,您可以定義 API 服務和 Web 前端服務,每個服務都具有將其對應至不同 Azure 資源以進行部署的屬性。

  • .azure 資料夾 - 包含基本的 Azure 組態和環境變數,例如部署資源的位置或其他訂用帳戶資訊。

  • src 資料夾 - 包含所有可部署的應用程式原始程式碼。 某些 azd 範本只會提供基礎結構資產,並將 src 目錄保留空白,讓您新增自己的應用程式程式代碼。

大多數 azd 範本還可以選擇性包括以下一個或多個資料夾:

  • .devcontainer 資料夾 - 可讓您為應用程式設定開發容器環境。 這是非 azd 專屬的常見開發環境方法。

  • .github 資料夾 - 保存 GitHub Actions 的 CI/CD 工作流程檔案,這是 azd 的預設 CI/CD 提供者。

  • .azdo 資料夾 - 如果您決定使用適用於 CI/CD 的 Azure Pipelines,請在此資料夾中定義工作流程組態檔。

azd 相容的目錄

Azure 部署環境目錄包含環境定義:IaC 範本,可定義為部署環境布建的基礎結構資源。 Azure 開發人員 CLI 會使用連結至開發人員中心之目錄中的環境定義來布建新的環境。

注意

目前 Azure Developer CLI 可搭配儲存在 Azure 部署環境開發人員中心目錄的 ARM 範本。

為了讓 Azure Developer CLI 妥善支援特定 Azure 計算服務,IaC 範本必須進行更多組態設定。 例如,您必須以特定資訊標記應用程式服務主機, azd 以便知道如何尋找主機,並將應用程式部署至它們。

如需支援的 Azure服務清單,請參閱:支援的 Azure 計算服務 (主機)

讓您的 ADE 目錄與 azd

若要讓您的開發小組 azd 使用 ADE,您必須在目錄中建立與 azd相容的環境定義。 您可以建立新的 azd相容環境定義,或是從 Azure 部署環境開發人員中心目錄使用現有的環境定義。 如果您選擇使用現有的環境定義,則需要進行一些變更,使其與 azd相容。

變更包括:

  • 如果您要修改現有的 azd 範本,請移除 infra 資料夾。 ADE 會使用下列檔案來建立基礎結構:
    • ARM 樣本 (azuredeploy.json.)
    • 定義參數的組態檔 (environment.yaml 或 manifest.yaml)
  • 使用特定資訊標記 azure.yaml 中的資源,azd以瞭解如何尋找主機,並將應用程式部署至它們。
  • 設定開發人員中心設定,例如環境變數、 azd 環境設定、 azd 專案組態和用戶設定。

若要深入瞭解如何讓您的 ADE 環境定義與 azd相容,請參閱 讓您的專案與 Azure 開發人員 CLI 相容。

在 ADE 中啟用 azd 支援

若要啟用 azd ADE 的支援,您必須將 設定 platform.type 為 devcenter。 此設定可讓您 azd 利用新的開發人員中心元件進行遠端環境狀態和布建,並表示會有效地忽略範本中的 infra 資料夾。 相反地, azd 將會使用您開發人員中心目錄中定義的其中一個基礎結構範本來布建資源。

若要啟用 azd 支援,請執行下列命令:

 azd config set platform.type devcenter

探索 azd 命令

啟用開發人員中心功能時,某些常見 azd 命令的預設行為會變更以使用這些遠端環境。 如需詳細資訊,請參閱 使用 Azure 部署環境