從新的 Azure Developer CLI (azd) 範本開始

你可以用不同的創作方法，在新的 Azure Developer CLI （azd） 範本中建立標準檔案：

  • 在 azd init 中使用 GitHub Copilot 整合功能。 內建工作流程會分析現有專案檔案或協助規劃新專案、建立範本資產，並執行部署前驗證。
  • 使用另一個 AI 程式助理。 請要求助理建立相同的 azure.yaml、基礎架構即程式碼、應用程式及支援檔案，但不要直接與 azd init 整合。
  • 直接撰寫檔案。 當你想要完全控制或不想用 AI 編碼助理時，可以自己建立和編輯範本素材。

本文主要著重於內建的 GitHub Copilot 工作流程，因為它提供與 azd 整合的引導式體驗。 不論用哪種撰寫方式，部署前都要審查並驗證每個檔案。

Important

azd init 中的 GitHub Copilot 整合功能目前為預覽版。 預覽功能在正式上市前可能會有所變動。 欲了解更多資訊，請參閱 azd 功能版本與發布策略。

產生的素材是標準且可 azd 編輯的範本檔案。 初始化後，你可以直接更新，或用任何 AI 程式助理。

GitHub Copilot 的先決條件

要使用內建的 Copilot 工作流程，你需要：

  • Azure Developer CLI 1.23.11 或更後版本。
  • 有效的 GitHub Copilot 訂閱。
  • Git，azd init 會在修改檔案前使用它來檢查工作樹。
  • 一個互動式終端機會議。

如果你還沒用 GitHub Copilot 認證，系統azd會提示你登入。

執行azd version以檢查已安裝的 Azure Developer CLI 版本。

Note

這個工作流程會在azd init終端機啟動一個專用的 GitHub Copilot Agent 會話。 它不會使用或持續在 Visual Studio Code 中進行的 GitHub Copilot Chat 會話。

使用 GitHub Copilot 建置

  1. 在你想建立範本的目錄中開啟一個終端機。

    Note

    目錄可以包含現有應用程式、基礎架構專案，或是新解決方案的初始檔案。 如果目錄中有未提交的變更，會 azd 請你確認後再繼續。 先提交或暫存重要的變更。

  2. 執行 azd init：

    azd init

  3. 選擇使用 GitHub Copilot （Preview） 設定。

    初始化提示符類似以下範例：

    ? How do you want to initialize your app?
   Scan current directory
   Select a template
> Set up with GitHub Copilot (Preview)

  4. 檢視所請求的工具存取權，並授權使用工作流程所需的工具。 Copilot 使用 azd Azure 開發功能來檢查專案、建立檔案並驗證結果。

  5. 如果 azd 系統提示你設定模型和推理層級，請選擇它們。

    第一次執行時，提示使用以下標籤。 可用的模型與推理選擇取決於您的 GitHub Copilot 帳號及所選模型：

    ? Select AI model
? Select reasoning effort level

  6. 描述你想建造的東西。 請包含相關需求，例如：

    • 範本包含應用程式碼、僅基礎設施，或兩者兼具。
    • 如果已知，請提供應用程式使用的語言和框架。
    • Azure 服務與主機平台的使用。
    • 是用 Bicep 還是 Terraform。
    • 安全性、網路、擴展性與區域需求。

    例如：

    Build an infrastructure-only azd template that provisions an Azure Container Apps
environment, Azure Container Registry, and Log Analytics workspace with Bicep.
Use managed identity and least-privilege role assignments. Parameterize the location
and environment name so the template can be reused.

  7. 回答 Copilot 的任何架構或設定問題。 代理程式會為 Azure 準備專案，產生範本資產，並執行部署前驗證。

  8. 檢視 Copilot 建立或更改的檔案整體結構。 確認範本包含預期的專案配置、基礎設施目錄、應用程式來源及支援資產。

    例如，僅為基礎設施產生的範本可能包含以下關鍵檔案：

    azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep

    如需詳細檢視組態與基礎架構內容的指引，請參閱 「探索與編輯範本檔案」。

配置並部署範本

核准產生的檔案後，執行以下指令：

azd up

指令用來建立或選擇環境azd、配置 Azure 資源、打包任何應用程式服務並部署。 如需詳細的指令解析，請參閱 「探索 azd up 工作流程」。

使用其他創作方法

其他 AI 編碼助理雖然不直接連接到 azd init 工作流程，但可以建立相同的標準範本資產。 你也可以直接編寫每個資產。

你可以自己製作這些資產，或請其他程式助理分析你的需求並製作：

  • 一個 azure.yaml 定義專案及可部署服務的檔案。
  • 用來佈建所需 Azure 資源的 Bicep 或 Terraform 檔案。
  • 資源輸出與應用環境變數。
  • Docker 檔案、部署設定，以及必要時的支援腳本。

為了提供使用其他代理前的最小起點，執行：

azd init --minimal

如果你使用其他程式助理，指示它遵循 azure.yamlAzure 基礎設施的安全實務，以及 Azure 開發者 CLI 範本中描述的範本慣例。 如果你直接撰寫檔案，請使用與實作指南相同的參考資料。 執行 azd up前請檢查並驗證所有檔案。

相關內容

請求幫助

如需了解如何提出錯誤、請求協助或建議Azure開發者 CLI 新功能，請造訪 troubleshooting and support 頁面。

  • Last updated on