서비스 커넥터를 시작하여 Azure Container Apps를 데이터베이스, 스토리지 계정 및 기타 Azure 서비스에 연결합니다. 서비스 커넥터는 인증 및 구성을 간소화하여 관리 ID 또는 기타 인증 방법을 사용하여 리소스에 연결할 수 있도록 합니다.
이 문서에서는 Azure Portal과 Azure CLI 모두에 대한 단계별 지침을 제공합니다. 위의 탭을 사용하여 원하는 방법을 선택합니다.
중요합니다
Azure Container Apps의 Service Connector(미리 보기) 지원은 2026년 3월 30일에 종료됩니다. 해당 날짜 이후 서비스 커넥터(미리 보기)를 사용하는 새 서비스 연결은 인터페이스를 통해 사용할 수 없습니다. 자세한 내용은 사용 중지: Azure Container Apps의 서비스 커넥터(미리 보기)를 참조하세요.
필수 조건
- 활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
- Service Connector에서 지원하는 지역의Container Apps에 배포된 애플리케이션입니다.
- Blob Storage 계정과 같이 Container Apps를 연결할 대상 리소스입니다.
- 서비스 연결을 만들고 관리하는 데 필요한 권한 입니다.
- 활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
- Service Connector에서 지원하는 지역의Container Apps에 배포된 애플리케이션입니다.
- Blob Storage 계정과 같이 Container Apps를 연결할 대상 리소스입니다.
- 서비스 연결을 만들고 관리하는 데 필요한 권한 입니다.
Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.
az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
- 이 빠른 시작에는 Azure CLI 버전 2.30.0 이상이 필요합니다. 최신 버전으로 업그레이드하려면 다음을 실행합니다
az upgrade. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
환경 설정
Service Connector를 처음 사용하는 경우 먼저 az provider register 명령을 실행하여 Service Connector 리소스 공급자를 등록합니다.
az provider register -n Microsoft.ServiceLinker팁 (조언)
명령을
az provider show -n "Microsoft.ServiceLinker" --query registrationState실행하여 리소스 공급자가 이미 등록되었는지 확인할 수 있습니다. 출력이Registered면 Service Connector가 이미 등록되어 있습니다.필요에 따라 az containerapp connection list-support-types 명령을 실행하여 Container Apps에 대해 지원되는 대상 서비스 목록을 가져옵니다.
az containerapp connection list-support-types --output table
서비스 연결 만들기(미리 보기)
서비스 커넥터를 사용하여 Azure Container Apps와 Azure Blob Storage 간에 서비스 연결을 만듭니다. 이 예제에서는 Blob Storage에 연결하는 방법을 보여 주지만 지원되는 다른 Azure 서비스에 동일한 프로세스를 사용할 수 있습니다.
Azure Portal 맨 위에 있는 리소스, 서비스, 문서 검색(G +/) 검색 창을 선택하고 필터에 Container Apps를 입력하고 Container Apps를 선택합니다.
대상 리소스에 연결하려는 Container Apps 리소스의 이름을 선택합니다.
왼쪽 목차에서 서비스 커넥터(미리 보기)를 선택합니다. 다음으로 만들기를 선택합니다.
기본 사항 탭에서 다음 설정을 선택하거나 입력합니다.
설정 예제 설명 컨테이너 my-container-app 컨테이너 앱의 컨테이너입니다. 서비스 종류 스토리지 - Blob 컨테이너 앱에 연결하려는 서비스 유형입니다. 구독 my-subscription 연결하려는 서비스가 포함된 구독입니다. 기본값은 이 컨테이너 앱이 포함된 구독입니다. 연결 이름 storageblob_700ae 컨테이너 앱과 대상 서비스 간의 연결을 식별하는 연결 이름입니다. 서비스 커넥터에서 제공하는 연결 이름을 사용하거나 사용자 고유의 연결 이름을 선택합니다. 스토리지 계정 my-storage-account 연결하려는 대상 스토리지 계정입니다. 다른 서비스 유형을 선택하는 경우 해당하는 대상 서비스 인스턴스를 선택합니다. 클라이언트 유형 .NET 선택한 대상 서비스에서 작동하는 애플리케이션 스택입니다. 기본값은 구성 목록을 생성하는 None입니다. 선택한 앱 스택 또는 클라이언트 SDK를 알고 있는 경우 클라이언트 유형에 대해 동일한 앱 스택을 선택합니다. 다음: 인증을 선택하여 인증 방법을 선택합니다. 선택할 수 있는 인증 방법으로는 SMI(시스템이 할당한 관리 ID), UMI(사용자가 할당한 관리 ID), 연결 문자열, 서비스 주체가 있습니다.
시스템이 할당한 관리 ID를 선택하여 Microsoft Entra ID에서 자동으로 생성되고 서비스 인스턴스 수명 주기에 연결된 ID를 통해 연결합니다. 권장 인증 옵션입니다.
다음: 네트워킹을 선택하여 네트워크 구성을 선택하고, 컨테이너 앱이 Blob Storage에 액세스할 수 있도록 대상 서비스에 대한 액세스를 사용하도록 방화벽 규칙 구성을 선택합니다.
그런 후 다음: 검토 + 만들기를 선택하여 제공된 정보를 검토합니다. 최종 유효성 검사를 실행하는 데 몇 초 정도 걸립니다.
만들기를 선택하여 서비스 연결을 만듭니다. 이 작업을 완료하려면 최대 1분이 걸릴 수 있습니다.
az containerapp connection create 명령을 실행하여 시스템 할당 관리 ID를 사용하여 Container Apps에서 Blob Storage로 서비스 연결을 만듭니다. 다음 두 가지 방법으로 이 명령을 실행할 수 있습니다.
새 연결을 단계별로 생성합니다.
az containerapp connection create storage-blob --system-identity한 번에 새 연결을 생성합니다. 자리 표시자를 사용자 고유의 정보
<source-subscription>인 , ,<source_resource_group><app>,<target-subscription><target_resource_group>및<account>.az containerapp connection create storage-blob \ --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \ --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \ --system-identity
팁 (조언)
Blob Storage 계정이 없는 경우 실행 az containerapp connection create storage-blob --new --system-identity 하여 계정을 만들고 관리 ID를 사용하여 컨테이너 앱에 연결합니다.
서비스 연결 보기
Container Apps 연결은 설정 > 서비스 커넥터(미리 보기) 아래에 표시됩니다. >을 선택하여 목록을 확장하고 애플리케이션에 필요한 속성을 확인합니다.
연결을 선택한 다음, 유효성을 검사하여 서비스 커넥터에 연결을 확인하라는 메시지를 표시합니다.
자세한 정보를 선택하여 연결 유효성 검사 세부 정보를 검토합니다.
az containerapp connection list 명령을 실행하여 모든 컨테이너 앱의 프로비전된 연결을 나열합니다. 자리 표시자와 <container-app-resource-group><container-app-name> 아래 명령에서 사용자 고유의 정보로 바꿉다. 연결에 --output table 대한 자세한 정보를 볼 수 있는 옵션을 제거할 수도 있습니다.
az containerapp connection list --resource-group "<container-app-resource-group>" --name "<container-app-name>" --output table
출력에는 연결의 프로비전 상태도 표시됩니다.
관련 콘텐츠
Service Connector에 대한 자세한 내용은 다음 가이드를 참조하세요.