Azure Functions 확장 번들

2025-06-01

이 문서에서는 확장 번들을 사용하여 함수 코드에서 Azure Functions에서 지원하는 모든 트리거 및 바인딩을 사용하는 방법을 설명합니다. 또한 확장 번들을 사용할 때 앱에 대한 다양한 지원 수준 및 정책에 대해 알아봅니다.

이 문서는 non-.NET 언어를 사용하는 Azure Functions 개발자에게만 적용됩니다. C# 함수 앱에 바인딩 확장을 직접 추가하는 방법을 알아보려면 Azure Functions 바인딩 확장 등록을 참조하세요.

개요

확장 번들은 미리 정의된 호환 바인딩 확장 집합을 함수 앱에 추가합니다. 확장 번들의 버전이 지정됩니다. 각 버전에는 함께 작동하도록 확인된 특정 바인딩 확장 집합이 포함되어 있습니다. 앱에 필요한 확장 버전에 따라 번들 버전을 선택합니다.

non-.NET 템플릿에서 Azure Functions 프로젝트를 만들 때 확장 번들은 앱의 host.json 파일에서 이미 활성화되어 있습니다.

확장 번들 참조 정의

이 예제와 같이 섹션을 추가하여 host.json 프로젝트 파일에서 확장 번들 참조를 extensionBundle 정의합니다.

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

extensionBundle에서 사용할 수 있는 속성은 다음과 같습니다.

재산 설명

id Microsoft Azure Functions 확장 번들에 대한 네임스페이스입니다.

version 설치할 번들의 버전 범위입니다. Functions 런타임은 항상 버전 범위 또는 간격으로 정의된 허용 가능한 최대 버전을 선택합니다. 예를 들어 값 범위는 version[4.0.0, 5.0.0) 4.0.0에서 5.0.0까지의 모든 번들 버전을 허용하지만 5.0.0은 포함하지 않습니다. 자세한 내용은 버전 범위를 지정하기 위한 간격 표기법을 참조하세요.

재산	설명
`id`	Microsoft Azure Functions 확장 번들에 대한 네임스페이스입니다.
`version`	설치할 번들의 버전 범위입니다. Functions 런타임은 항상 버전 범위 또는 간격으로 정의된 허용 가능한 최대 버전을 선택합니다. 예를 들어 값 범위는 `version[4.0.0, 5.0.0)` 4.0.0에서 5.0.0까지의 모든 번들 버전을 허용하지만 5.0.0은 포함하지 않습니다. 자세한 내용은 버전 범위를 지정하기 위한 간격 표기법을 참조하세요.

지원되는 확장 번들

이 표에는 모든 Microsoft.Azure.Functions.ExtensionBundle 번들 버전과 현재 지원 상태가 나열되어 있습니다.

번들 버전	host.json의 버전	지원 상태	지원 종료 날짜
4.x	`[4.0.0, 5.0.0)`	활동 중	아직 결정되지 않음
3.x	`[3.3.0, 4.0.0)`	더 이상 권장되지 않음	05/30/2026
2.x	`[2.*, 3.0.0)`	더 이상 권장되지 않음	05/30/2026
1.x	`[1.*, 2.0.0)`	더 이상 권장되지 않음	05/30/2026

기본 확장 번들은 버전 범위를 사용하여 정의됩니다. 번들 버전을 선택하여 현재 주 확장 번들 버전을 생성하는 데 사용되는 extensions.json 정의 파일을 확인합니다.

자세한 내용은 지원 정책을 참조하세요.

확장 번들 고려 사항

확장 번들을 사용할 때는 다음과 같은 고려 사항을 염두에 두어야 합니다.

가능하면 사용자 지정 범위를 정의하는 대신 이 테이블version의 host.json 범위 값을 설정 [4.0.0, 5.0.0) 해야 합니다.
최신 버전 범위를 사용하여 최적의 앱 성능과 최신 기능에 대한 액세스를 얻을 수 있습니다.
만약 확장 번들을 사용할 수 없는 경우 확장을 명시적으로 설치해야 합니다.

확장 번들 미리 보기

특정 바인딩 확장의 시험판 버전은 미리 보기 확장 번들에서 유지 관리됩니다. 미리 보기 확장 번들(Microsoft.Azure.Functions.ExtensionBundle.Preview)을 사용하면 GA로 선언되기 전에 기존 확장의 미리 보기 확장 및 새 동작을 활용할 수 있습니다.

