Distribuera data-API-byggare i luftgapade miljöer

Den här guiden visar hur du installerar och kör Data API Builder (DAB) i miljöer utan internetåtkomst. Driftsättningar i isolerade miljöer är vanliga inom sjukvård, försvaret, finans, energi och maritima miljöer där utgående nätverksanslutningar är begränsade eller förbjudna.

Förutsättningar

  • En dator med Internetåtkomst för att ladda ned paket ("mellanlagringsdatorn").
  • Den luftgapade måldatorn med ett operativsystem som stöds.
  • En metod för att överföra filer mellan datorer (USB-enhet, godkänd filöverföring osv.).

Steg 1: Ladda ned paket på mellanlagringsdatorn

Ladda ned alla nödvändiga paket på en dator med internetåtkomst.

Ladda ned .NET Runtime

Ladda ned det binära .NET 9.0 ASP.NET Core runtime-arkivet för måloperativsystemet från nedladdningssidan .NET. Välj ASP.NET Core Runtime binärt arkiv (.tar.gz för Linux, .zip för Windows), inte installationsprogrammet eller SDK.

Viktigt!

DAB kräver den ASP.NET Core-körmiljön, inte bara .NET-baskörmiljön. Ladda ned det ASP.NET Core binära arkivet så att det kan extraheras utan installationsprogram.

Ladda ned ASP.NET Core Runtime .zip från nedladdningssidan .NET 9.0. Välj kolumnen Binärfiler för målplattformen (x64).

Ladda ned Data API Builder-paket

Använd dotnet tool install med --tool-path för att ladda ned DAB och alla dess beroenden till en bärbar katalog:

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

Det här kommandot skapar en fristående verktygskatalog med alla nödvändiga filer.

Steg 2: Överföra filer till den luftgapade datorn

Kopiera dessa objekt till måldatorn:

  • Binärt ASP.NET Core Runtime-arkiv (.zip eller .tar.gz)
  • Katalogen dab-tool som innehåller DAB-verktyget och alla beroenden

Steg 3: Installera på den luftgapade datorn

Installera .NET-körmiljö

Extrahera det binära runtime-arkivet. Ingen installationsprogram eller Internetåtkomst krävs.

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"

Installera Data API Builder

Katalogen dab-tool från mellanlagringsdatorn är redan fristående. Lägg till den i din PATH:

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

Steg 4: Konfigurera och köra

  1. Skapa konfigurationsfilen:

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

  2. Lägg till entiteter:

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

  3. Starta DAB:

    dab start

Validera installationen

Kontrollera att DAB körs genom att kontrollera REST API-slutpunkten:

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

För MCP Server-validering kontrollerar du att hälsoslutpunkten svarar:

curl http://localhost:5000/health

Tip

Om du vill testa MCP-verktygsanrop använder du MCP Inspector eller ett MCP-klientbibliotek som hanterar den fullständiga mcp-protokollinitieringshandskakningen.

Nätverks- och brandväggsöverväganden

  • DAB lyssnar på porten 5000 som standard. Justera med ASPNETCORE_URLS om det behövs.
  • Om du använder CORS, konfigurera tillåtna ursprungskällor i din dab-config.json.
  • Ingen utgående internetåtkomst krävs vid körning. DAB fungerar helt mot lokala databaser eller nätverkstillgängliga databaser.

Relaterat innehåll

  • Last updated on