Přístup k datům ve službě Azure Cosmos DB pomocí Mongoose s Azure Static Web Apps

Mongoose je nejoblíbenější klient ODM (Object Document Mapping) pro Node.js. Mongoose umožňuje navrhnout datovou strukturu a vynutit ověření a poskytuje všechny nástroje potřebné k interakci s databázemi, které podporují rozhraní MongoDB API. Cosmos DB podporuje potřebná rozhraní MongoDB API a je k dispozici jako možnost back-endového serveru v Azure.

Požadavky

• Účet Azure. Pokud nemáte předplatné Azure, vytvořte si bezplatný zkušební účet.
• Účet GitHubu.
• Bezserverový účet služby Cosmos DB. S bezserverovým účtem platíte jenom za prostředky, které se používají, a nemusíte vytvářet úplnou infrastrukturu.

1. Vytvoření bezserverové databáze Cosmos DB

Provedením následujících kroků vytvořte bezserverovou databázi Cosmos.

1. Přihlaste se k webu Azure Portal.
2. Vyberte Vytvořit prostředek.
3. Do vyhledávacího pole zadejte Azure Cosmos DB .
4. Vyberte Azure Cosmos DB.
5. Vyberte Vytvořit.
6. Pokud se zobrazí výzva, v části Rozhraní API služby Azure Cosmos DB pro MongoDB vyberte Vytvořit.
7. Nakonfigurujte účet služby Azure Cosmos DB s následujícími informacemi:
   • Předplatné: Zvolte předplatné, které chcete použít.
   • Prostředek: Vyberte Vytvořit nový a nastavte název na aswa-mongoose.
   • Název účtu: Vyžaduje se jedinečná hodnota.
   • Umístění: USA – západ 2
   • Režim kapacity: Bezserverový (Preview)
   • Verze: 4.0
8. Vyberte Zkontrolovat a vytvořit.
9. Vyberte Vytvořit.

Proces vytvoření trvá několik minut. Po vytvoření statické webové aplikace se vrátíme zpět do databáze a shromáždíme připojovací řetězec.

2. Vytvoření statické webové aplikace

V tomto kurzu se k vytvoření aplikace používá úložiště šablon GitHubu.

1. Přejděte na úvodní šablonu.

2. Vyberte vlastníka (pokud používáte jinou organizaci než hlavní účet).

3. Pojmenujte úložiště aswa-mongoose-tutorial.

4. Vyberte možnost Create repository from template (Vytvořit úložiště ze šablony).

5. Vraťte se na Azure Portal.

6. Vyberte Vytvořit prostředek.

7. Do vyhledávacího pole zadejte statickou webovou aplikaci .

8. Vyberte Static Web App (Static Web App).

9. Vyberte Vytvořit.

10. Nakonfigurujte webovou aplikaci Azure Static s následujícími informacemi:

    • Předplatné: Zvolte stejné předplatné jako předtím.
    • Skupina prostředků: Vyberte aswa-mongoose.
    • Název: aswa-mongoose-tutorial
    • Oblast: USA – západ 2
    • Vyberte Přihlásit se pomocí GitHubu.
    • Pokud se zobrazí výzva, abyste Azure Static Web Apps povolili vytvoření akce GitHubu pro povolení nasazení, vyberte Autorizovat.
    • Organizace: Název vašeho účtu GitHubu
    • Úložiště: aswa-mongoose-tutorial
    • Větev: main
    • Předvolby sestavení: Zvolte React
    • Umístění aplikace: /
    • Umístění rozhraní API: api
    • Umístění výstupu: formulář sestavení

11. Vyberte Zkontrolovat a vytvořit.

12. Vyberte Vytvořit.

13. Proces vytváření chvíli trvá. Po zřízení statické webové aplikace vyberte Přejít k prostředku .

3. Konfigurace připojovacího řetězce databáze

Aby mohla webová aplikace komunikovat s databází, uloží se připojovací řetězec databáze jako nastavení aplikace. Hodnoty nastavení jsou přístupné v Node.js pomocí objektu process.env .

1. V levém horním rohu Azure Portal vyberte Domů (nebo se vraťte na https://portal.azure.com).
2. Vyberte Skupiny prostředků.
3. Vyberte aswa-mongoose.
4. Vyberte název účtu databáze – má typ rozhraní API služby Azure Cosmos DB pro Mongo DB.
5. V části Nastavení vyberte Připojovací řetězec.
6. Zkopírujte připojovací řetězec uvedený v části PRIMÁRNÍ PŘIPOJOVACÍ ŘETĚZEC.
7. V popisu cesty vyberte aswa-mongoose.
8. Výběrem aswa-mongoose-tutorial se vrátíte do instance webu.
9. V části Nastavení vyberte Konfigurace.
10. Vyberte Přidat a vytvořte nové nastavení aplikace s následujícími hodnotami:
    • Název: AZURE_COSMOS_CONNECTION_STRING
    • Hodnota: <Vložte připojovací řetězec, který jste zkopírovali dříve.>
11. Vyberte OK.
12. Vyberte Přidat a vytvořte nové nastavení aplikace s následujícími hodnotami pro název databáze:
    • Název: AZURE_COSMOS_DATABASE_NAME
    • Hodnota: úkol
13. Vyberte OK.
14. Vyberte Uložit.

4. Přejděte na svůj web.

Teď můžete prozkoumat statickou webovou aplikaci.

1. V Azure Portal vyberte Přehled.
2. Vyberte adresu URL zobrazenou v pravém horním rohu.
   1. Vypadá podobně jako https://calm-pond-05fcdb.azurestaticapps.net.
3. Pokud chcete zobrazit seznam úkolů, vyberte Prosím, přihlaste se.
4. Vyberte Udělit souhlas pro přístup k aplikaci.
5. Nový seznam vytvoříte tak, že do textového pole s názvem Vytvořit nový seznam zadáte název a vyberete Uložit.
6. Vytvořte nový úkol zadáním názvu do textového pole s popiskem Vytvořit novou položku a výběrem možnosti Uložit.
7. Ověřte, že se úkol zobrazuje (může to chvíli trvat).
8. Označte úkol jako dokončený výběrem šeku; úkol se přesune do části Dokončené položky na stránce.
9. Aktualizujte stránku a ověřte, že se používá databáze.

Vyčištění prostředků

Pokud tuto aplikaci nebudete dál používat, odstraňte skupinu prostředků pomocí následujících kroků:

1. Vraťte se na Azure Portal.
2. Vyberte Skupiny prostředků.
3. Vyberte aswa-mongoose.
4. Vyberte Odstranit skupinu prostředků.
5. Do textového pole zadejte aswa-mongoose .
6. Vyberte Odstranit.

Další kroky

V dalším článku se dozvíte, jak nakonfigurovat místní vývoj...

Nastavení místního vývoje