Azure Container Instances에 데이터 API 작성기 배포

배포 가이드 시퀀스의 현재 위치('게시')를 다이어그램으로 표시합니다.

구성 파일만 사용하고 사용자 지정 코드가 없는 Azure에 Data API Builder를 신속하게 배포합니다. 이 가이드에는 Docker에서 Azure Container Instances의 컨테이너로 데이터 API 작성기 컨테이너 이미지를 호스트하는 단계가 포함되어 있습니다.

이 가이드에서는 데이터 API 작성기 구성 파일을 빌드하고, Azure Files에서 파일을 호스트한 다음, Azure Container Instances의 컨테이너에 파일을 탑재하는 단계를 안내합니다.

필수 조건

활성 구독이 있는 Azure 계정. 무료로 계정을 만듭니다.
데이터 API 작성기 CLI. CLI를 설치합니다.
Azure CLI. Azure CLI를 설치합니다.
Azure에서 주소 지정 가능한 기존 지원 데이터베이스입니다.

구성 파일 빌드

시작하려면 DAB(Data API Builder) 구성 파일을 빌드하여 기존 데이터베이스에 연결합니다. 이 파일은 나중에 최종 컨테이너와 함께 사용됩니다.

로컬 컴퓨터에 빈 디렉터리를 만들어 구성 파일을 저장합니다.

를 사용하여 dab init새 기본 구성 파일을 초기화합니다. 초기화 시 최소한 다음 설정을 사용합니다.

설정	가치
데이터베이스 유형	지원되는 데이터베이스 유형을 선택합니다.
연결 문자열	함수를 `@env()` 사용하여 환경 변수를 참조합니다 `DATABASE_CONNECTION_STRING` .

dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"

중요합니다

일부 데이터베이스 유형은 초기화 시 추가 구성 설정이 필요합니다.

구성에 하나 이상의 데이터베이스 엔터티를 추가합니다. 명령을 dab add 사용하여 엔터티를 구성합니다. 익명 사용자에 대한 모든 권한을 허용하도록 각 엔터티를 구성합니다. 원하는 만큼 엔터티에 대해 dab add를 반복합니다.
```
dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"
```
dab-config.json 파일의 내용을 열고 검토합니다. 이 파일은 이 가이드의 뒷부분에서 사용합니다.

Azure Files의 호스트 구성

다음으로, 구성 파일을 Azure Files 내에서 만든 파일 공유에 업로드합니다. 이 파일 공유는 결국 볼륨으로 최종 컨테이너에 탑재됩니다.

