Nasazení Tvůrce rozhraní Data API do Azure Container Apps

Diagram posloupnosti průvodce nasazením, včetně těchto umístění, v uvedeném pořadí: Přehled, Plán, Příprava, Publikování, Monitorování a Optimalizace Místo "Publikovat" je aktuálně zvýrazněno.

Požadavky

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

• Rozhraní příkazového řádku pro tvorbu API dat. Nainstalujte rozhraní příkazového řádku.

• Azure CLI. Nainstalujte Azure CLI.

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

Sestavení konfiguračního souboru

Začněte tím, že sestavíte konfigurační soubor DAB (Data API Builder) pro připojení k existující databázi. Tento soubor se použije později s konečným kontejnerem.

1. Vytvořte na místním počítači prázdný adresář pro uložení konfiguračního souboru.

2. Inicializace nového základního konfiguračního souboru pomocí dab init. Při inicializaci použijte minimálně následující nastavení.

   Nastavení	Hodnota
   Typ databáze	Vyberte podporovaný typ databáze.
   Připojovací řetězec	@env() Pomocí funkce můžete odkazovat na proměnnou DATABASE_CONNECTION_STRING prostředí.

   dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"
   

   Důležité

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

3. Přidejte do konfigurace aspoň jednu entitu databáze. dab add Pomocí příkazu nakonfigurujte entitu. 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:*"
   

4. Otevřete a zkontrolujte obsah souboru dab-config.json . Tento soubor použijete dále v tomto průvodci.

Konfigurace hostitele ve službě Azure Files

Dále nahrajte konfigurační soubor do sdílené složky vytvořené v rámci služby Azure Files. Tento sdílený úložný prostor se nakonec připojí ke konečnému kontejneru jako svazek.

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.

   

   Návod

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

3. Vytvořit účet služby Azure Storage Pomocí těchto nastavení nakonfigurujte účet.

   Nastavení	Hodnota
   Skupina zdrojů	Vyberte skupinu prostředků, kterou jste vytvořili dříve.
   Název účtu úložiště	Zadejte globálně jedinečný název.
   Oblast	Výběr oblasti Azure
   výkon	Vybrat standard
   Nadbytečnost	Výběr místně redundantního úložiště (LRS)
   Povolení přístupu ke klíči účtu úložiště	Vyberte Zapnuto

   

4. Přejděte na nový účet úložiště na webu Azure Portal.

5. V části Úložiště dat v nabídce prostředků vyberte Sdílené složky. Potom na panelu příkazů vyberte Sdílená složka a vytvořte novou sdílenou složku v účtu úložiště. Pomocí následujících nastavení nakonfigurujte novou sdílenou složku.

   Nastavení	Hodnota
   název	Zadejte config
   Úroveň přístupu	Vyberte Hot
   Povolení zálohování	Nevybírejte

   

6. Nahrajte dab-config.json a všechny další požadované soubory do sdílené složky. Pomocí možnosti Nahrát na panelu příkazů otevřete dialogové okno Nahrát soubory . Vyberte oba soubory a pak vyberte Nahrát.

   

7. V části Zabezpečení a sítě v nabídce prostředků vyberte Přístupové klíče. Potom na této stránce poznamenejte název účtu úložiště a hodnoty klíče . Tyto hodnoty použijete později v tomto průvodci.

   

Vytvoření základní aplikace kontejneru

Teď vytvořte kontejner v Azure pomocí Azure Container Apps. Tento kontejner hostuje image Tvůrce rozhraní Data API bez konfigurace.

1. Vytvořte prostředek Azure Container Apps. V rámci procesu vytváření prostředku aplikace budete muset vytvořit prostředí. Tato nastavení použijte ke konfiguraci obou prostředků.

   Zdroj	Nastavení	Hodnota
   Prostředí	název prostředí	Zadejte globálně jedinečný název.
   Prostředí	Typ prostředí	Vybrat pouze spotřebu
   Prostředí	Cíl protokolů	Vyberte Neukládat protokoly.
   Aplikace	Skupina zdrojů	Vyberte skupinu prostředků, kterou jste vytvořili dříve.
   Aplikace	Název účtu úložiště	Zadejte globálně jedinečný název.
   Aplikace	Oblast	Vyberte stejnou oblast jako účet úložiště.
   Aplikace	Použití obrázku rychlého startu	Nevybírejte
   Aplikace	Zdroj obrázku	Výběr Centra Dockeru nebo jiných registrů
   Aplikace	Typ obrázku	Vyberte Veřejný.
   Aplikace	Přihlašovací server registru	Zadejte mcr.microsoft.com
   Aplikace	Obrázek a značka	Zadejte azure-databases/data-api-builder:latest
   Aplikace	Proměnné prostředí – Název	Zadejte DATABASE_CONNECTION_STRING
   Aplikace	Proměnné prostředí – hodnota	Zadejte připojovací řetězec pro vaši databázi.
   Aplikace	Vstup	Ujistěte se, že je vybraná možnost Povoleno.
   Aplikace	Příchozí provoz	Vyberte Přijímání provozu odkudkoli
   Aplikace	Režim klientského certifikátu	Vyberte Ignorovat
   Aplikace	Typ příchozího přenosu dat	Vyberte HTTP.
   Aplikace	Cílový port	Zadejte 5000

   

   

   Návod

   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.

