快速入門：將 Azure Cosmos DB 用於 NoSQL 和 Azure 靜態 Web 應用程式時的資料 API 建構器使用指南

在本快速入門中，您會將數據 API 產生器 （DAB） 部署為 Docker 容器至 Azure Container Apps。 您可以使用 Azure 開發人員 CLI （AZD）範本，根據最新的最佳實務，同時部署 DAB 及 Azure Cosmos DB for NoSQL 資料庫。 此範本也會部署使用 GraphQL 連線到 DAB 端點的範例 Web 應用程式。

先決條件

• Azure 開發人員 CLI
• .NET 9.0

如果您沒有 Azure 帳戶，請在開始之前建立 免費帳戶。

初始化專案

使用 Azure 開發人員 CLI （azd） 建立適用於 NoSQL 的 Azure Cosmos DB 帳戶、將 DAB 部署為容器化解決方案，以及部署容器化範例應用程式。 範例應用程式會使用 DAB 來查詢範例數據。

1. 在空的目錄中開啟終端機。

2. 如果您尚未通過驗證，請使用 azd auth login向 Azure 開發人員 CLI 進行驗證。 依照工具指定的步驟，使用您慣用的 Azure 認證向 CLI 進行驗證。

   azd auth login
   

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

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

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

5. 使用 azd up將完整解決方案部署至 Azure。 Bicep 範本會將適用於 NoSQL 的 Azure Cosmos DB 帳戶 DAB 部署至 Azure Container Apps，以及範例 Web 應用程式。

   azd up
   

6. 在設定過程中，選取您的訂閱和所需的區域。 等候布建程式完成。 此程式可能需要大約 7 分鐘 。

7. 完成 Azure 資源的布建之後，輸出中會包含執行中 Web 應用程式的 URL。

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service api
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   (✓) Done: Deploying service web
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
   

8. 記錄 API 和 網頁服務 的 URL 值。 您稍後會在本指南中使用這些值。

設定資料庫連線

現在，流覽至 Azure Container Apps 中的每個容器化應用程式，以驗證它們是否如預期般運作。

1. 首先，流覽至 api 服務的URL。 此 URL 會連結至執行中的 DAB 實例。

2. 觀察來自 DAB 的 JSON 輸出。 它應該表示 DAB 容器正在執行，且狀態 狀況良好。

   {
     "status": "healthy",
     "version": "1.1.7",
     "app-name": "dab_oss_1.1.7"
   }
   

3. 流覽至 DAB 實例的相對 /graphql 路徑。 此 URL 應開啟 Nitro GraphQL 集成開發環境 （IDE）。

4. 在 Nitro IDE 中，建立新的文件並執行此查詢，以取得適用於 NoSQL 的 Azure Cosmos DB products 容器中的所有 100 個專案。

   query {
     products {
       items {
       id
       name
       description
       sku
       price
       cost
       }
     }
   }
   

5. 最後，流覽至 Web 服務的 URL。 此 URL 會連結到執行中的範例 Web 應用程式，此應用程式會連線至您在上一個步驟中存取的 GraphQL 端點。

6. 觀察執行中的 Web 應用程式，並檢閱輸出數據。

   

收拾

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

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

   azd down
   

2. 如果您使用 GitHub Codespaces，請刪除正在運行的 Codespace，以最大化您的儲存空間和核心資源配額。

下一步

GraphQL 端點