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