共用方式為

Azure 開發人員 CLI 和 Azure 部署環境

  • 發行項

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

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

使用 ADE，您可以從連結至開發人員中心目錄的環境定義，或使用 ADE 擴充性模型來執行部署來建立環境。 藉由新增 azd，您可以簡化布建基礎結構和將程式代碼部署至雲端的程式。

azd 如何與 ADE 搭配運作？

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

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

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

了解 azd 範本

Azure Developer 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 資料夾 - infra 資料夾在 azd 中未搭配 ADE 使用。 它包含所有 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 Developer CLI 會使用連結至開發人員中心之目錄中的環境定義來佈建新的環境。

Azure 開發人員 CLI 可與儲存在 Azure 部署環境開發人員中心目錄中的 ARM 範本搭配運作。 它也支援其他 IaC 範本，例如 Bicep 和 Terraform，透過 ADE 擴充性模型。 若要瞭解如何設定 ADE 擴充性模型，請參閱 Azure 部署環境擴充性模型。

為了讓 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 了解如何尋找主機，並將應用程式部署至主機。

若要深入了解如何讓您的 ADE 環境定義與 azd 相容，請參閱讓您的專案與 Azure Developer CLI 相容。

在 ADE 中啟用 azd 支援

若要使用 ADE 啟用 azd 支援，您必須將 platform.type 設定為 devcenter。 此設定允許 azd 針對遠端環境狀態和布建使用新的開發人員中心元件，並表示會忽略範本中的 infra 資料夾。 azd請改用開發人員中心目錄中定義的其中一個基礎結構範本來布建資源。

若要啟用 azd 支援，請執行下列命令：

 azd config set platform.type devcenter

探索 azd 命令

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

相關內容