다음을 통해 공유


오류 해결: “Azure Functions 런타임에 연결할 수 없음”

이 문서는 Azure Portal에 표시되는 다음 오류 문자열 문제를 해결하는 데 도움이 됩니다.

"오류: Azure Functions 런타임에 연결할 수 없습니다. 스토리지 구성에 대한 자세한 내용을 보려면 여기를 클릭하세요."

Functions 런타임을 시작할 수 없으면 이 문제가 발생합니다. 가장 일반적인 이유는 함수 앱이 스토리지 계정에 대한 액세스 권한을 잃었기 때문입니다. 자세한 내용은 Storage 계정 요구 사항을 참조 하세요.

이 문서의 나머지 부분을 통해 각 사례를 식별하고 해결하는 방법을 포함하여 이 오류의 특정 원인을 해결할 수 있습니다.

스토리지 계정이 삭제됨

모든 함수 앱에서 작동하려면 스토리지 계정이 필요합니다. 해당 계정이 삭제되면 함수가 작동하지 않습니다.

먼저 애플리케이션 설정에서 스토리지 계정 이름을 조회합니다. AzureWebJobsStorage 연결 문자열 일부로 스토리지 계정의 이름을 포함하거나 WEBSITE_CONTENTAZUREFILECONNECTIONSTRING 포함합니다. 자세한 내용은 Azure Functions에 대한 앱 설정 참조를 참조 하세요.

Azure Portal에서 스토리지 계정을 검색하여 스토리지 계정이 여전히 존재하는지 확인합니다. 계정이 삭제된 경우에는 스토리지 계정을 다시 만들고 스토리지 연결 문자열을 바꿉니다. 함수 코드가 손실되고 다시 배포해야 합니다.

스토리지 계정 애플리케이션 설정이 삭제됨

이전 단계에서 연결 문자열 스토리지 계정을 찾을 수 없는 경우 삭제되거나 덮어쓰여졌을 수 있습니다. 애플리케이션 설정을 삭제하는 작업은 배포 슬롯 또는 Azure Resource Manager 스크립트를 사용하여 애플리케이션 설정을 설정할 때 가장 일반적으로 발생합니다.

필수 애플리케이션 설정

자세한 내용은 Azure Functions에 대한 앱 설정 참조를 참조 하세요.

지침

  • 이러한 설정에 대한 슬롯 설정을 검사 마세요. 배포 슬롯을 교환하면 함수 앱이 중단됩니다.
  • 이러한 설정은 자동화된 배포의 일부로 수정하지 마세요.
  • 이러한 설정은 생성 시 제공되고 유효해야 합니다. 이러한 설정을 포함하지 않는 자동화된 배포는 나중에 설정이 추가되더라도 실행되지 않는 함수 앱이 생성됩니다.

스토리지 계정 자격 증명이 잘못됨

스토리지 키를 다시 생성하는 경우에는 앞에서 언급한 스토리지 계정 연결 문자열을 업데이트해야 합니다. 스토리지 키 관리에 대한 자세한 내용은 Azure Storage 계정 만들기를 참조 하세요.

스토리지 계정에 액세스할 수 없음

함수 앱은 스토리지 계정에 액세스할 수 있어야 합니다. 함수 앱의 스토리지 계정 액세스를 차단하는 일반적인 문제는 다음과 같습니다.

  • 함수 앱이 스토리지 계정에서 전송/수신하는 트래픽을 허용하는 올바른 네트워크 규칙을 포함하지 않고 ASE(App Service Environment)에 배포됩니다.

  • 스토리지 계정 방화벽이 사용하도록 설정되었는데 Functions에서 전송/수신하는 트래픽을 허용하도록 구성되지 않았습니다. 자세한 내용은 Azure Storage 방화벽 및 가상 네트워크 구성을 참조하세요.

  • allowSharedKeyAccess 설정이 기본값인 true로 설정되어 있는지 확인합니다. 자세한 내용은 Azure Storage 계정에 대한 공유 키 권한 부여 방지를 참조 하세요.

일일 실행 할당량이 가득 찼습니다.

일일 실행 할당량을 구성한 경우 함수 앱이 일시적으로 비활성화되고 포털 컨트롤을 대부분 사용할 수 없게 됩니다.

Azure Portal에서 할당량을 확인하려면 함수 앱에서 플랫폼 기능>함수 앱 설정 선택합니다. 설정한 일일 사용 할당량초과하면 다음 메시지가 표시됩니다.

"함수 앱이 일일 사용 할당량에 도달했으며 다음 24시간 시간 프레임까지 중지되었습니다."

이 문제를 해결하려면 일일 할당량을 제거하거나 늘인 다음 앱을 다시 시작합니다. 그렇지 않으면 다음 날까지 앱 실행이 차단됩니다.

앱이 방화벽 뒤에 있음

다음 이유 중 하나 때문에 함수 앱에 연결할 수 없을 수 있습니다.

