A Data API Builder üzembe helyezése elszigetelt környezetekben

Ez az útmutató bemutatja, hogyan telepítheti és futtathatja a Data API Buildert (DAB) internetes hozzáférés nélküli környezetekben. A légi telepítés gyakori az egészségügyi, védelmi, pénzügyi, energia- és tengeri környezetekben, ahol a kimenő hálózati kapcsolatok korlátozottak vagy tiltottak.

Prerequisites

  • A csomagok letöltéséhez internetkapcsolattal rendelkező gép (az "előkészítési" gép).
  • A célként szolgáló, támogatott operációs rendszert futtató, hálózattól elszigetelt gép.
  • A fájlok gépek közötti átvitelének módja (USB-meghajtó, jóváhagyott fájlátvitel stb.).

1. lépés: Csomagok letöltése az előkészítési gépen

Internet-hozzáféréssel rendelkező gépen töltse le az összes szükséges csomagot.

.NET futtatókörnyezet letöltése

Töltse le a .NET 9.0 ASP.NET Core futtatókörnyezet bináris archívumát a cél operációs rendszer számára a .NET letöltési oldaláról. Válassza a ASP.NET Core Futtatókörnyezet bináris archívumot (linuxos .tar.gz, .zip Windows esetén), ne a telepítőt vagy az SDK-t.

Important

A DAB-nak a ASP.NET Core futtatókörnyezetre van szüksége, nem csak az alap .NET futtatókörnyezetre. Töltse le a ASP.NET Core bináris archívumot, hogy telepítő nélkül is kinyerhető legyen.

Töltse le a ASP.NET Core Runtime .zip.NET 9.0 letöltési oldaláról. Válassza ki a célplatform Bináris fájlok oszlopát (x64).

Data API Builder-csomag letöltése

Használja a(z) dotnet tool install elemet a(z) --tool-path elemmel együtt a DAB és minden függőségének hordozható könyvtárba történő letöltéséhez:

dotnet tool install --tool-path ./dab-tool Microsoft.DataApiBuilder

Ez a parancs létrehoz egy önálló eszközkönyvtárat az összes szükséges fájllal.

2. lépés: Fájlok átvitele az izolált gépre

Másolja ezeket az elemeket a célgépre:

  • A ASP.NET Core Futtatókörnyezet bináris archívuma (.zip vagy .tar.gz)
  • A dab-tool DAB-eszközt és az összes függőséget tartalmazó könyvtár

3. lépés: Telepítés a hálózattól elszigetelt gépen

.NET futtatókörnyezet telepítése

Bontsa ki a futtatókörnyezet bináris archívumát. Nincs szükség telepítőre vagy internet-hozzáférésre.

Expand-Archive -Path "aspnetcore-runtime-9.0.x-win-x64.zip" -DestinationPath "C:\dotnet"
$env:DOTNET_ROOT = "C:\dotnet"
$env:PATH = "C:\dotnet;$env:PATH"

A Data API Builder telepítése

A staging gépről származó dab-tool könyvtár már önmagában is teljes. Adja hozzá a(z) PATH elemhez:

$env:PATH = "C:\path\to\dab-tool;$env:PATH"
dab --version

4. lépés: Konfigurálás és futtatás

  1. Hozza létre a konfigurációs fájlt:

    dab init --database-type mssql --connection-string "Server=<server>;Database=<database>;User ID=<user>;Password=<password>;TrustServerCertificate=true"

  2. Entitások hozzáadása:

    dab add <entity-name> --source <schema>.<table> --permissions "anonymous:*"

  3. A DAB indítása:

    dab start

A telepítés ellenőrzése

Ellenőrizze, hogy fut-e a DAB a REST API-végpont ellenőrzésével:

curl http://localhost:5000/api/<entity-name>

Az MCP-kiszolgáló érvényesítéséhez ellenőrizze, hogy az állapotvégpont válaszol-e:

curl http://localhost:5000/health

Tip

Az MCP-eszközök hívásainak teszteléséhez használja az MCP Inspectort vagy egy MCP-ügyfélkódtárat, amely a teljes MCP protokoll inicializálási kézfogását kezeli.

Hálózati és tűzfal-szempontok

  • A DAB alapértelmezés szerint figyeli a portot 5000 . Szükség esetén állítsa be a beállítási ASPNETCORE_URLS elemet.
  • CORS használata esetén állítsa be az engedélyezett eredeteket a(z) dab-config.json elemben.
  • Futásidőben nincs szükség kimenő internet-hozzáférésre. A DAB teljes mértékben helyi vagy hálózati hozzáférésű adatbázisokon működik.

Kapcsolódó tartalom

  • Last updated on