Azure 開發者 CLI（azd）利用範本來配置並將應用程式資源部署到雲端。 開發者可以透過將應用程式轉換成範本來新增指令 azd 與功能支援。 本文提供有關建立 azd 範本的不同選項的背景概述。 一旦你理解本文中的概念，請造訪以下資源以獲得更詳細的實作指南：
備註
本文假設對範本有一般的理解 azd 。 想了解更多範本資訊，請造訪 範本概覽 文件。
範本建立概念
建立 azd 範本需要在現有程式碼庫中加入特定的設定和基礎架構資產，或者從包含相同資產的現有範本啟動一個新的應用程式。 這兩種工作流程會在後面章節中說明。 所有 azd 範本都共享基於 azd 慣例的相似檔案結構。 以下圖表簡要說明了建立 azd 範本的流程：
每個 azd 範本都需要以下最低資源：
- 一個
infra資料夾，儲存基礎設施即程式碼（Bicep或Terraform）檔案。 - 一個
azure.yaml設定檔，將你的應用服務映射到已配置的基礎設施資源。
其他可選的目錄通常也包含，例如 .github 資源資料夾，用於建立 CI/CD 管線。 想了解更多範本資訊，請造訪 範本概覽 文件。
請參考以下範例應用程式庫：
將此範例應用程式 azd 轉換為範本後，同一應用程式倉庫包含以下內容：
原始應用程式資源未變，但新增了一些 azd 依賴於之命令（例如 azd up）的資產。
- 新增了一個
infra資料夾，內含Bicep檔案以建立Azure資源。 - 新增了一個
azure.yaml設定檔，將src目錄中的應用程式程式碼映射到資源配置Azure。 - 建立了一個
.azure資料夾來存放azd環境變數。 - 新增了一個
.github資料夾（可選），以支援透過 GitHub Actions 進行 CI/CD 流水線。
範本建立工作流程
azd init 指令用於初始化一個 azd 範本，用於在 Azure 上配置與部署應用程式資源。 命令提示你在兩種不同的工作流程中選擇來初始化範本，具體說明如下： 使用目前目錄中的程式碼 與 使用現有範本。
在要轉換成 azd template 的目錄根目錄中執行 azd init 命令：
azd init
使用目前目錄中的程式碼
此選項指示 azd 分析目錄中的程式碼，以辨識其使用的技術，例如程式語言、框架與資料庫系統。
azd 自動為你產生範本資產，例如 azure.yaml 服務定義檔案和包含基礎設施即程式碼檔案的 infra 資料夾。 生成的資產是後續修改的起點。 如果你打算使用由 azd 鷹架功能支援的常見Azure服務，請使用此方法。
請參閱教學課程從您的應用程式程式碼開始來建立範本，以了解如何實施此方法，以及哪些 Azure 資源支持自動偵測和生成模板。
選取範本
選擇此選項，使用定義許多 Azure 資源與架構目標的現有範本作為起點。
azd 會提示你選擇一個入門範本或從 Awesome-azd 圖庫中選其他範本。 當你選擇範本時，該範本的資產會被加入你現有的專案目錄，作為起點。 有些範本包含範例應用程式程式碼，你可以用自己的替換，而有些（稱為「起始範本」）僅供基礎設施使用。
用指令 azd init 把現有範本拉到空目錄，然後用它作為你自己應用程式的起點。 如果範本包含應用程式原始碼，你可以從該程式碼基礎上建立，或用自己的原始碼目錄取代原始碼目錄。
請參考「 開始與現有範本 」教學，了解如何實作此方法。
另請參閱
請求幫助
如需了解如何提出錯誤、請求協助或建議Azure開發者 CLI 新功能，請造訪 troubleshooting and support 頁面。