快速入門：部署 Azure 開發人員 CLI 範本

本機開發環境是傳統開發工作流程的絕佳選擇。 您會將範本存放庫複製到裝置上，並針對 的 azd本機安裝執行命令。

必要條件

初始化專案

1. 在 檔案總管 或終端機中，建立新的空白目錄，並將其變更為 。

2. 執行 命令， azd init 並指定您想要作為參數使用的範本：

   azd init --template todo-nodejs-mongo
   

   azd init --template todo-python-mongo
   

   azd init --template todo-csharp-cosmos-sql
   

   azd init --template todo-java-mongo
   

   出現提示時，請輸入環境名稱，例如 azdquickstart，這會設定將建立以保存 Azure 資源之資源群組的命名前置詞。 中的環境名稱 azd為何？

   指定環境之後， azd 將範本專案複製到您的計算機，並初始化專案。

布建和部署應用程序資源

1. azd auth login執行 命令並azd啟動瀏覽器，讓您完成登入程式。

   azd auth login
   

2. 執行 azd up 命令：

   azd up
   

3. 登入 Azure 之後，系統會提示您輸入下列資訊：

   參數	描述
   Azure Location	將部署資源的 Azure 位置。
   Azure Subscription	將部署資源的 Azure 訂用帳戶。

   選取您想要的值，然後按 Enter 鍵。 命令 azd up 會使用樣本組態和基礎結構檔案為您處理下列工作：

   • 建立及設定所有必要的 Azure 資源 （azd provision），包括：
   • 存取帳戶的原則和角色
   • 使用受控識別進行服務對服務通訊
   • 封裝和部署程式代碼 （azd deploy）

   azd up當命令順利完成時，CLI 會顯示兩個連結來檢視已建立的資源：

   • ToDo API 應用程式
   • ToDo Web 應用程式前端

   

   注意

   您可以 azd up 呼叫您想要佈建和部署更新至應用程式的次數。

Codespaces 是適合想要在容器化雲端環境中工作的開發人員的絕佳選項，可避免在本機安裝工具或相依性。

設定您的 Codespace

2. 在檔案清單上方，按兩下 [在 Codespace 中開啟此範本>]。

使用 Codespaces 時，會為您安裝所有必要條件，包括 azd Visual Studio Code 擴充功能。

執行範本

1. 建立 Codespace 之後，以滑鼠右鍵按兩下 根目錄中的 azure.yaml 。 從選項中，選取 [布建資源]，並將程序代碼部署至 Azure]。

   

2. 當您執行 azd up 命令時，系統會提示您提供下列資訊，並使用網頁瀏覽器和驗證碼登入：

   

   參數	描述
   Environment Name	將建立以保存所有 Azure 資源的資源群組前置詞。 中的環境名稱 azd為何？ 您一律可以使用 建立新的環境 azd env new。
   Azure Location	將部署資源的 Azure 位置。
   Azure Subscription	將部署資源的 Azure 訂用帳戶。

   此程式可能需要一些時間才能完成，因為 azd up 命令會處理下列工作：

   • 建立及設定所有必要的 Azure 資源 （azd provision）。
   • 設定帳戶的存取原則和角色。
   • 實作與受控識別的服務對服務通訊。
   • 封裝並部署程式代碼 （azd deploy）。

   提供必要參數和azd up命令完成之後，CodeSpaces 終端機會顯示兩個 Azure 入口網站 連結，以檢視已建立的資源：

   • ToDo API 應用程式
   • ToDo Web 應用程式前端

   

發生什麼事？

azd up 命令成功完成時：

• 範本檔案中參考的 README.md Azure 資源已布建至您在執行 azd up之後指定的 Azure 訂用帳戶。 您現在可以透過 Azure 入口網站 檢視這些 Azure 資源。
• 應用程式已建置並部署至 Azure。 使用命令的 azd up Web 應用程式 URL 輸出，您可以瀏覽至功能完整的應用程式。

DevContainer 是 Docker 映像，其中包含您在本機電腦上使用azd範本所需的所有必要條件。 對於偏好仍在本機裝置上執行的容器化環境，而不是 GitHub Codespaces 等雲端服務，這是絕佳的選擇。

必要條件

初始化專案

1. 開啟終端機、建立新的空白目錄，然後變更為它。

2. 執行下列命令來初始化專案：

   azd init --template todo-nodejs-mongo
   

   azd init --template todo-python-mongo
   

   azd init --template todo-csharp-cosmos-sql
   

   azd init --template todo-java-mongo
   

   當您執行 azd init 命令時，系統會提示您提供下列資訊：

   參數	描述
   Environment Name	將建立以保存所有 Azure 資源的資源群組前置詞。 中的環境名稱 azd為何？ 您一律可以使用 建立新的環境 azd env new。

開啟DevContainer

1. 在 VS Code 中開啟專案。
2. 按 F1 並選擇： Remote-Containers: Rebuild and Reopen in Container

執行 up 命令

執行以下命令：

azd up

當您執行 azd up 命令時，系統會提示您提供下列資訊：

當 azd up 命令完成下列步驟時，可能需要一些時間才能執行：

• 建立及設定所有必要的 Azure 資源 （azd provision），包括：
  • 存取帳戶的原則和角色
  • 使用受控識別進行服務對服務通訊
• 封裝和部署程式代碼 （azd deploy）

提供必要參數並azd up完成命令之後，CLI 會顯示兩個 Azure 入口網站 連結來檢視已建立的資源：

• ToDo API 應用程式
• ToDo Web 應用程式前端