Share via

設定 Azure 的本機 JavaScript 開發環境

  • 發行項

建立雲端應用程式時，開發人員通常會偏好在本機工作站上測試程序代碼，再將該程式代碼部署至 Azure 之類的雲端環境。 本機開發可讓您利用更廣泛的工具以及熟悉的環境。

本文提供設定指示，以建立及驗證適用於 JavaScript 與 Azure 的本機開發環境。

建立一次性訂用帳戶

Azure 資源 會在訂用帳戶和資源群組內建立。

類型 描述
試用版訂閱 建立免費試用訂用帳戶。
現有的訂用帳戶 如果您已經有訂用帳戶，請在 Azure 入口網站、Azure CLI 或適用於 JavaScript 的 Azure SDK 中存取現有的訂用帳戶。
跨多個訂用帳戶 如果您需要管理多個訂用帳戶， 請瞭解如何 使用 JavaScript 建立管理群組。

單次軟體安裝

在本機工作站上使用 JavaScript 進行 Azure 開發，建議您安裝下列專案：

名稱/安裝程式 描述
Node.js LTS 安裝本機工作站開發的最新長期支援 （LTS） 運行時間環境。
Visual Studio Code Visual Studio Code 提供絕佳的 JavaScript 整合和程式代碼撰寫體驗，但並非必要。 您可以使用任何程式代碼編輯器。

Azure 裝載運行時間

如果您打算使用 Azure 資源作為應用程式的裝載環境，例如 Azure Web 應用程式或 Azure Functions，您應該 確認本機 Node.js 開發環境運行時間版本的 Node.js 符合您打算使用的 Azure 資源運行時間。

建議使用下列常見的本機工作站安裝，協助您處理本機開發工作。

名稱 描述
Azure CLI 本機或雲端式 CLI 來建立及使用 Azure 資源。
Azure 開發人員 CLI 開發人員為中心的命令行工具，可在開發人員工作流程中建置雲端應用程式。
適用於 Azure 的 Visual Studio Code 擴充功能 IDE 的 VS Code 延伸模組。
Git 或 Git for Windows 原始檔控制的命令行工具。 如果您想要的話，可以使用不同的原始檔控制工具。

驗證的一次性設定

若要在本機開發和遠端 Azure 裝載環境中使用相同的驗證碼，請使用 DefaultAzureCredential。

為您的專案建立資源群組

  1. 在網頁瀏覽器中開啟 Azure 入口網站。

  2. 在搜尋列中，輸入 資源群組 並加以選取。

  3. 選取 + 建立。

  4. 輸入您的資源群組設定：

    屬性 值
    訂用帳戶 選取您的訂用帳戶。
    資源群組 輸入您的資源組名。 當您存取 Resource Manager（管理平面）時，此資源組名會當做資源 URI 的一部分使用。 名稱不會用於控制（例如建立資料庫）或數據平面（將數據插入數據表中）。
    區域 選取資源群組的地理區域。

  5. 選取 [ 檢閱 + 建立] 開始驗證。

  6. 驗證成功時，請選取 [ 建立]。

使用 Azure 和 Azure SDK 用戶端連結庫

每個服務都會個別提供 Azure SDK 連結 庫 。 您會根據需要使用的 Azure 服務來安裝每個連結庫。

每個使用 Azure 的新項目都應該：

  • 建立 Azure 資源，並將相關聯的金鑰或組態儲存到 安全的位置。
  • 從 NPM 或 Yarn 安裝 Azure SDK 連結庫。
  • 使用您的本機服務主體認證向 Azure SDK 進行驗證，然後使用組態資訊來存取特定服務。

保護組態資訊

您有數個選項可儲存群組態資訊：

建立 Azure 連結庫的環境變數

若要使用 Azure SDK 連結庫存取 Azure 雲端所需的 Azure 設定，請將最常見的值設定為 環境變數。 下列命令會設定本機工作站的環境變數。

在下列範例中，用戶端標識符是服務主體標識碼和服務主體秘密。

AZURE_SUBSCRIPTION_ID="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

將這些命令中顯示的值取代為您特定服務主體的值。

建立 .env 檔案

另一個常見機制是使用 DOTENV NPM 套件來建立 .env 這些設定的檔案。 如果您打算使用 .env，請務必 不要將檔案簽入 原始檔控制。 將 .env 檔案新增至 git 檔案 .ignore 是確保這些設定簽入原始檔控制的標準方式。

安裝 npm 套件

針對每個項目，建議您一律使用下列步驟建立個別的資料夾和自己的 package.json 檔案：

  1. 開啟終端機、命令提示字元或bash殼層，並建立專案的新資料夾。 然後移至該新資料夾。

    mkdir MY-NEW-PROJECT && cd MY-NEW-PROJECT

  2. 初始化封裝檔案：

    npm init -y

    這會建立 package.json 檔案，並初始化最小屬性。

  3. 安裝您需要的 Azure SDK 連結庫，例如下列範例：

    npm install @azure/ai-text-analytics@5.0.0

搭配 Visual Studio Code 使用原始檔控制

建議您在開始項目時習慣建立原始檔控制存放庫。 您可以從 Visual Studio Code 執行此動作。

  1. 在 Visual Studio Code 中，選取原始檔控制圖示以開啟 原始檔控制 總管，然後選取 [初始化存放庫 ] 以初始化本機 Git 存放庫：

    Initialize git repository

  2. 初始化存放庫之後，而且您有檔案要儲存在原始檔控制中，請輸入訊息 Initial commit ，然後選取複選標記以建立原始程式檔的初始認可。

    Complete an initial commit to the repository

  3. 在 GitHub 或 Azure DevOps 上建立新的存放庫，並複製後續幾個步驟的存放庫 URL。

  4. 在 Visual Studio 整合式終端機中，使用下列 git 命令，將遠端存放庫新增至本機存放庫。 將YOUR-ALIAS 和 YOUR-REPOSITORY 取代為您自己的值。

    git remote add origin https://github.com/YOUR-ALIAS/YOUR-REPOSITORY

Visual Studio Code 包含許多內建 Git 功能。 如需詳細資訊，請參閱 在 VS Code 中使用版本控制。

下一步