다음을 통해 공유

Azure 함수 앱을 만들거나 삭제하거나 복원할 때 발생하는 문제 해결

  • 아티클

이 문서에서는 Azure 함수 앱을 만들거나 삭제하거나 복원할 때 발생할 수 있는 몇 가지 일반적인 문제와 문제를 해결하는 단계를 나열합니다.

함수 앱 만들기

Azure 함수 앱에는 Azure App Service 인프라가 사용됩니다. 다음을 사용하여 Azure 함수 앱을 만들 수 있습니다.

Visual Studio 또는 Visual Studio Code에서 함수 프로젝트를 배포하는 동안 앱을 만들 수도 있습니다.

Azure Functions에서 사용하는 Azure Storage 계정에 대한 고려 사항

함수 앱을 만들 때 Blob, 큐 및 테이블 스토리지를 지원하는 범용 Azure Storage 계정을 만들거나 해당 계정에 연결할 수 있습니다. Azure Functions는 트리거 관리 및 함수 실행 기록 등의 작업에 Azure Storage를 사용합니다. 자세한 내용은 Azure Functions의 스토리지 고려 사항을 참조하세요.

  • 스토리지 계정 및 기타 리소스를 만들 수 있는 권한이 있는지 확인합니다. RBAC(역할 기반 액세스 제어), 정책 또는 범위 위반이 없어야 합니다.
  • AzureWebJobsStorage의 경우에만 Azure Storage 계정 연결 문자열에 관리 ID를 사용합니다. 자세한 내용은 ID로 호스트 스토리지에 연결(미리 보기)을 참조하세요.

Azure Functions에서 사용하는 Azure Storage 계정 보호

프라이빗 엔드포인트로 보호되는 Azure 함수 앱 및 새 스토리지 계정을 만들 수 있습니다. 가상 네트워크 통합을 지원하는 계획에서 함수 앱을 호스트합니다.

다양한 호스팅 계획에서 Azure 함수 앱 마이그레이션

Windows에서는 Azure CLI 명령을 사용하여 소비 및 프리미엄 계획 간에 함수 앱을 마이그레이션하거나 그 반대로 마이그레이션할 수 있습니다. 자세한 내용은 이전 계획을 참조하세요.

  • 이벤트 기반 크기 조정 및 서버리스 기능 사용에 대한 기능이 호스팅 계획마다 다르기 전용(App Service) 계획에서 사용/프리미엄 계획으로의 직접 마이그레이션은 지원되지 않습니다.

참고 항목

Linux는 호스팅 계획 마이그레이션을 지원하지 않습니다.

가상 네트워크 연결, 시간 제한, 청구 등과 같은 호스팅 계획(사용량, 프리미엄, 전용) 제품을 검토합니다. 자세한 내용은 Azure Functions 호스팅 옵션을 참조하세요.

"이 지역에는 구독에 대한 0개의 인스턴스 할당량이 있습니다. 다른 지역 또는 SKU를 선택하세요." 오류

특정 지역에서 지속적으로 리소스 생성 문제가 발생하는 경우 비즈니스에서 허용하는 경우 지리적으로 쌍을 이루는 지역에 리소스를 만들려고 합니다. 예를 들어 미국 서부 2와 미국 중서부는 쌍을 이루는 지역입니다. 동아시아(홍콩 특별 행정구) 및 동남아시아(싱가포르) 도 쌍을 이루는 지역입니다.

자세한 내용은 다음을 참조하세요.

"이 리소스 그룹에서 가격 책정 계층이 허용되지 않음" 또는 "SkuNotAllowedForResourceGroup" 오류를 해결합니다.

새 리소스 그룹에서 계획을 만드는 것이 좋습니다. SKU마다 고유한 컴퓨터가 필요합니다. 리소스 그룹에서 앱을 만들면 앱이 매핑되고 리소스 풀에 할당됩니다. 해당 리소스 그룹에 다른 계획을 만들고 매핑된 풀에 필요한 리소스가 없는 경우 오류가 나타납니다.

자세한 내용은 기존 리소스 그룹에서 함수 앱 만들기를 참조하세요.

함수 앱 콘텐츠 파일 공유를 만드는 데 실패합니다. "원격 서버에서 오류를 반환했습니다. (403) 사용할 수 없음"

