Hostování tvůrce rozhraní API pro data ve službě Azure Static Web Apps (Preview)

• Účet Azure s aktivním předplatným. Vytvořit účet zdarma.

• Azure Static Web Apps CLI nainstalovatrozhraní příkazového řádku Static Web Apps (SWA).

• Rozhraní příkazového řádku pro tvůrce dat nainstalujte rozhraní příkazového řádku rozhraní příkazového řádku DAB (Data API Builder).

• Existující podporovaná databáze adresovatelná z Azure.

• Existující webová aplikace v úložišti GitHub, které je možné nasadit do Azure Static Web Apps. - Pokud nemáte webovou aplikaci, vygenerovat úložiště se základní webovou aplikací.

Začněte tak, že pomocí webu Azure Portal vytvoříte novou statickou webovou aplikaci Azure pomocí webové aplikace na GitHubu.

1. Přihlaste se k webu Azure Portal (https://portal.azure.com).

2. Vytvořte novou skupinu prostředků. Tuto skupinu prostředků použijete pro všechny nové prostředky v této příručce.

   

   Spropitné

   Doporučujeme pojme skupinu prostředků msdocs-dab-swa. Všechny snímky obrazovky v této příručce používají tento název.

3. Vytvořte statickou webovou aplikaci Azure. Pomocí těchto nastavení můžete nakonfigurovat statickou webovou aplikaci.

   Nastavení	Hodnota
   skupiny prostředků	Vyberte skupinu prostředků, kterou jste vytvořili dříve.
   názvu	Zadejte globálně jedinečný název.
   typ plánu	Výběr nejlepší možnosti pro vaši úlohu
   zdroje	Výběr GitHubu
   účtu GitHub	Konfigurace účtu GitHubu, který má přístup k úložišti webových aplikací
   organizace	Vyberte nadřazenou organizaci nebo uživatele úložiště.
   úložiště	Vyberte název úložiště.
   větve	Výběr primární větve

   

4. Počkejte na dokončení nasazení statické webové aplikace. Do úložiště se automaticky přidá pracovní postup GitHub Actions, který nasadí aplikaci do Azure Static Web Apps při každém nasdílení změn do primární větve.

   Poznámka

   Toto počáteční nasazení může trvat několik minut. Stav nasazení můžete kdykoli zkontrolovat na webu Azure Portal nebo na kartě GitHub Actions ve vašem úložišti.

5. Na webu Azure Portal přejděte do nové statické webové aplikace.

6. V části Essentials přejděte na spuštěnou webovou aplikaci pomocí adresy URL hypertextového odkazu. Ověřte, že aplikace běží podle očekávání.

Teď pomocí rozhraní příkazového řádku DAB a SWA vytvořte nový konfigurační soubor DAB a přidejte ho do úložiště webové aplikace.

1. Otevřete úložiště GitHub pro webovou aplikaci v integrovaném vývojovém prostředí (IDE) podle vašeho výběru.

   Spropitné

   Můžete použít libovolné integrované vývojové prostředí( IDE), které chcete. Pokud chcete pracovat na aplikaci místně, můžete úložiště naklonovat do místního počítače. Pokud chcete pracovat v prohlížeči, můžete použít GitHub Codespaces. Ujistěte se, že jsou ve vašem vývojovém prostředí nainstalované rozhraní CLI SWA a DAB.

2. Otevřete terminál v kořenovém adresáři úložiště.

3. Pomocí příkazu swa db z rozhraní příkazového řádku SWA můžete inicializovat nový konfigurační soubor DAB pomocí zadaného typu databáze. Příkaz vytvoří nový soubor s názvem staticwebapp.database.config.json ve složce swa-db-connections.

   swa db init --database-type "<database-type>"
   

   Důležitý

   Některé typy databází budou při inicializaci vyžadovat další nastavení konfigurace.

4. Pomocí příkazu dab add přidejte do konfigurace alespoň jednu entitu databáze. Nakonfigurujte každou entitu tak, aby umožňovala všechna oprávnění anonymním uživatelům. Opakujte dab add tolikrát, kolikrát chcete pro své entity.

   dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*" --config "swa-db-connections/staticwebapp.database.config.json"
   

5. Otevřete a zkontrolujte obsah souboru swa-db-connections/staticwebapp.database.config.json.

6. Potvrďte změny do úložiště a nasdílejte je do primární větve. Tím se automaticky aktivuje nové nasazení webové aplikace. Než budete pokračovat v této příručce, počkejte na dokončení tohoto nejnovějšího nasazení.

Dále nakonfigurujte připojení k databázi na webu Azure Portal, aby statická webová aplikace mohla přistupovat k databázi.

1. Na webu Azure Portal znovu přejděte do statické webové aplikace.

2. V části nastavení v nabídce prostředků vyberte možnost Připojení k databázi. Pak vyberte Propojit existující databáze pro produkční prostředí.

   

3. V dialogovém okně Propojit databázi pomocí těchto nastavení nakonfigurujte připojení k databázi.

   Nastavení	Hodnota
   Typ databáze	Vyberte stejný typ databáze, který jste použili při vytváření konfiguračního souboru DAB.
   skupiny prostředků	Vyberte skupinu prostředků, kterou jste vytvořili dříve v této příručce.
   názvu prostředku	Vyberte prostředek databáze, který chcete propojit se statickou webovou aplikací.
   název databáze	Zadejte název databáze.
   typ ověřování	Vyberte typ ověřování, které chcete použít.

   

   Spropitné

   Doporučujeme použít připojovací řetězec, který neobsahuje autorizační klíče. Místo toho použijte spravované identity a řízení přístupu na základě role ke správě přístupu mezi vaší databází a hostitelem. Další informace najdete v tématu služby Azure, které používají spravované identity.

Nakonec ověřte, že je koncový bod datového rozhraní API dostupný ve statické webové aplikaci.

1. Na webu Azure Portal znovu přejděte do statické webové aplikace.

2. Pomocí pole URL v části Essentials přejděte znovu na web statické webové aplikace.

3. Přejděte na /data-api cestu pro aktuální spuštěnou aplikaci. Všimněte si, že odpověď stále indikuje, že kontejner DAB je v pořádku.

   { Healthy }
   

4. Přejděte na https://<your-static-web-app-url>/data-api/<your-rest-path>/<your-entity-name> cestu pro aktuální spuštěnou aplikaci. Tato operace vydá požadavek HTTP GET pro danou sadu entit. Podívejte se na odpověď JSON.

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

1. Přejděte na skupinu prostředků pomocí webu Azure Portal.

2. Na panelu příkazů vyberte Odstranit.