Nasazení Tvůrce rozhraní Data API v prostředích s mezerami vzduchu

V této příručce se dozvíte, jak nainstalovat a spustit Tvůrce rozhraní DATA API (DAB) v prostředích bez přístupu k internetu. Izolovaná nasazení jsou běžná ve zdravotnictví, obraně, financích, energetice a v námořním sektoru, kde je odchozí síťová konektivita omezená nebo zakázaná.

Předpoklady

  • Počítač s přístupem k internetu ke stahování balíčků ("přípravný" počítač).
  • Cílový počítač izolovaný od sítě s podporovaným operačním systémem.
  • Metoda přenosu souborů mezi počítači (USB disk, schválený přenos souborů atd.).

Krok 1: Stažení balíčků na přípravném počítači

Na počítači s přístupem k internetu stáhněte všechny požadované balíčky.

Stažení modulu .NET runtime

Stáhněte binární archiv modulu runtime pro ASP.NET Core v .NET 9.0 pro cílový operační systém ze stránky pro stahování .NET. Zvolte binární archiv ASP.NET Core (.tar.gz pro Linux, .zip pro Windows), nikoli instalační program ani sadu SDK.

Important

DAB vyžaduje běhové prostředí ASP.NET Core, nejen základní běhové prostředí .NET. Stáhněte ASP.NET Core binární archiv, abyste ho mohli extrahovat bez instalačního programu.

Stáhněte ASP.NET Core Runtime .zip ze stránky pro stažení .NET 9.0. Vyberte sloupec Binární soubory pro cílovou platformu (x64).

Stažení balíčku Tvůrce rozhraní Data API

Použijte dotnet tool install s --tool-path ke stažení DAB a všech jeho závislostí do přenosného adresáře:

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

Tento příkaz vytvoří samostatný adresář nástrojů se všemi požadovanými soubory.

Krok 2: Přeneste soubory do izolovaného počítače

Zkopírujte tyto položky do cílového počítače:

  • Binární archiv modulu ASP.NET Core Runtime (.zip nebo .tar.gz)
  • Adresář dab-tool obsahující nástroj DAB a všechny závislosti

Krok 3: Nainstalujte na izolovaný počítač

Instalace modulu runtime .NET

Extrahujte binární archiv modulu runtime. Není vyžadován žádný instalační program ani přístup k internetu.

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"

Instalace tvůrce rozhraní Data API

Adresář dab-tool z testovacího serveru je již kompletní sám o sobě. Přidejte ho do svého PATH:

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

Krok 4: Konfigurace a spuštění

  1. Vytvořte konfigurační soubor:

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

  2. Přidání entit:

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

  3. Spustit DAB:

    dab start

Ověření instalace

Zkontrolujte, jestli je DAB spuštěný, a to kontrolou koncového bodu rozhraní REST API:

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

Při ověřování serveru MCP ověřte, že koncový bod kontroly stavu reaguje:

curl http://localhost:5000/health

Tip

K otestování volání nástrojů MCP použijte nástroj MCP Inspector nebo klientskou knihovnu MCP, která zpracovává úplnou metodu handshake pro inicializaci protokolu MCP.

Důležité informace o síti a bráně firewall

  • DAB ve výchozím nastavení naslouchá na portu 5000 . V případě potřeby upravte pomocí ASPNETCORE_URLS.
  • Pokud používáte CORS, nakonfigurujte povolené zdroje v dab-config.json.
  • Za běhu není vyžadován žádný odchozí přístup k internetu. DAB pracuje zcela s místními databázemi nebo databázemi přístupnými k síti.

Související obsah

  • Last updated on