在本快速入門中,您將瞭解如何使用 Azure 開發人員 CLI (azd) 範本 ,以及只布建和部署應用程式資源至 Azure,以及一些 azd 命令。
azd 範本是包含應用程式原始程式碼的標準程式代碼存放庫,以及 azd 用來布建 Azure 資源的組態和基礎結構檔案。 若要深入了解 azd 範本,以及如何加速 Azure 布建和部署程式,請參閱 什麼是 Azure 開發人員 CLI 範本?。
選取並部署範本
針對後續步驟,您將使用下列範本在 Azure 上佈建和部署應用程式:
您也可以從 Awesome AZD 樣本庫網站選取符合您喜好設定的範本。 無論您使用哪一個範本,您最終都會在開發環境中使用範本程式代碼,並能夠執行命令,以在 Azure 中建置、重新部署及監視應用程式。
選取您慣用的環境以繼續:
本機開發環境是傳統開發工作流程的絕佳選擇。 您會將範本存放庫複製到裝置上,並針對 的 azd本機安裝執行命令。
必要條件
初始化專案
在 檔案總管 或終端機中,建立新的空白目錄,並將其變更為 。
執行 命令, 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-aca
出現提示時,請輸入環境名稱,例如 azdquickstart,這會設定將建立以保存 Azure 資源之資源群組的命名前置詞。
中的環境名稱 azd為何?
指定環境之後, azd 將範本專案複製到您的計算機,並初始化專案。
布建和部署應用程序資源
azd auth login執行 命令並azd啟動瀏覽器,讓您完成登入程式。
azd auth login
執行 azd up 命令:
azd up
登入 Azure 之後,系統會提示您輸入下列資訊:
| 參數 |
描述 |
Azure Location |
將部署資源的 Azure 位置。 |
Azure Subscription |
將部署資源的 Azure 訂用帳戶。 |
選取您想要的值,然後按 Enter 鍵。 命令 azd up 會使用樣本組態和基礎結構檔案為您處理下列工作:
- 建立及設定所有必要的 Azure 資源 (
azd provision),包括:
- 存取帳戶的原則和角色
- 使用受控識別進行服務對服務通訊
- 封裝和部署程式代碼 (
azd deploy)
azd up當命令順利完成時,CLI 會顯示兩個連結來檢視已建立的資源:
- ToDo API 應用程式
- ToDo Web 應用程式前端
注意
您可以 azd up 呼叫您想要佈建和部署更新至應用程式的次數。
部署可能會因為所選取區域中的資源無法部署而失敗。 因為這是快速入門,所以可以安全地刪除 .azure 目錄,然後再試 azd up 一次。 當系統詢問時,請選取不同的區域。 在更進階的案例中,您可以選擇性地編輯目錄中的 .azure 檔案來變更區域。
Azure 開發人員 CLI 提供 Visual Studio Code 擴充功能,以簡化使用 azd 功能的流程。 例如,您可以使用指令面板介面來執行 azd 指令。 您必須安裝適用於 Visual Studio Code 的 Azure 開發人員 CLI 延伸模組,才能完成下列步驟。
安裝 Azure 開發人員 CLI 延伸模組
開啟 Visual Studio Code。
從 [檢視] 功能表中,選取 [擴充功能]。
在搜尋欄位中,輸入 Azure Developer CLI。
選取 [安裝] ,然後等候安裝程序完成。
初始化新應用程式
在 Visual Studio Code 中開啟空白目錄。
從 「檢視 」功能表中,選取 「命令面板...」。
搜尋命令 Azure Developer CLI (azd): Initialize app (init) 並按 Enter 鍵。 此 azd up 命令會 azd 指示佈建和部署應用程式資源。
選擇 選取範本 工作流程。
複製範本之後,Visual Studio Code 會開啟終端機,提示您輸入環境名稱。 輸入您選擇的簡短名稱,例如 azdvscode ,然後按 Enter 鍵。
Enter a new environment name: [? for help] azdvscode
環境名稱會影響 Azure 中佈建之資源的命名,並在範本目錄中 .azure 建立資料夾來儲存特定環境設定。
布建和部署應用程序資源
開啟「指令面板」並搜尋指令 Azure Developer CLI (azd): Package, Provision and Deploy(up) ,然後按 Enter 鍵。 此 azd up 命令會 azd 指示佈建和部署應用程式資源。
Visual Studio Code 會開啟終端機視窗,以顯示佈建和部署程式的進度。
azd 使用您在init過程中選取的訂閱和位置設定來部署資源。
部署程式完成後,請選取 提供的 azd 輸出視窗中的連結,以在瀏覽器中啟動您的網站。
Codespaces 是適合想要在容器化雲端環境中工作的開發人員的絕佳選項,可避免在本機安裝工具或相依性。
設定您的 Codespace
- 在瀏覽器中,流覽至 Azure 範本上使用 Python API 和 MongoDB 的 React Web 應用程式(或從 Awesome AZD 選取其中一個)
- 在瀏覽器中,流覽至 Azure 範本上使用 Java API 和 MongoDB 的容器化 React Web 應用程式(或從 令人敬畏的 AZD 中選取一個)
- 在檔案清單上方,按兩下 >]。
使用 Codespaces 時,會為您安裝所有必要條件,包括 azd Visual Studio Code 擴充功能。
執行範本
建立 Codespace 之後,以滑鼠右鍵按兩下 根目錄中的 azure.yaml 。 從選項中,選取 [布建資源],並將程序代碼部署至 Azure]。
當您執行 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 輸出,您可以瀏覽至功能完整的應用程式。
注意
- 您可以
azd up 呼叫您想要佈建和部署應用程式的次數。
- 由於 GitHub Codespaces 的已知限制,目前不支援啟動網頁瀏覽器的執行和偵錯。 為了獲得更好的體驗,建議您在桌面中使用Codespaces。
DevContainer 是 Docker 映像,其中包含您在本機電腦上使用azd範本所需的所有必要條件。 對於偏好仍在本機裝置上執行的容器化環境,而不是 GitHub Codespaces 等雲端服務,這是絕佳的選擇。
必要條件
初始化專案
開啟終端機、建立新的空白目錄,然後變更為它。
執行下列命令來初始化專案:
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-aca
當您執行 azd init 命令時,系統會提示您提供下列資訊:
| 參數 |
描述 |
Environment Name |
將建立以保存所有 Azure 資源的資源群組前置詞。 中的環境名稱 azd為何? 您一律可以使用 建立新的環境 azd env new。 |
開啟DevContainer
- 在 VS Code 中開啟專案。
- 按 F1 並選擇:
Remote-Containers: Rebuild and Reopen in Container
執行 up 命令
執行以下命令:
azd up
當您執行 azd up 命令時,系統會提示您提供下列資訊:
| 參數 |
描述 |
Azure Location |
將部署資源的 Azure 位置。 |
Azure Subscription |
將部署資源的 Azure 訂用帳戶。 |
當 azd up 命令完成下列步驟時,可能需要一些時間才能執行:
- 建立及設定所有必要的 Azure 資源 (
azd provision),包括:
- 存取帳戶的原則和角色
- 使用受控識別進行服務對服務通訊
- 封裝和部署程式代碼 (
azd deploy)
提供必要參數並azd up完成命令之後,CLI 會顯示兩個 Azure 入口網站 連結來檢視已建立的資源:
- ToDo API 應用程式
- ToDo Web 應用程式前端
注意
您可以執行 azd up 您想要將應用程式佈建和部署至相同區域,並使用您在第一次執行時提供的相同組態值來執行多次。
清除資源
當您不再需要本文中建立的資源時,請執行下列命令來關閉應用程式電源:
azd down
如果您想要重新部署至不同的區域,請先刪除目錄再 .azure 執行 azd up 一次。 在更進階的案例中,您可以選擇性地編輯目錄中的 .azure 檔案來變更區域。
要求說明
如需如何提出 Bug、要求協助或為 Azure 開發人員 CLI 提出新功能的資訊,請流覽 疑難解答和支援 頁面。
下一步