Nasazení Tvůrce rozhraní Data API do služby Azure Container Instances

Diagram aktuální pozice (Publikovat) v pořadí kroků průvodce nasazením

Rychle nasaďte tvůrce rozhraní Data API do Azure pomocí konfiguračního souboru a bez vlastního kódu. Tato příručka obsahuje kroky pro hostování image kontejneru Tvůrce rozhraní Data API z Dockeru jako kontejneru ve službě Azure Container Instances.

V této příručce si projděte postup sestavení konfiguračního souboru tvůrce rozhraní Data API, hostování souboru v Azure Files a následné připojení souboru ke kontejneru ve službě Azure Container Instances.

Požadavky

Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
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.

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

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.

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:*"
```
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.

Přihlaste se k webu Azure Portal (https://portal.azure.com).
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-aci. Všechny snímky obrazovky v této příručce používají tento název.

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

Snímek obrazovky karty 'Upřesnit' na stránce 'Vytvořit účet úložiště' v portálu Azure.

Přejděte na nový účet úložiště na webu Azure Portal.
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
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.
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.

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

Vytvoření základní instance kontejneru

Nakonec vytvořte kontejner v Azure pomocí služby Azure Container Instances. Tento kontejner hostuje image Tvůrce rozhraní Data API s konfiguračním souborem pro připojení k databázi.

Důležité

V současnosti je jediným způsobem, jak vytvořit instanci kontejneru s připojeným svazkem, použití Azure CLI.

Vytvoření prostředku Azure Container Instances pomocí az container create. Pomocí těchto nastavení nakonfigurujte prostředek.

Nastavení	Hodnota
Skupina zdrojů	Použijte skupinu prostředků, kterou jste vytvořili dříve.
Název kontejneru	Zadejte globálně jedinečný název.
Oblast	Použijte stejnou oblast jako účet úložiště.
SKU	Použití standardu
Typ obrázku	Použít veřejný
Obrázek	Zadejte `mcr.microsoft.com/azure-databases/data-api-builder:latest`
Typ operačního systému	Použití Linuxu
Typ sítě	Použít veřejný
Síťové porty	Zadejte `5000`
Popisek názvu DNS	Zadejte globálně jedinečný popisek.
Proměnné prostředí	Zadejte `DATABASE_CONNECTION_STRING` a připojovací řetězec pro vaši databázi.

az container create \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --image "mcr.microsoft.com/azure-databases/data-api-builder:latest" \
    --location "<region>" \
    --sku "Standard" \
    --os-type "Linux" \
    --ip-address "public" \
    --ports "5000" \
    --dns-name-label "<unique-dns-label>" \
    --environment-variables "DATABASE_CONNECTION_STRING=<database-connection-string>" \
    --azure-file-volume-mount-path "/cfg" \
    --azure-file-volume-account-name "<storage-account-name>" \
    --azure-file-volume-account-key "<storage-account-key>" \
    --azure-file-volume-share-name "config" \
    --command-line "dotnet Azure.DataApiBuilder.Service.dll --ConfigFileName /cfg/dab-config.json"
    --

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.

Slouží az container show k dotazování plně kvalifikovaného názvu domény (FQDN) pro novou instanci kontejneru. Pak přejděte na web instance kontejneru.

az container show \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --query "join('://', ['https', ipAddress.fqdn])" \
    --output "tsv"

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ř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.

Vyčistěte zdroje

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

Pomocí webu Azure Portal přejděte do skupiny prostředků .
Na panelu příkazů vyberte Odstranit.

Další krok

Integrace s Application Insights

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-07-17