Ağ bağlantısından yalıtılmış ortamlarda Data API Builder'ı dağıtma

Bu kılavuzda, İnternet erişimi olmayan ortamlarda Veri API'sini oluşturucuyu (DAB) nasıl yükleyip çalıştırabileceğiniz gösterilmektedir. Hava ile eşlenen dağıtımlar, giden ağ bağlantısının kısıtlandığı veya yasaklandığı sağlık, savunma, finans, enerji ve deniz ortamlarında yaygındır.

Prerequisites

  • Paketleri indirmek için İnternet erişimi olan bir makine ("hazırlama" makinesi).
  • Desteklenen bir işletim sistemine sahip hedef yalıtılmış makine.
  • Makineler arasında dosya aktarma yöntemi (USB sürücüsü, onaylı dosya aktarımı vb.).

1. Adım: Hazırlama makinesinde paketleri indirme

İnternet erişimi olan bir makinede tüm gerekli paketleri indirin.

.NET çalışma zamanını indirme

hedef işletim sisteminiz için .NET 9.0 ASP.NET Core çalışma zamanı ikili arşivini .NET indirme sayfasından indirin. yükleyiciyi veya SDK'yı değil, ASP.NET Core Runtime ikili arşivini (Linux için .tar.gz, Windows için .zip) seçin.

Important

DAB, yalnızca temel .NET çalışma zamanını değil ASP.NET Core çalışma zamanını gerektirir. Yükleyici olmadan ayıklanması için ASP.NET Core ikili arşivini indirin.

.NET 9.0 indirme sayfasından ASP.NET Core Runtime .zip indirin. Hedef platformunuz (x64) için İkililer sütununu seçin.

Veri API'sini oluşturucu paketini indirme

DAB'yi ve tüm bağımlılıklarını taşınabilir dizine indirmek için dotnet tool install öğesini --tool-path ile kullanın:

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

Bu komut, tüm gerekli dosyaları içeren bağımsız bir araç dizini oluşturur.

2. Adım: Dosyaları izole makineye aktarın

Bu öğeleri hedef makineye kopyalayın:

  • ASP.NET Core Çalışma Zamanı ikili arşiv dosyası (.zip veya .tar.gz)
  • dab-tool DAB aracını ve tüm bağımlılıkları içeren dizin

3. Adım: Ağdan yalıtılmış makineye yükleyin

.NET çalışma zamanını yükleme

Çalışma zamanı ikili arşiv dosyasını çıkarın. Yükleyici veya İnternet erişimi gerekmez.

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"

Veri API oluşturucusunu yükleyin

Hazırlama ortamındaki makinedeki dab-tool dizini zaten kendine yeterlidir. Bunu PATH ekleyin:

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

4. Adım: Yapılandırma ve çalıştırma

  1. Yapılandırma dosyanızı oluşturun:

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

  2. Varlık ekle:

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

  3. DAB'ı başlat:

    dab start

Yüklemeyi doğrulama

REST API uç noktasını denetleyerek DAB'nin çalıştığını doğrulayın:

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

MCP Sunucusu doğrulaması için sistem durumu uç noktasının yanıt verdiğini doğrulayın:

curl http://localhost:5000/health

Tip

MCP araç çağrılarını test etmek için MCP Denetçisi'ni veya tam MCP protokolü başlatma el sıkışmasını işleyen bir MCP istemci kitaplığı kullanın.

Ağ ve güvenlik duvarı ile ilgili dikkat edilmesi gerekenler

  • DAB varsayılan olarak 5000 bağlantı noktasını dinler. Gerekirse ASPNETCORE_URLS ile ayarlayın.
  • CORS kullanıyorsanız, dab-config.json içinde izin verilen kaynakları yapılandırın.
  • Çalışma zamanında giden İnternet erişimi gerekmez. DAB tamamen yerel veya ağ ile erişilebilir veritabanlarında çalışır.

İlgili içerik

  • Last updated on