分享方式：

使用 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 支援。

安裝適用於 Visual Studio Code 的 Azure Developer CLI 延伸模組

安裝 AZD 時，AZD 工具僅安裝在 AZD 範圍內，並非全域安裝，若將 AZD 解除安裝，則相關工具也會移除。 您可透過 Visual Studio Code 或命令列安裝 AZD。

若要在 Visual Studio Code 中啟用 Azure Developer CLI 功能，請安裝 Azure Developer CLI 延伸模組 (版本 0.8.0-alpha.1-beta.3173884)。 在活動列選取 [延伸模組] 圖示、搜尋 [Azure Developer CLI]，然後選取 [安裝]。

Visual Studio Code 的螢幕快照，其中顯示命令選擇區中的 [登入] 命令。

登入 Azure Developer CLI

登入後，即可存取 Azure 資源。 開始登入時，將開啟瀏覽器視窗，並提示您登入 Azure。 登入後，終端會顯示一則您已登入 Azure 的訊息。

使用命令選擇區登入 AZD：

Visual Studio Code 的螢幕快照，其中顯示已醒目提示 [Azure 開發人員 CLI] 和 [安裝] 的 [擴充功能] 窗格。

命令選擇區發出命令後，輸出會顯示在 AZD 開發人員終端，如下範例所示：

azd dev 終端機的螢幕快照，其中顯示按下任何按鍵關閉訊息。

啟用 ADE 的 AZD 支援

您可使用 azd up 或 azd provision 等標準命令來設定 AZD，以將資源佈建並部署至您的部署環境。 platform.type 設為 devcenter 時，所有 AZD 遠端環境狀態和佈建都會使用開發人員中心的元件。 AZD 佈建資源時，會使用開發人員中心目錄內定義的基礎結構範本之一。 在此組態中，不會使用本機範本內的 infra 資料夾。

Visual Studio Code 的螢幕快照，其中顯示命令選擇區中的 [啟用支援] 命令。

透過現有程式碼建立環境

現在您已準備好建立工作需要的環境。 您可先從本機資料夾執行程式碼著手，或是複製現有存放庫。 本範例會在本機資料夾使用程式碼來建立環境。

初始化新的應用程式

初始化新的應用程式，將建立 AZD 處理您的應用程式所需的檔案和資料夾。

AZD 使用 azure.yaml 檔案來定義環境。 azure.yaml 檔案會定義並描述應用程式，以及應用程式使用的 Azure 資源類型。 若要進一步了解 azure.yaml，請參閱 Azure Developer CLI 的 azure.yaml 結構描述。

  1. 在 Visual Studio Code 中，開啟包含應用程式程式代碼的資料夾。

  2. 開啟命令選擇區，然後輸入 Azure Developer CLI init，然後從清單中選取 [Azure Developer CLI (azd): init]。

    Visual Studio Code 命令選擇區的螢幕快照，其中已醒目提示 Azure 開發人員 CLI （azd）：init。

  3. 出現範本清單後，若不要選取範本即繼續，請按 ENTER 兩次。

  4. 在 AZD 終端內，選取 Use code in the current directory。

    Visual Studio Code 中 AZD 終端機的螢幕快照，其中顯示目前目錄提示字元中使用程式碼。

  5. azd init 會識別應用程式程式碼內定義的服務，並提示您確認並繼續、移除服務或新增服務。 選取 Confirm and continue initializing my app。

    顯示 AZD init 提示以確認並繼續、移除服務或新增服務的螢幕快照。

  6. azd init 會持續收集資訊來設定您的應用程式。 以此範例應用程式而言，提示會請您輸入 MongoDB 資料庫執行個體，以及該服務接聽的連接埠。

    顯示 azd init 提示以取得資料庫名稱的螢幕快照。

  7. 輸入本機 AZD 環境的名稱。

    顯示 azd init 提示輸入新環境名稱的螢幕快照。

  8. azd init 會顯示您可存取的專案清單。 選取該環境需要的專案

    顯示 azd init prompt Select 項目的螢幕快照。

  9. azd init 會顯示專案內的環境定義清單。 選取環境定義。

    顯示 azd init 提示選取環境定義的螢幕快照。

    AZD 會建立專案資源，包括在專案根目錄建立 azure.yaml 檔案。

在 Azure 部署環境佈建基礎結構

準備完成後，即可透過 Azure 在遠端 Azure 部署環境佈建本機環境。 此流程會佈建開發人員中心目錄環境定義定義的基礎結構和資源。

  1. 在 Explorer 中，對 [azure.yaml] 按一下滑鼠右鍵，然後選取 [Azure Developer CLI (azd)]> [Provision Azure Resources (provision)]。

    醒目提示 azure.yaml 的 Visual Studio Code 螢幕快照，以及醒目提示 Azure 開發人員 CLI 和布建環境的 AZD 操作功能表。

  2. AZD 會掃描您可存取之專案的 Azure 部署環境。 在 AZD 終端內，選取或輸入下列資訊：

    1. Project
    2. 環境定義
    3. 環境類型
    4. Location

  3. AZD 會指示 ADE 依據您在前一步驟提供的資訊建立新的環境。

  4. 您可在 Azure 入口網站或開發人員入口網站檢視所建立的資源。

列出現有環境清單 (選用)

列出現有環境，驗證您的環境建立完成。

  1. 在 Explorer 中，對 [azure.yaml] 按一下滑鼠右鍵，然後選取 [Azure Developer CLI (azd)]> [View Local and Remote Environments (env list)]。

    醒目提示 azure.yaml 的 Visual Studio Code 螢幕快照，以及醒目提示 Azure 開發人員 CLI 和檢視本機和遠端環境的 AZD 操作功能表。

    提示將請您選取專案和環境定義。

在 Azure 部署環境部署程式碼

環境佈建後，您可在其中部署程式碼。

  1. 在 Explorer 中，對 [azure.yaml] 按一下滑鼠右鍵，然後選取 [Azure Developer CLI (azd)]> [Deploy Azure Resources (deploy)]。

    醒目提示 azure.yaml 的 Visual Studio Code 螢幕快照，以及醒目提示 Azure 開發人員 CLI 和 [部署至 Azure] 的 AZD 操作功能表。

  2. 您可選取 AZD 終端列出的端點 URL，藉此驗證您的程式碼是否部署完成。

清除資源

環境工作結束後，您可刪除 Azure 資源。

在 Explorer 中，對 [azure.yaml] 按一下滑鼠右鍵，然後選取 [Azure Developer CLI (azd)]> [Delete Deployment and Resources (down)]。

醒目提示 azure.yaml 的 Visual Studio Code 螢幕快照，以及醒目提示 Azure 開發人員 CLI 和 [刪除部署和資源] 的 AZD 操作功能表。

出現提示時輸入 y，確認您要刪除環境。

相關內容