소비 계획 또는 Elastic Premium 계획의 함수 앱의 경우 파일 공유가 스토리지 계정에 생성되고 앱 설정을 WEBSITE_CONTENT_SHARE사용하여 참조됩니다. 이 오류는 스토리지 계정에 방화벽, 프라이빗 엔드포인트 또는 NSG(네트워크 보안 그룹) 규칙과 같은 기타 가상 네트워크 보안 제한이 있기 때문에 발생할 수 있습니다.

이 오류를 해결하려면 보안 스토리지 계정에 미리 파일 공유를 만들고 이를 WEBSITE_CONTENT_SHARE로 구성합니다. 자세한 내용은 스토리지 계정을 가상 네트워크로 제한을 참조하세요.

만들기를 위한 대체 도구

Azure CLI, PowerShell 및 Az.Functions. 최신 버전의 도구를 사용해야 합니다. Azure Portal과 같은 도구 중 하나를 사용할 때 문제가 있는 경우 Azure CLI와 같은 다른 도구를 사용해 보세요.

Windows 및 Linux용 함수 런타임 버전 설정

Windows 앱의 경우 Azure Portal에서 런타임 버전(설정>구성>함수 런타임 설정>런타임 버전)을 설정하거나 애플리케이션 설정을 FUNCTIONS_EXTENSION_VERSION 만들어 V4를 대상으로 하는 주 런타임 버전 ~4 으로 설정합니다. 자세한 내용은 Azure Functions 런타임 버전을 대상으로 지정하는 방법을 참조하세요. FUNCTIONS_EXTENSION_VERSION 부 버전으로 설정하여 호스트 릴리스에 따라 부 버전에 고정합니다. Azure Functions 호스트 릴리스도 참조하세요.

Linux 앱의 경우 Linux의 수동 버전 업데이트를 참조하세요.

HTTP 429 오류 해결

제한은 Azure Resource Manager 및 리소스 공급자(Microsoft.Web)의 두 가지 수준에서 발생합니다. 이 수준은 구독 유형 및 호스팅 계획에 따라 달라집니다. 자세한 내용은 다음을 참조하세요.

참고 항목

문제가 자주 해결되지 않는 경우 잠시 후 기다렸다가 다시 시도하여 문제가 해결되었는지 확인합니다. 문제가 자주 발생하면 다른 구독을 구입하거나 호스팅 계획을 업데이트하여 오류를 해결할 수 있습니다.

함수 앱 삭제 또는 복원

Visual Studio에서 코드를 게시하고 사용한 WEBSITE_RUN_FROM_PACKAGE후 Azure Portal은 함수를 읽기 전용으로 설정하여 포털에서 미리 컴파일된 자산을 편집하지 못하도록 합니다. 함수 앱에서 함수를 삭제하려면 코드에서 원치 않는 함수를 제거하고 프로필 설정에서 대상에서 추가 파일 제거 옵션을 사용하도록 설정하고 코드를 다시 배포합니다.

소비 계획 또는 Elastic Premium 플랜에서 호스트되는 Azure 함수 앱 복원은 지원되지 않습니다. 함수 앱 콘텐츠가 있거나 스토리지 계정에 액세스할 수 있는 경우 앱 설정을 업데이트하거나 새 함수 앱을 만들고 콘텐츠를 사용합니다. 콘텐츠 스토리지에 Azure Files를 사용하지 않는 경우 전용 App Service 계획에서 Azure 함수 앱을 복원할 수 있습니다.

자세한 내용은 삭제된 웹앱 복원(삭제 취소)을 참조하세요.

Azure 함수 앱을 삭제할 수 있는 충분한 권한이 있는지 확인합니다. RBAC(역할 기반 액세스 제어), 정책 또는 범위 위반이 없어야 합니다.

Microsoft 지원에 문의하기 전에 데이터 수집

함수 앱 만들기 또는 삭제에 실패하는 경우 지원 티켓을 만들 때 다음 데이터를 수집하고 공유합니다.

  • Azure Portal: 문제를 재현하고 브라우저 추적을 캡처합니다.

  • Azure CLI 또는 Azure PowerShell: 오류를 보고한 명령과 자세한 정보 로깅을 공유합니다.

  • Azure Resource Manager 배포 실패의 경우 Azure Portal에서 오류 메시지를 찾습니다.

    1. 리소스 그룹>배포를 선택합니다.
    2. 실패한 작업 상관 관계 ID를 공유합니다.

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.