Развертывание конструктора Data API в изолированных средах

В этом руководстве показано, как установить и запустить построитель API данных (DAB) в средах без доступа к Интернету. Изолированные развёртывания распространены в здравоохранении, обороне, финансах, энергетике и морской отрасли, где исходящие сетевые подключения ограничены или запрещены.

Необходимые условия

  • Компьютер с доступом к Интернету для скачивания пакетов (промежуточный компьютер).
  • Целевой компьютер, изолированный от сети, с поддерживаемой операционной системой.
  • Метод передачи файлов между компьютерами (USB-диск, утвержденный перенос файлов и т. д.).

Шаг 1. Скачивание пакетов на промежуточном компьютере

На компьютере с доступом к Интернету скачайте все необходимые пакеты.

Скачивание среды выполнения .NET

Скачайте архив с двоичными файлами среды выполнения ASP.NET Core .NET 9.0 для вашей целевой операционной системы со страницы загрузки .NET. Выберите двоичный архив ASP.NET Core Runtime (.tar.gz для Linux, .zip для Windows), а не установщик или SDK.

Important

ДЛЯ DAB требуется среда выполнения ASP.NET Core, а не только базовая среда выполнения .NET. Скачайте двоичный архив ASP.NET Core, чтобы его можно было извлечь без установщика.

Скачайте среду выполнения ASP.NET Core .zip со страницы загрузки .NET 9.0. Выберите столбец Binaries для нужной вам платформы (x64).

Скачать пакет построителя Data API

Используйте dotnet tool install с --tool-path, чтобы скачать DAB и все его зависимости в переносной каталог:

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

Эта команда создает автономный каталог инструментов со всеми необходимыми файлами.

Шаг 2: Перенесите файлы на изолированный компьютер

Скопируйте эти элементы на целевой компьютер:

  • Двоичный архив среды выполнения ASP.NET Core (.zip или .tar.gz)
  • dab-tool Каталог, содержащий средство DAB и все зависимости

Шаг 3: Установка на изолированном компьютере

Установка среды выполнения .NET

Извлеките двоичный архив среды выполнения. Установщик или доступ к Интернету не требуется.

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"

Установка построителя API данных

Каталог dab-tool со стейджинг-сервера уже самодостаточен. Добавьте это в PATH:

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

Шаг 4. Настройка и запуск

  1. Создайте файл конфигурации:

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

  2. Добавление сущностей:

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

  3. Запустите DAB:

    dab start

Проверка установки

Убедитесь, что DAB запущен, проверив конечную точку REST API:

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

Для проверки сервера MCP убедитесь, что конечная точка проверки работоспособности отвечает:

curl http://localhost:5000/health

Tip

Чтобы протестировать вызовы инструментов MCP, используйте MCP Inspector или клиентскую библиотеку MCP, которая поддерживает полное рукопожатие инициализации протокола MCP.

Рекомендации по сети и брандмауэру

  • DAB прослушивает порт 5000 по умолчанию. При необходимости настройте с помощью ASPNETCORE_URLS.
  • Если вы используете CORS, настройте список разрешённых источников в dab-config.json.
  • Во время выполнения исходящий доступ к Интернету не требуется. DAB полностью работает с локальными или сетевыми базами данных.

Связанный контент

  • Last updated on