共用方式為


快速入門:搭配適用於 NoSQL 和 Azure Static Web Apps 的 Azure Cosmos DB 使用數據 API 產生器

在本快速入門中,您會部署 Azure Developer CLI (AZD) 範本。 此範本會部署 Azure 靜態 Web 應用程式,該應用程式會使用其 資料庫連結 功能來裝載資料 API 產生器。 此範本也包含範例應用程式,可供您作為解決方案的起點。

必要條件

提示

或者,在 GitHub Codespaces 中開啟本快速入門,並已安裝所有開發人員必要條件。 只要攜帶您自己的 Azure 訂用帳戶即可。 GitHub 帳戶包含記憶體的權利和核心時數,不收費。 如需詳細資訊,請參閱 GitHub 帳戶的內含記憶體和核心時數

在 GitHub Codespaces 中開啟

部署範本

首先,使用 AZD 範本部署所有必要的服務。

  1. 在專案的根目錄中開啟終端機。

  2. 使用azd auth login向 Azure Developer CLI 進行驗證。 遵循工具指定的步驟,使用您慣用的 Azure 認證向 CLI 進行驗證。

    azd auth login
    
  3. 使用 azd init 初始化專案。

    azd init --template dab-azure-cosmos-db-nosql-quickstart
    

    重要

    如果您在 GitHub Codespaces 中執行,您可以放心省略 自變數, --template 因為程式代碼已經複製到您的環境。

  4. 在初始化期間,設定唯一的環境名稱。

    提示

    環境名稱也會作為目標資源組名。 在本快速入門中,請考慮使用 msdocs-swa-dab

  5. 使用azd up部署 Azure Static Web Apps解決方案。 Bicep 範本會部署 適用於 NoSQL 的 Azure Cosmos DB 帳戶 ,以及支援的記憶體、身分識別和主機服務。 範例 Web 應用程式會部署至 Web 主機。

    azd up
    
  6. 在布建程式期間,選取您的訂用帳戶和所需的位置。 等候佈建程序完成。 此程式可能需要 大約五分鐘的時間。

  7. 完成 Azure 資源的布建之後,範本會輸出 SUCCESS 訊息以及執行持續時間。

    SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
    

設定資料庫連接

現在,使用 Azure Static Web Apps的 資料庫連結 功能,在已部署的靜態 Web 應用程式和已部署的資料庫之間建立連線。 此功能會使用數據 API 產生器順暢地使用您指定的認證,建立與執行中 Azure Cosmos DB for NoSQL 帳戶的連線。

  1. 流覽至 Azure 入口網站 中的 Azure 靜態 Web 應用程式資源。

  2. 設定靜態 Web 應用程式,以使用這些設定,將 資料庫連線 新增至適用於 NoSQL 的 Azure Cosmos DB 帳戶。 然後,選取 [鏈接]。

    資料庫類型 Azure Cosmos DB for NoSQL
    訂用帳戶 選取您用於 AZD 部署的訂用帳戶
    資源群組 選取您用於 AZD 部署的資源群組 (環境)
    資源名稱 選取唯一的適用於 NoSQL 的 Azure Cosmos DB 資源,其前置詞為 nosql-*
    資料庫名稱 cosmicworks
    驗證類型 User-assigned managed identity
    使用者指派的受控識別 *選取具有前置詞的唯一受控識別資源 ua-id-*

    Azure 入口網站 中靜態 Web 應用程式之資料庫連線頁面的螢幕快照。

  3. 現在,選取資源頁面上的 [ 瀏覽 ] 選項,以觀察執行中的 Web 應用程式。

    Azure Static Web Apps 上執行中 Web 應用程式的螢幕快照。

清理

當您不再需要範例應用程式或資源時,請移除對應的部署和所有資源。

  1. 從您的 Azure 訂用帳戶中移除部署。

    azd down
    
  2. 如果您使用 GitHub Codespaces,請刪除執行中的 Codespace,以最大化您的記憶體和核心權利。

後續步驟