다음을 통해 공유

빠른 시작: Service Connector를 사용하여 데이터베이스 및 서비스에 Azure Functions 연결

서비스 커넥터를 시작하여 데이터베이스, 스토리지 계정 및 기타 Azure 서비스에 Azure Functions를 연결합니다. 서비스 커넥터는 인증 및 구성을 간소화하여 관리 ID 또는 기타 인증 방법을 통해 리소스에 연결할 수 있도록 합니다.

이 문서에서는 Azure Portal 및 Azure CLI에 대한 단계별 지침을 제공합니다. 위의 탭에서 원하는 방법을 선택합니다.

필수 조건

  • 이 빠른 시작에는 Azure CLI 버전 2.30.0 이상이 필요합니다. 최신 버전으로 업데이트하려면 az upgrade를 실행해야 합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.

환경 설정

  1. 서비스 커넥터를 처음 사용할 경우 az provider register 명령을 실행하여 서비스 커넥터 리소스 공급자를 등록합니다.

    az provider register -n Microsoft.ServiceLinker

    팁 (조언)

    리소스 공급자가 이미 등록되었는지 확인하려면 az provider show -n "Microsoft.ServiceLinker" --query registrationState 명령을 실행하면 됩니다. 출력이 Registered인 경우에는 Service Connector가 이미 등록된 상태입니다.

  2. 선택적으로, Azure Functions에서 지원하는 대상 서비스 목록을 확인하려면 az functionapp connection list-support-types 명령을 실행하면 됩니다.

    az functionapp connection list-support-types --output table

서비스 연결 만들기

Service Connector를 사용하여 Azure Functions 앱과 Azure Blob Storage 간의 서비스 연결을 만듭니다. 이 예에서는 Blob Storage와의 연결을 보여주지만 지원되는 다른 Azure 서비스에도 같은 프로세스를 사용할 수 있습니다.

  1. Azure Portal 상단에 있는 검색 리소스, 서비스 및 문서(G +/) 검색 창을 선택한 후 Function App을 입력하고 Function App을 선택합니다.

    함수 앱을 선택하는 Azure Portal의 스크린샷.

  2. 대상 리소스에 연결할 함수 앱 리소스를 선택합니다.

  3. 왼쪽 탐색 창에서 서비스 커넥터를 선택한 후 만들기를 선택합니다.

    Azure Portal, 서비스 커넥터 선택, 새 연결 만들기 스크린샷

  4. 기본 사항 탭에서 다음 설정을 선택하거나 입력합니다.

    설정 예시 설명
    서비스 종류 Storage - Blob 대상 서비스 유형입니다. Blob Storage 계정이 없는 경우 계정을 만들거나 다른 서비스 유형을 사용할 수 있습니다.
    구독 내 구독 대상 서비스(연결할 서비스)에 대한 구독입니다. 기본값은 해당 함수 앱 리소스의 구독입니다.
    연결 이름 my_connection 함수 앱과 대상 서비스 간의 연결을 식별하는 연결 이름입니다. 서비스 커넥터에서 제공하는 연결 이름을 사용하거나 사용자 고유의 연결 이름을 선택합니다.
    스토리지 계정 my_storage_account 연결하려는 대상 스토리지 계정입니다. 선택할 대상 서비스 인스턴스는 선택한 서비스 유형에 따라 달라집니다.
    클라이언트 유형 이 함수 앱의 동일한 앱 스택 기본값은 함수 앱 런타임 스택에서 가져옵니다. 이 함수 앱 인스턴스의 앱 스택을 선택합니다.

  5. 다음: 인증을 선택하여 인증 방법을 선택합니다.

    Microsoft Entra ID에서 자동으로 생성되고 서비스 인스턴스의 수명 주기에 연동된 ID로 연결하려면 시스템 할당 관리 ID를 선택합니다. 인증 옵션에 권장됩니다.

  6. 다음: 네트워킹을 선택하여 네트워크 설정을 구성합니다. 함수 앱이 대상 서비스에 액세스할 수 있도록 대상 서비스에 액세스할 수 있도록 방화벽 규칙 구성을 선택합니다.

  7. 그런 후 다음: 검토 + 만들기를 선택하여 제공된 정보를 검토합니다. 최종 유효성 검사를 실행하는 데 몇 초 정도 걸립니다. 그런 다음 만들기를 선택하여 서비스 연결을 만듭니다. 이 작업은 완료되기까지 1분 정도 소요될 수 있습니다.

시스템 할당 관리 ID를 사용하여 Blob Storage에 대한 서비스 연결을 만들려면 az functionapp connection create 명령을 실행해야 합니다. 이 명령은 다음 두 가지 방법으로 실행할 수 있습니다.

  • 단계별로 새 연결 생성:

    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 앱에서 모든 연결을 보고, 유효성을 검사하고, 관리할 수 있습니다.

  1. 서비스 커넥터 서비스 메뉴에 함수 앱 연결이 표시됩니다. >를 선택하여 목록을 확장하고 애플리케이션에 필요한 속성을 확인합니다.

  2. 유효성 검사를 선택하여 연결을 확인합니다. 오른쪽 패널에서 연결 유효성 검사 세부 정보를 볼 수 있습니다.

    연결을 나열하고 유효성을 검사하는 Azure Portal의 스크린샷.

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에 연결했으므로, 자습서에서 서비스 커넥터를 사용하여 고급 함수 애플리케이션을 빌드하는 방법을 알아봅니다.

  • Last updated on