搭配 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
以瞭解如何尋找主機,並將應用程式部署至它們。- 瞭解為 Azure 部署環境標記資源。
- 瞭解 Azure 開發人員 CLI 的 azure.yaml 架構。
- 設定開發人員中心設定,例如環境變數、
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 部署環境。
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應