建立 Azure 開發人員 CLI 樣本概觀

Azure 開發人員 CLI （azd） 會 利用範本 將應用程式資源布建和部署至雲端。 開發人員可以藉由將命令和功能轉換成範本，來新增對命令和功能的支援 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 動作支援 CI/CD 管線。

範本建立工作流程

azd init命令可用來初始化azd範本，以在 Azure 上佈建和部署應用程式資源。 命令會提示您選擇兩個不同的工作流程，以初始化下列各節中所述的範本 - 使用目前目錄中 的程式代碼和使用 現有的範本。

azd init在您要轉換成 azd template的目錄根目錄中執行 命令：

azd init

在目前目錄中使用程序代碼

此選項會 azd 指示分析目錄中的程式碼，以識別其所使用的技術，例如程式設計語言、架構和資料庫系統。 azd 會自動為您產生範本資產，例如 azure.yaml 服務定義檔，以及 infra 具有基礎結構即程式代碼檔案的資料夾。 產生的資產是其他修改的起點。 如果您打算使用 Scaffolding 功能支援的 azd 一般 Azure 服務，請使用此方法。

如需如何實作此方法的詳細資訊，以及 Azure 資源支援自動偵測和 Scaffolding 的詳細資訊，請瀏覽開始使用您的應用程式程式碼來建立範本教學課程。

選取範本

選取此選項，即可使用現有的範本，將許多 Azure 資源和架構目標定義為起點。 azd 將會提示您從 awesome-azd 資源庫選取入門範本或其他範本。 當您選取範本時，該範本的資產會新增至現有的項目目錄，以作為起點。 有些範本包含您可以自行取代的範例應用程式程序代碼，而某些範本（稱為「入門範本」）則只是基礎結構。

azd init使用 命令，將現有的範本向下拉到空的目錄，並將其作為您自己的應用程式的起點。 如果範本包含應用程式原始程式碼，您可以建置該程式代碼，或將原始程式碼目錄取代為您自己的程式代碼。

如需如何實作此方法的詳細資訊，請瀏覽開始使用現有的範本教學課程。

另請參閱

• 針對您的應用程式使用現有的範本。
• 從您的應用程式程式代碼建立範本

要求說明

如需如何提出 Bug、要求協助或為 Azure 開發人員 CLI 提出新功能的資訊，請流覽 疑難解答和支援 頁面。

下一步

Azure Developer CLI 常見問題