공기가 틈새가 있는 환경에서 데이터 API 작성기 배포

이 가이드에서는 인터넷에 액세스하지 않고 환경에서 DAB(Data API Builder)를 설치하고 실행하는 방법을 보여 줍니다. 에어갭 배포는 아웃바운드 네트워크 연결이 제한되거나 금지된 의료, 국방, 금융, 에너지 및 해양 산업 환경에서 일반적입니다.

사전 요구 사항

  • 패키지를 다운로드하기 위한 인터넷 액세스 권한이 있는 컴퓨터("스테이징" 컴퓨터).
  • 지원되는 운영 체제를 갖춘 대상 에어갭 컴퓨터.
  • 컴퓨터 간에 파일을 전송하는 방법(USB 드라이브, 승인된 파일 전송 등).

1단계: 스테이징 머신에서 패키지 다운로드

인터넷에 액세스할 수 있는 컴퓨터에서 필요한 모든 패키지를 다운로드합니다.

.NET 런타임 다운로드

대상 운영 체제용 .NET 9.0 ASP.NET Core 런타임 바이너리 아카이브를 .NET 다운로드 페이지에서 다운로드합니다. 설치 관리자 또는 SDK가 아닌 ASP.NET Core 런타임 이진 보관 파일(Linux의 경우 .tar.gz, Windows .zip)을 선택합니다.

Important

DAB에는 기본 .NET 런타임뿐만 아니라 ASP.NET Core 런타임이 필요합니다. 설치 관리자 없이 압축을 풀 수 있는 ASP.NET Core 바이너리 아카이브를 다운로드합니다.

.zip에서 ASP.NET Core 런타임 다운로드합니다. 대상 플랫폼(x64)에 해당하는 바이너리 열을 선택합니다.

데이터 API 작성기 패키지 다운로드

--tool-path와 함께 dotnet tool install를 사용하여 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

설치 검증

REST API 엔드포인트를 확인하여 DAB가 실행 중인지 확인합니다.

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

MCP 서버 유효성 검사의 경우 상태 엔드포인트가 응답하는지 확인합니다.

curl http://localhost:5000/health

Tip

MCP 도구 호출을 테스트하려면 전체 MCP 프로토콜 초기화 핸드셰이크를 처리하는 MCP 검사 기 또는 MCP 클라이언트 라이브러리를 사용합니다.

네트워크 및 방화벽 고려 사항

  • DAB는 기본적으로 포트 5000 에서 수신 대기합니다. 필요한 경우 ASPNETCORE_URLS로 조정합니다.
  • CORS를 사용하는 경우 dab-config.json에서 허용된 출처를 구성하세요.
  • 런타임에는 아웃바운드 인터넷 액세스가 필요하지 않습니다. DAB는 로컬 또는 네트워크에 액세스할 수 있는 데이터베이스에 대해 전적으로 작동합니다.

관련 콘텐츠

  • Last updated on