Azure Portal은 실행 중인 앱을 직접 호출하여 함수 목록을 가져오고 Kudu 엔드포인트에 대한 HTTP 호출을 만듭니다. 플랫폼 기능 탭의 플랫폼 수준 설정은 계속 사용할 수 있습니다.

ASE 구성을 확인하려면 다음을 수행합니다.

  1. ASE가 있는 서브넷의 NSG(네트워크 보안 그룹)로 이동합니다.
  2. 애플리케이션에 액세스하는 컴퓨터의 공용 IP에서 들어오는 트래픽을 허용하는 인바운드 규칙의 유효성을 검사합니다.

앱을 실행하는 가상 네트워크에 연결된 컴퓨터 또는 가상 네트워크에서 실행되는 가상 머신에 연결된 컴퓨터에서 포털을 사용할 수도 있습니다.

인바운드 규칙 구성에 대한 자세한 내용은 App Service Environment에 대한 네트워킹 고려 사항의 "네트워크 보안 그룹" 섹션을 참조하세요.

Linux의 컨테이너 오류

컨테이너의 Linux에서 실행되는 함수 앱의 경우 컨테이너에 문제가 발생하여 Azure Functions runtime is unreachable 오류가 발생할 수 있습니다. 다음 절차를 사용하여 컨테이너 로그에서 오류를 검토합니다.

  1. https://<FUNCTION_APP>.scm.azurewebsites.net에 있는 함수 앱의 Kudu 엔드포인트로 이동합니다. 여기서 <FUNCTION_APP>은 앱의 이름입니다.

  2. Docker 로그 .zip 파일을 다운로드하고 로컬 컴퓨터의 콘텐츠를 검토합니다.

  3. 컨테이너를 성공적으로 시작할 수 없음을 나타내는 오류가 로그에 있는지 확인합니다.

컨테이너 이미지를 사용할 수 없음

참조한 컨테이너 이미지를 사용할 수 없거나 올바르게 시작할 수 없을 때 오류가 발생할 수 있습니다. 컨테이너를 성공적으로 시작할 수 없음을 나타내는 오류가 로그에 있는지 확인합니다.

함수 앱이 제대로 실행되도록, 컨테이너 시작을 방해하는 오류를 수정해야 합니다.

컨테이너 이미지를 찾을 수 없는 경우 manifest unknown Docker 로그에 오류가 표시됩니다. 이 경우 Azure Functions 런타임 버전을 대상으로 지정하는 방법에 설명된 Azure CLI 명령을 사용하여 참조되는 컨테이너 이미지를 변경할 수 있습니다. 사용자 지정 컨테이너 이미지를 배포한 경우 이미지를 수정하고 업데이트된 버전을 참조된 레지스트리에 다시 배포해야 합니다.

앱 컨테이너에 충돌하는 포트가 있습니다.

시작 시 충돌하는 포트 할당으로 인해 함수 앱이 응답하지 않는 상태일 수 있습니다. 이는 다음과 같은 경우 발생할 수 있습니다.

  • 컨테이너에 하나 이상의 서비스가 함수 앱과 동일한 포트에 바인딩하는 별도의 서비스가 실행되고 있습니다.
  • 함수 앱과 동일한 포트 값을 공유하는 Azure 하이브리드 연결을 추가했습니다.

기본적으로 함수 앱이 실행되는 컨테이너는 포트 :80을 사용합니다. 동일한 컨테이너의 다른 서비스도 포트 :80을 사용하려고 하면 함수 앱이 시작되지 않을 수 있습니다. 로그에 포트 충돌이 표시되면 기본 포트를 변경합니다.

호스트 ID 충돌

Functions 런타임 버전 3.x부터 호스트 ID 충돌이 검색되고 경고로 기록됩니다. 버전 4.x에서는 오류가 기록되고 호스트가 중지됩니다. 함수 앱에 대해 런타임을 시작할 수 없는 경우 로그를 검토합니다. 호스트 ID 충돌에 대한 경고 또는 오류가 있는 경우 호스트 ID 고려 사항의 완화 단계를 따릅니다.

읽기 전용 앱 설정

읽기 전용App Service 애플리케이션 설정을 변경하면 함수 앱에 연결할 수 없는 상태가 될 수 있습니다.

ASP.NET 인증 재정의

Functions 호스트를 사용하여 In-Process를 실행하는 C# 앱에만 적용됩니다.

Functions 시작 클래스에서 ASP.NET 인증을 구성하면 Azure Portal이 호스트와 통신하는 데 필요한 서비스를 재정의할 수 있습니다. 여기에는 호출이 포함되지만 이에 국한되지 AddAuthentication()는 않습니다. 호스트의 인증 서비스가 재정의되고 포털이 호스트와 통신할 수 없는 경우 앱에 연결할 수 없는 것으로 간주됩니다. 이 문제로 인해 다음과 같은 No authentication handler is registered for the scheme 'ArmToken'.오류가 발생할 수 있습니다.

다음 단계

함수 앱 모니터링에 대해 알아봅니다.