使用 Azure Developer CLI 建立環境
本文將說明如何安裝 Azure Developer CLI (AZD)、將應用程式基礎結構佈建至 Azure 部署環境來建立新的部署環境,並將您的應用程式程式碼部署至該佈建完成的部署環境。
Azure Developer CLI (AZD) 是一項開放原始碼工具,可縮短應用程式從本機開發環境遷移至 Azure 的時間。 不論您是在終端機、編輯器或集成開發環境 (IDE) 或 CI/CD (持續整合/持續部署),AZD 都提供最適合開發人員使用的命令,以對應至工作流程中的關鍵階段。
若要瞭解如何設定 AZD 以使用 Azure 部署環境,請參閱 搭配 Azure 部署環境使用 Azure 開發人員 CLI。
必要條件
您應該:
準備使用 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],然後選取 [安裝]。
powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
在 Visual Studio 2022 17.3 預覽版 2 或更新版本,您可啟用 AZD 整合的預覽功能。
若要啟用 AZD 功能,前往 [工具] > [選項] > [環境] > [預覽功能],然後選取 [與 AZD (Azure Developer CLI) 整合]。
此功能啟用後,即可在 Windows、Linux 或 macOS 上您偏好的終端使用 Azure Developer CLI。
登入 Azure Developer CLI
登入後,即可存取 Azure 資源。 開始登入時,將開啟瀏覽器視窗,並提示您登入 Azure。 登入後,終端會顯示一則您已登入 Azure 的訊息。
使用命令選擇區登入 AZD:
命令選擇區發出命令後,輸出會顯示在 AZD 開發人員終端,如下範例所示:
在 CLI 使用下列命令登入 Azure:
azd auth login
登入後,即可存取 Azure 資源。 開始登入時,將開啟瀏覽器視窗,並提示您登入 Azure。 登入後,終端會顯示一則您已登入 Azure 的訊息。
若要開啟開發人員命令提示字元:
請從 [工具] 功能表中,選取 [終端]。
在 [終端] 視窗中,選取 [開發人員命令提示字元]。
使用開發人員命令終端登入 AZD:
azd auth login
啟用 ADE 的 AZD 支援
您可使用 azd up
或 azd provision
等標準命令來設定 AZD,以將資源佈建並部署至您的部署環境。 platform.type
設為 devcenter
時,所有 AZD 遠端環境狀態和佈建都會使用開發人員中心的元件。 AZD 佈建資源時,會使用開發人員中心目錄內定義的基礎結構範本之一。 在此設定中, 不會使用本機範本中的 infra 資料夾。
azd config set platform.type devcenter
azd config set platform.type devcenter
透過現有程式碼建立環境
現在您已準備好建立工作需要的環境。 您可先從本機資料夾執行程式碼著手,或是複製現有存放庫。 本範例會在本機資料夾使用程式碼來建立環境。
初始化新的應用程式
初始化新的應用程式,將建立 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 檔案。
在 CLI 內,瀏覽到包含您應用程式程式碼的資料夾。
執行下列命令,將應用程式初始化,並依據提示提供資訊:
azd init
在 AZD 終端內,選取 Use code in the current directory。
AZD 會根據您正建置的應用程式類型,掃描目前目錄並收集更多資訊。 依照提示設定您的 AZD 環境。
azd init
會識別應用程式程式碼內定義的服務,並提示您確認並繼續、移除服務或新增服務。 選取 Confirm and continue initializing my app。
azd init
會持續收集資訊來設定您的應用程式。 以此範例應用程式而言,提示會請您輸入 MongoDB 資料庫執行個體,以及該服務接聽的連接埠。
輸入本機 AZD 環境的名稱。
azd init
會顯示您可存取的專案清單。 選取環境的專案。
azd init
會顯示專案內的環境定義清單。 選取環境定義。
AZD 會建立專案資源,包括在專案根目錄建立 azure.yaml 檔案。
在 CLI 內,瀏覽到包含您應用程式程式碼的資料夾。
執行下列命令,將應用程式初始化,並依據提示提供資訊:
azd init
在 AZD 終端內,選取 Use code in the current directory。
AZD 會根據您正建置的應用程式類型,掃描目前目錄並收集更多資訊。 依照提示設定您的 AZD 環境。
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 佈建您的應用程式:
azd provision
'azd provision' 會提供您可存取的專案清單。 選取您要在其中佈建應用程式的專案。
'azd provision' 會提供所選專案的環境定義清單。 選取您佈建應用程式要使用的環境定義。
'azd provision' 會提供所選專案的環境類型清單。 選取您佈建應用程式要使用的環境類型。
AZD 會指示 ADE 依據您在前一步驟提供的資訊建立新的環境。
您可在 Azure 入口網站或開發人員入口網站檢視所建立的資源。
使用下列命令,在 Azure 佈建您的應用程式:
azd provision
'azd provision' 會提供您可存取的專案清單。 選取您要在其中佈建應用程式的專案。
'azd provision' 會提供所選專案的環境定義清單。 選取您佈建應用程式要使用的環境定義。
'azd provision' 會提供所選專案的環境類型清單。 選取您佈建應用程式要使用的環境類型。
AZD 會指示 ADE 依據您在前一步驟提供的資訊建立新的環境。
您可在 Azure 入口網站或開發人員入口網站檢視所建立的資源。
列出現有環境清單 (選用)
列出現有環境,驗證您的環境建立完成。
在 Explorer 中,對 [azure.yaml] 按一下滑鼠右鍵,然後選取 [Azure Developer CLI (azd)] > [View Local and Remote Environments (env list)]。
提示將請您選取專案和環境定義。
使用下列命令來檢視您可存取的環境:本機 AZD 環境及遠端 Azure 部署環境的環境。
azd env list
azd env list
會提示您選取專案和環境定義。
使用下列命令來檢視您可存取的環境:本機 AZD 環境及遠端 Azure 部署環境的環境。
azd env list
azd env list
會提示您選取專案和環境定義。
在 Azure 部署環境部署程式碼
環境佈建後,您可在其中部署程式碼。
在 Explorer 中,對 [azure.yaml] 按一下滑鼠右鍵,然後選取 [Azure Developer CLI (azd)] > [Deploy Azure Resources (deploy)]。
您可選取 AZD 終端列出的端點 URL,藉此驗證您的程式碼是否部署完成。
使用下列命令,在您佈建的遠端 Azure 部署環境的環境部署應用程式程式碼:
azd deploy
在遠端環境部署程式碼可能需要數分鐘。
您可在 Azure 入口網站檢視部署進度:
部署完成後,您可在 Azure 入口網站檢視剛佈建的資源:
您可選取 AZD 終端列出的端點 URL,藉此驗證您的程式碼是否部署完成。
以此應用程式範例而言,應出現如下所示的內容:
使用下列命令,在您佈建的遠端 Azure 部署環境的環境部署應用程式程式碼:
azd deploy
在遠端環境部署程式碼可能需要數分鐘。
您可在 Azure 入口網站檢視部署進度:
部署完成後,您可在 Azure 入口網站檢視剛佈建的資源:
您可選取 AZD 終端列出的端點 URL,藉此驗證您的程式碼是否部署完成。
清除資源
環境工作結束後,您可刪除 Azure 資源。
在 Explorer 中,對 [azure.yaml] 按一下滑鼠右鍵,然後選取 [Azure Developer CLI (azd)] > [Delete Deployment and Resources (down)]。
出現提示時輸入 y
,確認您要刪除環境。
使用下列命令,刪除 Azure 資源:
azd down --environment <environmentName>
使用下列命令,刪除 Azure 資源:
azd down --environment <environmentName>
相關內容