확장 프로그램을 설치하려면 프로젝트에서 사용한 만큼만 지불하는 Blaze 요금제를 이용해야 합니다. 확장 프로그램 설치에는 요금이 청구되지 않지만 사용량이 서비스 무료 등급을 초과하면 Cloud Secret Manager과 같은 Firebase 서비스나 Cloud 서비스 사용에 대한 요금이 청구될 수 있습니다.
또한 Firebase Local Emulator Suite의 구성요소인 Extensions 에뮬레이터를 사용하여 프로젝트에 확장 프로그램을 설치하기 전에 평가할 수도 있습니다.
공식 Firebase Extensions
공식 Firebase 확장 프로그램은 Firebase 및 Firebase Extensions 파트너 서비스에서 개발하고 테스트합니다. 이러한 확장 프로그램은 신뢰할 수 있고 안전합니다.
확장 프로그램의 소스 코드 링크를 찾으려면 Extensions Hub의 확장 프로그램 카드에서 자세히 알아보기를 클릭합니다.
확장 프로그램의 소스 코드 콘텐츠
확장 프로그램의 소스 디렉터리에는 다음이 포함됩니다.
extension.yaml 파일 — 확장 프로그램의 메타데이터를 포함하며, 생성된 리소스, 작업에 필요한 Google API 및 액세스 역할, 확장 프로그램에 사용자가 구성한 매개변수(환경 변수)를 정의합니다.
functions 디렉터리 — 확장 프로그램의 소스 코드에 대한 파일을 포함합니다.
README 파일 — 확장 프로그램의 메타데이터(더 읽기 쉬운 형식)와 PREINSTALL 파일의 콘텐츠를 나열합니다.
PREINSTALL 파일 — 확장 프로그램의 작동 방식, 필요한 설치 전 작업, 구성 요구사항, 확장 프로그램에 관한 세부정보를 설명합니다.
POSTINSTALL 파일 — 구체적인 사용법 및 추가 통합 요구사항을 설명합니다.
확장 프로그램용 리소스
모든 Firebase 프로젝트에는 여러 유형의 '리소스'가 포함됩니다. 프로젝트 리소스에는 배포된 Cloud Functions, 데이터베이스 인스턴스, Cloud Storage 버킷, Cloud Scheduler 작업, Cloud Secret Manager 데이터 등이 포함될 수 있습니다.
확장 프로그램을 설치하면 Firebase가 프로젝트에 새로운 확장 프로그램 인스턴스 관련 리소스를 만듭니다. 이러한 리소스는 확장 프로그램이 작동하는 데 필요합니다.
확장 프로그램 인스턴스를 제거하면 해당 확장 프로그램 인스턴스가 작동하도록 Firebase가 만든 모든 리소스(예: 함수 세트)가 삭제됩니다. 하지만 다음 항목은 삭제되지 않습니다.
확장 프로그램에서 생성한 아티팩트(예: 저장된 이미지)
프로젝트의 다른 모든 리소스(예: 데이터베이스 인스턴스 또는 Cloud Storage 버킷). 확장 프로그램이 이러한 다른 리소스와 상호작용했더라도 해당 리소스는 확장 프로그램 관련 리소스가 아니므로 확장 프로그램을 제거해도 삭제되지 않습니다.
Firebase Console, Firebase CLI 또는 자동 생성된 SDK 사용 {: #console-vs-cli}
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["\u003cbr /\u003e\n\nFirebase Extensions help you reduce time spent on development, maintenance,\nand growth of your app.\n\nWhen you find a Firebase Extension that solves a need for your app\nor project, all you do is install and configure the extension. If you need\nmultiple configurations of the extension, you can install the extension multiple\ntimes, with a different configuration for each instance you install.\n\nWith extensions,\nyou don't spend time researching, writing, and debugging the code that\nimplements functionality or automates a task for your app or project.\n\nTo install or manage extensions, you must be assigned one of these roles:\n[Owner or Editor](/docs/projects/iam/roles-basic) or\n[Firebase Admin](/docs/projects/iam/roles-predefined-all-products).\n\nTo install an extension, your project must be on the **Blaze** (pay as you\ngo) plan. Although there is no charge for installing an extension, you might be\ncharged for your use of Firebase services or Cloud services such as\n[Cloud Secret Manager](https://cloud.google.com/secret-manager/pricing), if your usage exceeds the services' free\ntier.\n\nYou can also evaluate extensions before installing them on a project using the\nExtensions emulator, a component of the Firebase Local Emulator Suite.\n\nOfficial Firebase extensions\n\nThe **official Firebase extensions** are developed and tested by Firebase\nand Firebase Extensions partner services. These extensions are reliable and\nsecure.\n\nBrowse Firebase extensions\n\nBrowse Firebase extensions in the [Extensions Hub](https://extensions.dev/extensions).\n\nView the source code of an extension\n\nTo find a link to the source code for an extension,\nclick **Learn more** on the extension's card in the Extensions Hub.\n\nContents of an extension's source code\n\nAn extension's source directory includes:\n\n- **extension.yaml file** --- Contains the extension's metadata and defines\n the [resources](#resources) created, the Google APIs and\n [access roles](/docs/extensions/permissions-granted-to-extension) required for\n operation, and any user-configured parameters (environment variables) for the\n extension\n\n- **functions directory** --- Contains the files for the source code for the\n extension\n\n- **README file** --- Lists the extension's metadata (but in more\n human-readable format) as well as the content from the PREINSTALL file\n\n- **PREINSTALL file** --- Describes how the extension works, any necessary\n pre-installation tasks, configuration requirements, and details about the\n extension\n\n- **POSTINSTALL file** --- Describes specific usage instructions and any further\n integration requirements\n\nResources for an extension\n\nEvery Firebase project contains several types of \"resources\". Project resources\ncan include things like deployed Cloud Functions, database instances,\nCloud Storage buckets, Cloud Scheduler jobs, and Cloud Secret Manager data.\n\nWhen you install an extension, Firebase creates new *extension-instance-specific*\nresources in your project. These resources are required by the extension to\noperate.\n\nNote that, if you [uninstall an instance of an\nextension](/docs/extensions/manage-installed-extensions#uninstall), all the\nresources that Firebase created specifically for that instance of the extension\nto operate (like a set of functions) are deleted. However, the following are\n***not*** deleted:\n\n- Any artifacts created by the extension (like stored images).\n\n- Any other resources in your project, like a database instance or Cloud Storage\n bucket. Even if the extension interacted with these other resources, they\n are not *extension-specific*, so they aren't deleted if the extension is\n uninstalled.\n\nUsing the Firebase console, the Firebase CLI, or autogenerated SDKs {: #console-vs-cli}\n\nYou can install and manage extensions using\neither the\n[Firebase console](/docs/extensions/install-extensions?platform=console)\nor the\n[Firebase CLI](/docs/extensions/install-extensions?platform=cli),\nor in code using\n[autogenerated SDKs](/docs/extensions/install-extensions?platform=sdk).\n\n| **Action** | **Firebase console** | **Firebase CLI** | **Autogenerated SDK** |\n|----------------------------------------------|----------------------|------------------|-----------------------|\n| View detailed information (pre-installation) | | | |\n| Install | | | |\n| View configuration (post-installation) | | | |\n| Edit configuration | | | |\n| Update version | | | |\n| Uninstall | | | |\n\nNext Steps\n\n- View detailed information about an extension before you install the extension\n ([Extensions Hub](https://extensions.dev/extensions) or\n [Firebase CLI](/docs/extensions/install-extensions#view-details)).\n\n- Install an extension into your Firebase project using either the\n [Firebase console](/docs/extensions/install-extensions?platform=console),\n the [Firebase CLI](/docs/extensions/install-extensions?platform=cli).\n or [autogenerated SDKs](/docs/extensions/install-extensions?platform=sdk)."]]