Azure Portal(https://portal.azure.com)에 로그인합니다.
새 리소스 그룹을 만듭니다. 이 가이드의 모든 새 리소스에 대해 이 리소스 그룹을 사용합니다.

팁 (조언)

리소스 그룹 msdocs-dab-aci의 이름을 지정하는 것이 좋습니다. 이 가이드의 모든 스크린샷은 이 이름을 사용합니다.

Azure Storage 계정을 만듭니다. 이러한 설정을 사용하여 계정을 구성합니다.

설정	가치
리소스 그룹	이전에 만든 리소스 그룹을 선택합니다.
스토리지 계정 이름	전역적으로 고유한 이름 입력
지역	Azure 지역 선택
성능	표준 선택
중복	LRS(로컬 중복 스토리지)를 선택합니다.
스토리지 계정 키 액세스 사용	활성화 선택

Azure Portal의 '스토리지 계정 만들기' 페이지의 '고급' 탭 스크린샷

Azure Portal에서 새 스토리지 계정으로 이동합니다.
리소스 메뉴의 데이터 스토리지 섹션에서 파일 공유를 선택합니다. 그런 다음, 명령 모음에서 파일 공유 를 선택하여 스토리지 계정에 새 공유를 만듭니다. 다음 설정을 사용하여 새 파일 공유를 구성합니다.

설정 가치

이름 config을 입력합니다.

액세스 계층 뜨거운 선택

백업 사용 선택 안 함
dab-config.json 및 기타 필요한 파일을 공유에 업로드합니다. 명령 모음의 업로드 옵션을 사용하여 파일 업로드 대화 상자를 엽니다. 두 파일을 모두 선택한 다음 업로드를 선택합니다.
리소스 메뉴의 보안 + 네트워킹 섹션에서 액세스 키를 선택합니다. 그런 다음, 이 페이지에서 Storage 계정 이름 및 키 값을 기록합니다. 이 가이드의 뒷부분에서 이러한 값을 사용합니다.

설정	가치
이름	`config`을 입력합니다.
액세스 계층	뜨거운 선택
백업 사용	선택 안 함

기본 컨테이너 인스턴스 만들기

마지막으로 Azure Container Instances를 사용하여 Azure에서 컨테이너를 만듭니다. 이 컨테이너는 데이터베이스에 연결할 구성 파일을 사용하여 Data API 작성기 이미지를 호스팅합니다.

중요합니다

현재 탑재된 볼륨을 사용하여 컨테이너 인스턴스를 만드는 유일한 방법은 Azure CLI를 사용하는 것입니다.

를 사용하여 az container createAzure Container Instances 리소스를 만듭니다. 이러한 설정을 사용하여 리소스를 구성합니다.

설정	가치
리소스 그룹	이전에 만든 리소스 그룹 사용
컨테이너 이름	전역적으로 고유한 이름 입력
지역	스토리지 계정과 동일한 지역 사용
SKU	표준 사용
이미지 유형	공용 사용
이미지	`mcr.microsoft.com/azure-databases/data-api-builder:latest`을 입력합니다.
OS 종류	Linux 사용
네트워킹 유형	공용 사용
네트워킹 포트	`5000`을 입력합니다.
DNS 이름 레이블	전역적으로 고유한 레이블 입력
환경 변수	`DATABASE_CONNECTION_STRING` 및 데이터베이스에 대한 연결 문자열을 입력합니다.

az container create \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --image "mcr.microsoft.com/azure-databases/data-api-builder:latest" \
    --location "<region>" \
    --sku "Standard" \
    --os-type "Linux" \
    --ip-address "public" \
    --ports "5000" \
    --dns-name-label "<unique-dns-label>" \
    --environment-variables "DATABASE_CONNECTION_STRING=<database-connection-string>" \
    --azure-file-volume-mount-path "/cfg" \
    --azure-file-volume-account-name "<storage-account-name>" \
    --azure-file-volume-account-key "<storage-account-key>" \
    --azure-file-volume-share-name "config" \
    --command-line "dotnet Azure.DataApiBuilder.Service.dll --ConfigFileName /cfg/dab-config.json"
    --

팁 (조언)

권한 부여 키를 포함하지 않는 연결 문자열을 사용하는 것이 좋습니다. 대신 관리 ID 및 역할 기반 액세스 제어를 사용하여 데이터베이스와 호스트 간의 액세스를 관리합니다. 자세한 내용은 관리 ID를 사용하는 Azure 서비스를 참조하세요.

새 컨테이너 인스턴스에 대한 FQDN(정규화된 도메인 이름)을 쿼리하는 데 사용합니다 az container show . 그런 다음 컨테이너 인스턴스의 웹사이트에 접속하세요.
```
az container show \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --query "join('://', ['https', ipAddress.fqdn])" \
    --output "tsv"
```
DAB 컨테이너가 실행 중이며 상태가 정상임을 나타내는 응답을 관찰 합니다.
```
{
    "status": "healthy",
    "version": "1.1.7",
    "app-name": "dab_oss_1.1.7"
}
```
비고

버전 번호와 이름은 현재 버전의 Data API Builder에 따라 달라집니다. 이 시점에서는 API 엔드포인트로 이동할 수 없습니다. DAB 구성 파일을 탑재하면 이러한 엔드포인트를 사용할 수 있습니다.
현재 실행 중인 애플리케이션의 /api/swagger 경로로 이동합니다. Swagger UI를 사용하여 엔터티 중 하나에 대한 HTTP GET 요청을 실행합니다.

자원을 정리하세요

샘플 애플리케이션 또는 리소스가 더 이상 필요하지 않은 경우 해당 배포 및 모든 리소스를 제거합니다.

Azure Portal을 사용하여 리소스 그룹으로 이동합니다.
명령 모음에서 삭제를 선택합니다.

다음 단계

Application Insights와 통합

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-07-17