Azure 開發人員 CLI （azd） 範本是一般程式代碼存放庫，其中包含範例應用程式程式代碼，以及 azd 組態和基礎結構檔案。
azd 範本可讓您布建 Azure 資源、部署應用程式、設定 CI/CD 管線等等。 您可以建立自己的範本，或從範本存放庫開始使用現有的範本，例如 Awesome AZD。 在本文中，您將瞭解下列概念：
- 範本如何
azd讓您配置和部署應用程式資源 -
azd範本的結構方式 - 如何決定要使用現有的範本或建立範本
- 探索現有的
azd入門範本
為何要使用 Azure 開發人員 CLI 範本？
針對雲端建置正確架構和設定的環境感知應用程式時，開發人員通常會面臨許多耗時且具挑戰性的工作。 團隊在這些環境中需要處理許多不同的問題，例如資源的建立、套用設定、設定監控與記錄、建置 CI/CD 管線和其他工作。
azd 範本可減少並簡化這些責任，以協助開發人員從本機開發到 Azure 上成功部署的應用程式。
例如，假設您在經營票證管理和客戶通訊平臺的公司工作，這需要下列 Azure 資源：
- 兩個 App Service 實例和 App Service 方案可裝載前端 Web 應用程式和後端 API
- 一個金鑰保管庫實例，用來安全地儲存應用程式的密碼。
- 一個 Cosmos DB 資料庫用來永久儲存應用程式資料
- Azure 監視器資源，例如 Application Insights 儀表板
- 一個服務匯流排用來管理可調整的傳訊
- CI/CD 流程，以確保可以透過自動化且可重複的過程可靠地部署變更。
您可以利用現有的架構範本來布建和部署大部分資源， azd 而不是從頭開始。 然後，開發小組可以專注於建置應用程式，並針對範本架構進行較小的調整。
Azure 開發人員 CLI 範本的運作方式
Azure 開發人員 CLI 範本的設計目的是使用 azd 和 azd init等azd up命令。 範本包含組態和基礎結構即程式代碼 （IaC） 檔案，這些檔案可供命令用來執行工作，例如布建 Azure 資源，並將應用程式程式代碼部署至它們。
例如，使用現有範本的一般 azd 工作流程包含下列步驟：
執行
azd init命令並使用--template參數，從 GitHub 克隆現有的範本。azd init --template todo-nodejs-mongoazd auth login執行 命令來向 Azure 訂用帳戶進行驗證。azd auth login執行
azd up命令以佈建和部署範本資源至 Azure。azd up命令會利用範本中的組態和基礎結構即程式代碼 （IaC） 檔案來布建 Azure 資源，並將您的應用程式部署至這些資源。azd up在 Azure 中設定環境之後，您可以在本機修改應用程式功能或 Azure 資源範本，然後再次執行
azd up以布建變更。
探索 Azure 開發人員 CLI 樣本結構
azd 範本是包含一些額外資產的標準程式代碼存放庫。 所有 azd 範本都會根據 azd 慣例共用類似的檔案結構：
-
infrafolder - 包含所有與azd範本相關的 Bicep 或 Terraform 基礎架構程式代碼檔案。azd會執行這些檔案，以建立裝載應用程式所需的 Azure 資源。 -
azure.yamlfile - 組態檔，會將專案中的原始程式碼資料夾對應至部署資料夾中定義的infraAzure 資源。 例如，您可以在不同的資料夾中定義 API 服務和 Web 前端服務，並將其對應至不同的 Azure 資源以進行部署。 -
.azure資料夾 - 包含基本的 Azure 組態和環境變數，例如部署資源的位置或其他訂用帳戶資訊。 -
srcfolder - 包含所有可部署的應用程式原始程式碼。 有些azd範本會src排除資料夾，而且只提供基礎結構資產，以便您可以新增自己的應用程式程序代碼。
例如，常見的 azd 範本可能會符合下列資料夾結構：
azd 範本也可以選擇性地包含下列一或多個資料夾：
-
.github資料夾 - 保存 GitHub Actions 的 CI/CD 工作流程檔案，這是 azd 的預設 CI/CD 提供者。 -
.azdo資料夾 - 如果您決定使用適用於 CI/CD 的 Azure Pipelines，請在此資料夾中定義工作流程組態檔。 -
.devcontainer資料夾 - 可讓您為應用程式設定 開發容器 環境。
從現有的範本開始，或建立您自己的範本
與模板互動有兩個主要方法 azd ：
-
從現有的
azd範本開始。- 如果您剛開始使用
azd或正在尋找範本來建置具有類似架構和框架的新應用程式，這是一個很好的選擇。
- 如果您剛開始使用
-
將現有的項目轉換為
azd範本。- 當您已經有現有的應用程式，但想要讓它與
azd功能相容時，這是一個很好的選擇。
- 當您已經有現有的應用程式，但想要讓它與
下列各節提供這兩個選項的詳細資訊。
從現有的範本開始
azd 樣本資源庫上提供廣泛的範本選擇。 這些範本提供各種開發案例、語言架構和 Azure 服務的基礎結構和應用程式程式代碼。 如果您找到符合本機應用程式堆疊或所需架構的範本，您可以擴充範本程式碼，並將範本程式碼取代為您自己的
例如，下列 azd 範本提供常見應用程式架構和架構的起點：
為您的應用程式建立新的 azd 範本
您也可以將現有的應用程式 azd 轉換成範本，以使用布建和部署功能來增強存放庫。 這個方法可讓您控制最多，併產生可重複使用的解決方案，以供應用程式的未來開發工作使用。 建立您自己的範本的高階步驟如下：
- 使用
azd init初始化項目範本。 - 在
infra資料夾中建立 Bicep 或 Terraform 作為基礎結構的程式代碼檔案。 - 更新檔案
azure.yaml，以將應用程式服務與 Azure 資源系結在一起。 - 佈建與部署
azd up。
下列資源提供有關建立您自己的範本的詳細資訊：
使用 azd 範本的指導方針
請注意，您與 Azure Developer CLI 搭配使用的每個範本均由其各自的擁有者根據範本附帶的協議授權，該擁有者可能或可能不是 Microsoft。 您必須負責判斷您選擇使用的任何範本適用的授權。
Microsoft不負責任何非Microsoft範本，也不會篩選這些範本的安全性、隱私權、相容性或效能問題。 您搭配 Azure 開發人員 CLI 使用的範本，包括Microsoft所提供的範本，不受任何Microsoft支援計劃或服務支援。 任何Microsoft提供的範本都提供 AS IS，沒有任何擔保。