A Data API Builder üzembe helyezése az Azure Container Instancesben

Az üzembe helyezési útmutató sorrendjében található aktuális hely ('Publish') ábrája.

A Data API Builder gyors üzembe helyezése az Azure-ban csak egy konfigurációs fájllal és egyéni kód nélkül. Ez az útmutató a Data API Builder-tároló lemezképének a Dockerből történő tárolásának lépéseit tartalmazza tárolóként az Azure Container Instancesben.

Ebben az útmutatóban végigvezeti a Data API Builder konfigurációs fájljának létrehozásához, a fájl Azure Filesban való üzemeltetéséhez, majd a fájl Azure Container Instances-tárolóhoz való csatlakoztatásának lépésein.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egy fiókot ingyenesen.
Adat API-építő CLI. Telepítse a parancssori felületet.
Azure parancssori felület (CLI). Telepítse az Azure CLI-t.
Meglévő, az Azure-ból címezhető támogatott adatbázis.

A konfigurációs fájl létrehozása

Első lépésként hozzon létre egy Data API Builder (DAB) konfigurációs fájlt a meglévő adatbázishoz való csatlakozáshoz. Ezt a fájlt később használja a rendszer a végső tárolóval.

Hozzon létre egy üres könyvtárat a helyi gépen a konfigurációs fájl tárolásához.

Új alapkonfigurációs fájl inicializálása a következővel dab init: . Legalább inicializáláskor használja az alábbi beállításokat.

Beállítás	Érték
adatbázistípus	Válasszon egy támogatott adatbázistípust.
Kapcsolati karakterlánc	A függvény használatával `@env()` hivatkozhat a környezeti változóra `DATABASE_CONNECTION_STRING` .

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

Fontos

Egyes adatbázistípusokhoz további konfigurációs beállításokra lesz szükség az inicializáláshoz.

Adjon hozzá legalább egy adatbázis-entitást a konfigurációhoz. Az entitás konfigurálásához használja a dab add parancsot. Konfigurálja az egyes entitásokat úgy, hogy engedélyezve legyen a névtelen felhasználók összes engedélye. Ismételje meg dab add annyiszor, amennyit csak szeretne az entitások esetében.
```
dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"
```
Nyissa meg és tekintse át a dab-config.json fájl tartalmát. Ezt a fájlt az útmutató későbbi részében használhatja.

Gazdagépkonfiguráció az Azure Filesban

Ezután töltse fel a konfigurációs fájlt az Azure Filesban létrehozott fájlmegosztásba. Ez a fájlmegosztás végül kötetként lesz csatlakoztatva a végső tárolóhoz.