2. Na webu Azure Portal přejděte do nové aplikace kontejneru.

3. Pomocí pole Adresa URL aplikace v části Základy přejděte na web aplikace kontejneru. Sledujte odpověď, která indikuje, že je kontejner DAB spuštěný a stav je v pořádku.

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

   Poznámka:

   Číslo a název verze se budou lišit v závislosti na vaší aktuální verzi tvůrce rozhraní Data API. V tomto okamžiku nemůžete přejít na žádné koncové body rozhraní API. Tyto koncové body budou k dispozici po připojení konfiguračního souboru DAB.

Připojení konfiguračních souborů

Nakonec připojte konfigurační soubory ze sdílené složky Azure Ke kontejnerové aplikaci. Tento krok umožňuje tvůrci rozhraní Data API použít konfigurační soubor pro připojení k databázi.

1. Pomocí webu Azure Portal přejděte do prostředí kontejneru vytvořeného dříve v této příručce.

2. V části Nastavení nabídky prostředků vyberte soubory Azure. Potom na panelu příkazů vyberte Přidat a přidejte existující sdílenou složku do prostředí kontejneru. Pomocí následujících nastavení nakonfigurujte novou sdílenou složku. Potom uložte novou konfiguraci sdílené složky.

   Nastavení	Hodnota
   název	Zadejte config-share
   Název účtu úložiště	Název účtu úložiště zaznamenaného dříve v této příručce.
   Klíč účtu úložiště	Klíč účtu úložiště zaznamenaného dříve v této příručce.
   Sdílení souborů	Zadejte config
   Režim přístupu	Vybrat Pouze pro čtení

   

3. Na webu Azure Portal znovu přejděte do aplikace kontejneru.

4. V části Aplikace v nabídce prostředků vyberte Revize a repliky. Potom na panelu příkazů vyberte Vytvořit novou revizi a spusťte proces konfigurace nové revize pro vaši aplikaci kontejneru.

5. Přejděte do části Svazky a vyberte možnost Přidat. Použijte následující nastavení ke konfiguraci nového svazku. Po nakonfigurování svazku přidejte svazek do revize kontejneru.

   Nastavení	Hodnota
   Typ svazku	Vyberte svazek souborů Azure
   název	Zadejte config-volume
   Sdílení souborů	Zadejte config

   

6. Přejděte do části Kontejner , vyberte jeden aktuální kontejner a pak vyberte možnost Upravit . Ke konfiguraci dvou připojení pro kontejner použijte následující nastavení. Uložte provedené změny.

   Nastavení	Hodnota
   Název svazku	Zadejte config-volume
   Přípojná cesta	Zadejte /App/dab-config.json
   Dílčí cesta	Zadejte dab-config.json

   Nastavení	Hodnota
   Název svazku	Zadejte config-volume
   Přípojná cesta	Zadejte /App/schema.graphql
   Dílčí cesta	Zadejte schema.graphql

   

7. Vyberte Vytvořit pro vytvoření nové revize s připojenými svazky, které jste zadali. Pokud chcete dokončit nasazení, proveďte revizi.

8. Pomocí pole Adresa URL aplikace v části Základy přejděte znovu na web aplikace kontejneru. Všimněte si, že odpověď stále značí, že kontejner DAB je v pořádku.

9. Přejděte na /api/swagger cestu pro aktuální spuštěnou aplikaci. Pomocí uživatelského rozhraní Swagger můžete vydat požadavek HTTP GET pro jednu z vašich entit.

Upravte zdroje

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

1. Pomocí webu Azure Portal přejděte do skupiny prostředků .

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

Další krok

Integrace s Application Insights