서비스 커넥터를 시작하여 Azure Functions를 데이터베이스, 스토리지 계정 및 기타 Azure 서비스에 연결합니다. 서비스 커넥터는 인증 및 구성을 간소화하여 관리 ID 또는 기타 인증 방법을 사용하여 리소스에 연결할 수 있도록 합니다.
이 문서에서는 Azure Portal과 Azure CLI 모두에 대한 단계별 지침을 제공합니다. 위의 탭을 사용하여 원하는 방법을 선택합니다.
필수 조건
- 활성 구독이 있는 Azure 계정. 무료로 계정을 만듭니다.
- Service Connector에서 지원하는 지역의 함수 앱입니다. 아직 없는 경우 만드세요.
- Blob Storage 계정과 같이 함수 앱을 연결할 대상 리소스입니다.
- 서비스 연결을 만들고 관리하는 데 필요한 권한 입니다.
- 활성 구독이 있는 Azure 계정. 무료로 계정을 만듭니다.
- Service Connector에서 지원하는 지역의 함수 앱입니다. 아직 없는 경우 만드세요.
- Blob Storage 계정과 같이 함수 앱을 연결할 대상 리소스입니다.
- 서비스 연결을 만들고 관리하는 데 필요한 권한 입니다.
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을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
환경 설정
서비스 커넥터를 처음 사용하는 경우 az provider register 명령을 실행하여 Service Connector 리소스 공급자를 등록합니다.
az provider register -n Microsoft.ServiceLinker팁 (조언)
명령을
az provider show -n "Microsoft.ServiceLinker" --query registrationState실행하여 리소스 공급자가 이미 등록되었는지 확인할 수 있습니다. 출력이Registered면 Service Connector가 이미 등록되어 있습니다.필요에 따라 az functionapp connection list-support-types 명령을 실행하여 Azure Functions에 대해 지원되는 대상 서비스 목록을 가져옵니다.
az functionapp connection list-support-types --output table
서비스 연결 만들기
서비스 커넥터를 사용하여 Azure Functions 앱과 Azure Blob Storage 간에 서비스 연결을 만듭니다. 이 예제에서는 Blob Storage에 연결하는 방법을 보여 주지만 지원되는 다른 Azure 서비스에 동일한 프로세스를 사용할 수 있습니다.
Azure Portal에서 맨 위에 있는 검색 리소스, 서비스 및 문서(G +/) 검색 창을 선택하고 , 함수 앱을 입력하고, 함수 앱을 선택합니다.
대상 리소스에 연결하려는 함수 앱 리소스를 선택합니다.
왼쪽 탐색 창에서 서비스 커넥터를 선택한 다음 만들기를 선택합니다.
기본 사항 탭에서 다음 설정을 선택하거나 입력합니다.
설정 예시 설명 서비스 종류 스토리지 - Blob 대상 서비스 유형입니다. Blob Storage 계정이 없는 경우 계정을 만들 거나 다른 서비스 유형을 사용할 수 있습니다. 구독 내 구독 대상 서비스(연결할 서비스)에 대한 구독입니다. 기본값은 이 함수 앱 리소스에 대한 구독입니다. 연결 이름 my_connection 함수 앱과 대상 서비스 간의 연결을 식별하는 연결 이름입니다. 서비스 커넥터에서 제공하는 연결 이름을 사용하거나 사용자 고유의 연결 이름을 선택합니다. 스토리지 계정 my_storage_account 연결하려는 대상 스토리지 계정입니다. 선택할 대상 서비스 인스턴스는 선택한 서비스 유형에 따라 달라집니다. 클라이언트 유형 이 함수 앱의 동일한 앱 스택 기본값은 함수 앱 런타임 스택에서 가져옵니다. 이 함수 앱 인스턴스에 있는 앱 스택을 선택합니다. 다음: 인증을 선택하여 인증 방법을 선택합니다.
Microsoft Entra ID에서 자동으로 생성되고 서비스 인스턴스의 수명 주기에 연결된 ID를 통해 연결하려면 시스템 할당 관리 ID를 선택합니다. 권장 인증 옵션입니다.
다음: 네트워킹을 선택하여 네트워크 설정을 구성합니다. 함수 앱이 대상 서비스에 액세스할 수 있도록 대상 서비스에 대한 액세스를 사용하도록 방화벽 규칙 구성 을 선택합니다.
그런 후 다음: 검토 + 만들기를 선택하여 제공된 정보를 검토합니다. 최종 유효성 검사를 실행하는 데 몇 초 정도 걸립니다. 그런 다음 만들기를 선택하여 서비스 연결을 만듭니다. 이 작업을 완료하는 데 1분 정도 걸릴 수 있습니다.
az functionapp connection create 명령을 실행하여 시스템 할당 관리 ID를 사용하여 Blob Storage에 대한 서비스 연결을 만듭니다. 다음 두 가지 방법으로 이 명령을 실행할 수 있습니다.
새 연결을 단계별로 생성합니다.
az functionapp connection create storage-blob --system-identity한 번에 새 연결을 생성합니다. 자리 표시자를 사용자 고유의 정보
<source-subscription>인 , ,<source_resource_group><function-app>,<target-subscription><target_resource_group>및<account>.az functionapp connection create storage-blob \ --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.Web/sites/<function-app> \ --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \ --system-identity
팁 (조언)
Blob Storage 계정이 없는 경우 실행 az functionapp connection create storage-blob --new --system-identity 하여 계정을 만들고 관리 ID를 사용하여 함수 앱에 연결합니다.
서비스 연결 보기 및 유효성 검사
서비스 연결을 만든 후에는 Azure Functions 앱에서 모든 연결을 보고, 유효성을 검사하고, 관리할 수 있습니다.
함수 앱 연결이 서비스 커넥터 서비스 메뉴에 표시됩니다. 목록을 확장하고 애플리케이션에 필요한 속성을 보려면 선택합니다 > .
유효성 검사를 선택하여 연결을 확인합니다. 오른쪽 패널에서 연결 유효성 검사 세부 정보를 볼 수 있습니다.
az functionapp connection list 명령을 실행하여 함수 앱의 프로비전된 모든 연결을 나열합니다. 자리 표시자를 <function-app-resource-group><function-app-name> 사용자 고유의 정보로 바꿉다. 연결에 --output table 대한 자세한 정보를 볼 수 있는 옵션을 제거할 수도 있습니다.
az functionapp connection list --resource-group "<function-app-resource-group>" --name "<function-app-name>" --output table
출력에는 연결의 프로비전 상태도 표시됩니다.
관련 콘텐츠
Azure Functions 앱을 Azure Storage에 성공적으로 연결했으므로 다음 자습서를 탐색하여 Service Connector를 사용하여 고급 함수 애플리케이션을 빌드합니다.