GA가 아닌 확장 번들을 사용하도록 선택할 때는 다음 사항을 염두에 두어야 합니다.

미리 보기 번들에는 아직 개발 중이며 프로덕션용으로 아직 준비되지 않은 기능이 포함될 수 있습니다. 비프로덕션 환경에서 평가 및 테스트용입니다.
미리 보기 버전 간에 사전 통지 없이 호환성이 손상되는 변경이 발생합니다. 여기에는 다음과 같은 변경 내용이 포함될 수 있습니다.
- 트리거 및 바인딩 정의
- 미리 보기에 포함된 확장
- 성능 특성 및 안정성
보안 업데이트를 사용하려면 버전을 업그레이드해야 할 수 있습니다.
비프로덕션 환경에서 미리 보기 번들을 완전히 테스트하고 프로덕션 환경에서 미리 보기 번들을 사용하지 않도록 해야 합니다. 프로덕션 환경에서 미리 보기 번들을 사용해야 하는 경우 다음과 같은 추가 예방 조치를 취합니다.
- 번들을 범위 대신 잘 테스트된 특정 번들 버전에 고정합니다. 고정은 비프로덕션 환경에서 업데이트를 확인하기 전에 번들 버전의 자동 업그레이드를 방지합니다.
- 완전히 지원되는 번들 릴리스에서 기능을 사용할 수 있게 되는 즉시 앱을 GA 번들 버전을 사용하도록 이동합니다.
미리 보기에서 GA로의 이동을 포함하여 번들 업데이트에 대한 정보를 유지하려면 다음을 수행해야 합니다.
- 확장 번들 릴리스 페이지에서 미리 보기 번들 버전 릴리스를 모니터링합니다. - 릴리스 · Azure/azure-functions-extension-bundles
- 확장 관련 참조 설명서를 모니터링합니다.
- 사용 중인 특정 미리 보기 확장의 NuGet 패키지 버전을 검토합니다.
- 각 미리 보기 확장에 대해 NuGet.org 게시된 변경 로그에서 중요한 업데이트 또는 변경 내용을 추적합니다.

지원 정책

기본 바인딩 확장의 종속성에 호환성이 손상되는 변경 또는 업데이트가 있는 경우 확장 번들의 주 버전 릴리스가 발생할 수 있습니다. Azure SDK에서 자주 도입되는 이러한 주요 변경 사항은 호환성을 유지하기 위해 번들의 업데이트가 필요합니다.

GA 확장 번들의 지원 주기는 다음과 같은 고유한 단계를 따릅니다.

단계	설명
활동 중	최신 주 버전의 확장 번들은 활성 버전으로 간주되며 함수 앱에 권장됩니다.
통지	Microsoft는 확장 번들 또는 바인딩 확장 버전을 사용 중지하기 전에 고급 알림을 제공합니다. 이러한 알림을 받으면 함수 앱을 지원되는 최신 확장 번들 버전으로 업그레이드할 계획을 시작해야 합니다. 이 업그레이드를 통해 앱은 계속해서 새로운 기능, 성능 향상 및 지원에 액세스할 수 있습니다.
더 이상 권장되지 않음	새 주 확장 번들 버전이 일반 공급되면 이전 버전은 12개월 사용 중단 단계로 들어갑니다. 이 중첩 기간은 이전 버전이 사용 중지되기 전에 앱을 계획, 테스트 및 업그레이드할 시간을 제공합니다.
퇴직	확장 번들이 사용 중지된 후 특정 버전을 참조하는 함수 앱은 새 기능, 보안 패치 및 성능 최적화에 적합하지 않습니다. 사용 중지된 버전을 사용하는 함수 앱은 여전히 만들고 배포할 수 있으며 플랫폼에서 실행할 수 있습니다. 그러나 지원을 받으려면 먼저 함수 앱을 지원되는 번들 버전으로 업그레이드해야 합니다.

Azure Functions 확장 번들 GitHub 리포지토리에서 확장 번들 버전 및 포함된 확장을 볼 수 있습니다. 개별 .NET 패키지는 .에서 찾을 수 있습니다 https://nuget.org.

바인딩 확장에 대한 자세한 내용은 Azure Functions 바인딩 확장 등록을 참조하세요.