Rychlý start: Použití Tvůrce rozhraní Data API se službou Azure Cosmos DB for NoSQL a Azure Static Web Apps

V tomto rychlém startu nasadíte šablonu Azure Developer CLI (AZD). Šablona nasadí statickou webovou aplikaci Azure, která hostuje tvůrce rozhraní Data API pomocí funkce databázová připojení. Šablona obsahuje také ukázkovou aplikaci, kterou můžete použít jako výchozí bod pro vaše řešení.

Požadavky

• Předplatné Azure. Pokud nemáte předplatné Azure, vytvořte si bezplatný zkušební účet.
• .NET 8
• Azure Developer CLI

Tip

Případně můžete otevřít tento rychlý start v GitHub Codespaces s již nainstalovanými všemi požadavky pro vývojáře. Jednoduše si přineste vlastní předplatné Azure. Účty GitHub zahrnují nárok na hodiny úložiště a jádra bez poplatků. Další informace najdete v tématu zahrnuté hodiny úložiště a doby jádra pro účty GitHubu.

Nasazení šablony

Nejprve nasaďte všechny požadované služby pomocí šablony AZD.

1. Otevřete terminál v kořenovém adresáři projektu.

2. Ověřte se u Azure Developer CLI pomocí azd auth loginpříkazu . Postupujte podle kroků určených nástrojem a ověřte se v rozhraní příkazového řádku pomocí vašich upřednostňovaných přihlašovacích údajů Azure.

   azd auth login
   

3. Pomocí příkazu azd init inicializujete projekt.

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

   Důležité

   Pokud používáte GitHub Codespaces, můžete argument bezpečně vynechat --template , protože kód už je do vašeho prostředí naklonovaný.

4. Během inicializace nakonfigurujte jedinečný název prostředí.

   Tip

   Název prostředí se použije také jako název cílové skupiny prostředků. Pro účely tohoto rychlého startu zvažte použití msdocs-swa-dab.

5. Nasaďte řešení Azure Static Web Apps pomocí azd up. Šablony Bicep nasadí účet Azure Cosmos DB for NoSQL spolu s podpůrnými službami úložiště, identit a hostitelů. Na webového hostitele se nasadí ukázková webová aplikace.

   azd up
   

6. Během procesu zřizování vyberte své předplatné a požadované umístění. Počkejte na dokončení procesu zřizování. Tento proces může trvat přibližně pět minut.

7. Po dokončení zřizování prostředků Azure se ze šablony vypíše zpráva SUCCESS spolu s dobou trvání spuštění.

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

Konfigurace připojení k databázi

Teď pomocí funkce databázová připojení Azure Static Web Apps vytvořte připojení mezi nasazenou statickou webovou aplikací a nasazenou databází. Tato funkce bezproblémově využívá Tvůrce rozhraní Data API k vytvoření připojení ke spuštěného účtu Azure Cosmos DB for NoSQL pomocí přihlašovacích údajů, které zadáte.

1. V Azure Portal přejděte k prostředku azure Static Web App.

2. Pomocí těchto nastavení nakonfigurujte statickou webovou aplikaci tak, aby do účtu Azure Cosmos DB for NoSQL přidala připojení k databázi . Pak vyberte Odkaz.

   	Hodnota
   Typ databáze	Azure Cosmos DB for NoSQL
   Předplatné	Vyberte předplatné, které jste použili k nasazení AZD.
   Skupina prostředků	Vyberte skupinu prostředků (prostředí), kterou jste použili pro nasazení AZD.
   Název prostředku	Vyberte jediný prostředek Azure Cosmos DB for NoSQL s předponou nosql-*
   Název databáze	cosmicworks
   Typ ověřování	User-assigned managed identity
   Spravovaná identita přiřazená uživatelem	*Vyberte jediný prostředek spravované identity s předponou ua-id-*

   

3. Teď na stránce prostředku vyberte možnost Procházet a podívejte se na spuštěnou webovou aplikaci.

   

Vyčištění

Pokud už ukázkovou aplikaci nebo prostředky nepotřebujete, odeberte odpovídající nasazení a všechny prostředky.

1. Odeberte nasazení z předplatného Azure.

   azd down
   

2. Pokud používáte GitHub Codespaces, odstraňte spuštěný codespace, abyste maximalizovali nároky na úložiště a jádra.

Další krok

Koncové body GraphQL