Bereitstellen des Daten-API-Generators in luftgespaltenen Umgebungen

In diesem Handbuch erfahren Sie, wie Sie den Daten-API-Generator (DATA API Builder, DAB) in Umgebungen ohne Internetzugang installieren und ausführen. Air-Gap-Bereitstellungen sind im Gesundheitswesen, in der Verteidigung, im Finanzwesen, im Energiesektor und in maritimen Umgebungen üblich, in denen ausgehende Netzwerkverbindungen eingeschränkt oder untersagt sind.

Voraussetzungen

• Ein Computer mit Internetzugang zum Herunterladen von Paketen (dem "Staging"-Computer).
• Der luftgespaltene Zielcomputer mit einem unterstützten Betriebssystem.
• Eine Methode zum Übertragen von Dateien zwischen Computern (USB-Laufwerk, genehmigte Dateiübertragung usw.).

Schritt 1: Herunterladen von Paketen auf dem Stagingcomputer

Laden Sie auf einem Computer mit Internetzugang alle erforderlichen Pakete herunter.

Download der .NET-Runtime

Laden Sie das .NET 9.0 ASP.NET Core-Laufzeit-Binärarchiv für Ihr Zielbetriebssystem von der downloadseite .NET herunter. Wählen Sie das ASP.NET Core Runtime Binärarchiv (.tar.gz für Linux, .zip für Windows) und nicht das Installationsprogramm oder SDK aus.

Herunterladen des Daten-API-Generator-Pakets

Verwenden Sie dotnet tool install mit --tool-path, um DAB und alle seine Abhängigkeiten in ein tragbares Verzeichnis herunterzuladen:

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

Mit diesem Befehl wird ein eigenständiges Toolverzeichnis mit allen erforderlichen Dateien erstellt.

Schritt 2: Übertragen von Dateien auf den luftgespaltenen Computer

Kopieren Sie diese Elemente auf den Zielcomputer:

• Das ASP.NET Core Runtime-Binärarchiv (.zip oder .tar.gz)
• Das dab-tool Verzeichnis, das das DAB-Tool und alle Abhängigkeiten enthält

Schritt 3: Auf der isolierten Maschine installieren

.NET Runtime installieren

Entpacken Sie das Laufzeit-Binärarchiv. Es ist kein Installationsprogramm oder Internetzugriff erforderlich.

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"

mkdir -p /opt/dotnet
tar -xzf aspnetcore-runtime-9.0.x-linux-x64.tar.gz -C /opt/dotnet
export DOTNET_ROOT="/opt/dotnet"
export PATH="/opt/dotnet:$PATH"

Installieren des Daten-API-Generators

Das dab-tool Verzeichnis vom Staging-Computer ist bereits in sich geschlossen. Fügen Sie es zu Ihrem PATH:

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

export PATH="/path/to/dab-tool:$PATH"
dab --version

Schritt 4: Konfigurieren und Ausführen

1. Erstellen Sie Ihre Konfigurationsdatei:

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

2. Entitäten hinzufügen:

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

3. Starten Sie DAB:

   dab start
   

Testen der Installation

Überprüfen Sie, ob DAB ausgeführt wird, indem Sie den REST-API-Endpunkt überprüfen:

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

Prüfen Sie zur Validierung des MCP-Servers, ob der Health-Endpunkt antwortet:

curl http://localhost:5000/health

Überlegungen zu Netzwerk und Firewall

• DAB überwacht standardmäßig den Port 5000 . Passen Sie dies bei Bedarf mit ASPNETCORE_URLS an.
• Wenn Sie CORS verwenden, konfigurieren Sie zulässige Ursprünge in Ihrer dab-config.json.
• Zur Laufzeit ist kein ausgehender Internetzugriff erforderlich. DAB arbeitet ausschließlich mit lokalen oder über das Netzwerk zugänglichen Datenbanken.

Verwandte Inhalte

• Ausführen in einem Docker-Container
• Installieren der CLI
• Portauflösung