Jelentkezzen be az Azure Portalra (https://portal.azure.com).
Új erőforráscsoport létrehozása. Ebben az útmutatóban ezt az erőforráscsoportot fogja használni az összes új erőforráshoz.

Jótanács

Javasoljuk az msdocs-dab-aci erőforráscsoport elnevezését. Az útmutató összes képernyőképe ezt a nevet használja.

Azure Storage-fiók létrehozása. Ezekkel a beállításokkal konfigurálhatja a fiókot.

Beállítás	Érték
Erőforráscsoport	Válassza ki a korábban létrehozott erőforráscsoportot
Tárolófiók neve	Globálisan egyedi név megadása
Régió	Azure-régió kiválasztása
teljesítmény	Válassza Standard
Redundancia	Helyileg redundáns tárolás (LRS) kiválasztása
Tárfiókkulcs-hozzáférés engedélyezése	Válassza az Engedélyezve lehetőséget

Képernyőkép a Tárfiók létrehozása lap Speciális lapjáról az Azure Portalon.

Lépjen az új tárfiókra az Azure Portalon.

Válassza a Fájlmegosztások lehetőséget az erőforrás menü Adattárolás szakaszában. Ezután válassza a Fájlmegosztás lehetőséget a parancssávon egy új megosztás létrehozásához a tárfiókban. Az új fájlmegosztás konfigurálásához használja az alábbi beállításokat.

Beállítás	Érték
Név	Írja be a következő szöveget: `config`
Hozzáférési szint	Válassza a Gyakori elérésű lehetőséget
Biztonsági mentés engedélyezése	Ne válassza

Töltse fel a dab-config.json és minden más szükséges fájlt a megosztásba. A Fájlok feltöltése párbeszédpanel megnyitásához használja a parancssáv Feltöltés lehetőségét. Jelölje ki mindkét fájlt, majd válassza a Feltöltés lehetőséget.
Válassza a Hozzáférési kulcsokat az erőforrás menü Biztonság + hálózatkezelés szakaszában. Ezután jegyezze fel a Storage-fiók nevét és kulcsértékeit erről a lapról. Ezeket az értékeket az útmutató későbbi részében fogja használni.

Az alaptárolópéldány létrehozása

Végül hozza létre a tárolót az Azure-ban az Azure Container Instances használatával. Ez a tároló egy konfigurációs fájllal üzemelteti a Data API Builder-lemezképet az adatbázishoz való csatlakozáshoz.

Fontos

Jelenleg csak az Azure CLI-vel hozhat létre egy csatlakoztatott kötettel rendelkező tárolópéldányt.

Azure Container Instances erőforrás létrehozása a az container create használatával. Ezekkel a beállításokkal konfigurálhatja az erőforrást.

Beállítás	Érték
Erőforráscsoport	A korábban létrehozott erőforráscsoport használata
Tároló neve	Globálisan egyedi név megadása
Régió	Használja ugyanazt a régiót, mint a tárfiók
Termékváltozat	Standard használata
Kép típusa	Használja a Nyilvános-t
kép	Írja be a következő szöveget: `mcr.microsoft.com/azure-databases/data-api-builder:latest`
Operációs rendszer típusa	Linux használata
Hálózat típusa	Használja a Nyilvános-t
Hálózati portok	Írja be a következő szöveget: `5000`
DNS-névfelirat	Globálisan egyedi címke megadása
Környezeti változók	Adja meg a `DATABASE_CONNECTION_STRING` címkét és az adatbázis kapcsolati sztringjét.

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"
    --

Jótanács

Javasoljuk, hogy olyan kapcsolati sztringet használjon, amely nem tartalmaz engedélyezési kulcsokat. Ehelyett használjon felügyelt identitásokat és szerepköralapú hozzáférés-vezérlést az adatbázis és a gazdagép közötti hozzáférés kezeléséhez. További információt a felügyelt identitásokat használó Azure-szolgáltatásokban talál.

Használja a az container show-t az új tárolópéldány teljesen minősített tartománynévének (FQDN) lekérdezéséhez. Ezután böngéssze a tárolópéldányhoz tartozó webhelyet.

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

Figyelje meg a választ, amely azt jelzi, hogy a DAB-tároló fut, és az állapot kifogástalan.
```
{
    "status": "healthy",
    "version": "1.1.7",
    "app-name": "dab_oss_1.1.7"
}
```
Megjegyzés:

A verziószám és a név a Data API Builder aktuális verziójától függően változik. Ezen a ponton nem navigálhat semmilyen API-végponthoz. Ezek a végpontok egy DAB-konfigurációs fájl csatlakoztatása után lesznek elérhetők.
Keresse meg az /api/swagger aktuális futó alkalmazás elérési útját. A Swagger felhasználói felületén http GET-kérést adhat ki az egyik entitásához.

Erőforrások tisztítása

Ha már nincs szüksége a mintaalkalmazásra vagy erőforrásokra, távolítsa el a megfelelő üzembe helyezést és az összes erőforrást.

Lépjen az erőforráscsoportra az Azure Portalon.
A parancssávon válassza a Törlés lehetőséget.

Következő lépés

Integrálás az Application Insights szolgáltatással

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-07-17