使用 Azure Developer CLI 建立環境
本文將說明如何安裝 Azure Developer CLI (AZD)、將應用程式基礎結構佈建至 Azure 部署環境來建立新的部署環境,並將您的應用程式程式碼部署至該佈建完成的部署環境。
Azure Developer CLI (AZD) 是一項開放原始碼工具,可縮短應用程式從本機開發環境遷移至 Azure 的時間。 不論您是在終端機、編輯器或集成開發環境 (IDE) 或 CI/CD (持續整合/持續部署),AZD 都提供最適合開發人員使用的命令,以對應至工作流程中的關鍵階段。
若要瞭解如何設定 AZD 以使用 Azure 部署環境,請參閱 搭配 Azure 部署環境使用 Azure 開發人員 CLI。
必要條件
您應該:
- 熟悉 Azure 部署環境。 檢閱什麼是 Azure 部署環境?及Azure 部署環境的重要概念。
- 建立並設定開發人員中心,其中包含專案、環境類型和目錄。 使用下列文章作為指引:
- 您的開發人員中心必須附加目錄。
準備使用 AZD
首次使用 AZD 時,必須完成一些一次性設定工作。 這些工作包括安裝 Azure Developer CLI、登入 Azure 帳戶,並啟用 Azure 部署環境的 AZD 支援。
使用下列指示來 安裝 Azure 開發人員 CLI。
安裝適用於 Visual Studio Code 的 Azure Developer CLI 延伸模組
安裝 AZD 時,AZD 工具僅安裝在 AZD 範圍內,並非全域安裝,若將 AZD 解除安裝,則相關工具也會移除。 若要在 Visual Studio Code 中使用 azd tools,請安裝延伸模組。
若要在 Visual Studio Code 中啟用 Azure 開發人員 CLI 功能,請安裝 Azure 開發人員 CLI 延伸模組 v0.8.3 版。 在活動列選取 [延伸模組] 圖示、搜尋 [Azure Developer CLI],然後選取 [安裝]。
登入 Azure Developer CLI
登入後,即可存取 Azure 資源。 開始登入時,將開啟瀏覽器視窗,並提示您登入 Azure。 登入後,終端會顯示一則您已登入 Azure 的訊息。
使用命令選擇區登入 AZD:
命令選擇區發出命令後,輸出會顯示在 AZD 開發人員終端,如下範例所示:
啟用 ADE 的 AZD 支援
您可使用 azd up
或 azd provision
等標準命令來設定 AZD,以將資源佈建並部署至您的部署環境。 platform.type
設為 devcenter
時,所有 AZD 遠端環境狀態和佈建都會使用開發人員中心的元件。 AZD 佈建資源時,會使用開發人員中心目錄內定義的基礎結構範本之一。 在此設定中, 不會使用本機範本中的 infra 資料夾。
透過現有程式碼建立環境
現在您已準備好建立工作需要的環境。 您可先從本機資料夾執行程式碼著手,或是複製現有存放庫。 本範例會在本機資料夾使用程式碼來建立環境。
初始化新的應用程式
初始化新的應用程式,將建立 AZD 處理您的應用程式所需的檔案和資料夾。
AZD 使用 azure.yaml 檔案來定義環境。 azure.yaml 檔案會定義並描述應用程式,以及應用程式使用的 Azure 資源類型。 若要進一步了解 azure.yaml,請參閱 Azure Developer CLI 的 azure.yaml 結構描述。
在 Visual Studio Code 中,開啟包含應用程式程式代碼的資料夾。
開啟命令選擇區,然後輸入 Azure Developer CLI init,然後從清單中選取 [Azure Developer CLI (azd): init]。
出現範本清單後,若不要選取範本即繼續,請按 ENTER 兩次。
在 AZD 終端內,選取 Use code in the current directory。
azd init
會識別應用程式程式碼內定義的服務,並提示您確認並繼續、移除服務或新增服務。 選取 Confirm and continue initializing my app。azd init
會持續收集資訊來設定您的應用程式。 以此範例應用程式而言,提示會請您輸入 MongoDB 資料庫執行個體,以及該服務接聽的連接埠。輸入本機 AZD 環境的名稱。
azd init
會顯示您可存取的專案清單。 選取該環境需要的專案azd init
會顯示專案內的環境定義清單。 選取環境定義。AZD 會建立專案資源,包括在專案根目錄建立 azure.yaml 檔案。
在 Azure 部署環境佈建基礎結構
準備完成後,即可透過 Azure 在遠端 Azure 部署環境佈建本機環境。 此流程會佈建開發人員中心目錄環境定義定義的基礎結構和資源。
在 Explorer 中,對 [azure.yaml] 按一下滑鼠右鍵,然後選取 [Azure Developer CLI (azd)]> [Provision Azure Resources (provision)]。
AZD 會掃描您可存取之專案的 Azure 部署環境。 在 AZD 終端內,選取或輸入下列資訊:
- Project
- 環境定義
- 環境類型
- Location
AZD 會指示 ADE 依據您在前一步驟提供的資訊建立新的環境。
您可在 Azure 入口網站或開發人員入口網站檢視所建立的資源。
列出現有環境清單 (選用)
列出現有環境,驗證您的環境建立完成。
在 Azure 部署環境部署程式碼
環境佈建後,您可在其中部署程式碼。
清除資源
環境工作結束後,您可刪除 Azure 資源。
在 Explorer 中,對 [azure.yaml] 按一下滑鼠右鍵,然後選取 [Azure Developer CLI (azd)]> [Delete Deployment and Resources (down)]。
出現提示時輸入 y
,確認您要刪除環境。
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應