Azure 開發人員 CLI (azd) 撰寫功能可簡化建置、部署和管理雲端應用程式的程式。 您可以使用 azd compose,以統一的方式定義和管理專案的基礎結構和應用程式程式碼。 本指南說明如何從 azd compose 功能產生 Bicep 程式代碼,讓您自定義雲端基礎結構以符合您的特定需求。
如何 azd compose 管理基礎結構狀態
在組合過程中,azd compose 功能會在記憶體中追蹤您的基礎結構狀態。 這種方法可讓您反覆定義和精簡您的應用程式和基礎結構,而不需要立即產生檔案或修改您的項目目錄。
當您執行 azd infra synth 命令時,記憶體內部狀態會轉換成資料夾中的 infra Bicep 檔案。 此時,基礎結構狀態會從受管理的記憶體內部轉換成以程式代碼表示,以便進一步自定義。
小提示
在將檔案型變更提交到azd compose之前,使用azd infra synth快速建立您的基礎結構原型。
產生 Bicep 程式代碼
若要探索或自定義 azd 內部用以布建 azd add 所建立的資源的 Bicep 程式代碼,請執行下列命令:
azd infra gen
備註
azd infra synth舊版 的azd命令現在是 azd infra generate的別名,而且將繼續運作。 不過,將會顯示警告訊息,而且在未來 azd 版本中可能會移除命令。
此命令會在應用程式的 infra 資料夾中產生對應的 Bicep 檔案。
使用 Bicep 產生來管理更新
當您執行 azd infra gen 命令時,您會結束 azd compose 工作流程和簡化的 init 程式。 從此開始,您對產生的 Bicep 檔案所做的任何變更都不再由 azd compose追蹤。 如果您修改 Bicep 檔案,稍後再次執行 azd infra gen ,則新產生的程式代碼將會覆寫您的手動變更。
以下是一般工作流程的外觀:
- 您可以使用
azd add將新的 Azure 資源新增至專案。 這些資源是由azd內部管理。 - 完成新增資源之後,您會執行
azd infra gen來為專案infra資料夾中的資源產生 Bicep 檔案。 在這個階段,資源不再由azd compose工作流程管理。 - 您現在可以在繼續開發應用程式時手動更新 Bicep 檔案。
- 如果您新增更多資源或再次執行
azd infra gen,則會重新產生資料夾的內容infra,而且將會遺失任何手動變更。
基於這個理由,撰寫功能最適合下列案例:
- 為您的專案建立一組初始的 Azure 資源,然後編輯 Bicep 檔案,自行管理進一步更新。
- 完全透過撰寫功能管理 Azure 資源,而不執行
azd infra gen。