확장 프로그램을 설치하려면 프로젝트에서 사용한 만큼만 지불하는 Blaze 요금제를 이용해야 합니다. 확장 프로그램 설치에는 요금이 청구되지 않지만 사용량이 서비스 무료 등급을 초과하면 Cloud Secret Manager과 같은 Firebase 서비스나 Cloud 서비스 사용에 대한 요금이 청구될 수 있습니다.
시작하기 전에
아직 추가하지 않은 경우 프로젝트에 Firebase를 추가하고 Firebase 프로젝트를 사용한 만큼만 지불하는 Blaze 요금제로 업그레이드하세요.
1단계: 확장 프로그램에 대한 자세한 정보 보기
이 단계는 선택사항이지만 적극 권장됩니다.
Firebase Extension을 설치하기 전에 다음을 포함한 확장 프로그램에 대한 자세한 정보를 검토하는 것이 좋습니다.
확장 프로그램의 카드를 클릭한 다음 확장 프로그램의 세부정보를 검토하여 구체적인 사용법 안내 및 설치 전 작업을 확인합니다.
설치를 클릭한 다음 화면에 표시된 안내에 따라 확장 프로그램을 설치합니다.
3단계: 설치 후 설정 완료
일부 확장 프로그램의 경우 확장 프로그램을 사용하기 전에 완료해야 하는 단계(필수 또는 선택사항)가 있습니다. Firebase 콘솔의 Extensions 대시보드에 있는 확장 프로그램의 설치 후 세부정보 페이지에서 이러한 안내를 확인합니다. 대시보드와 연결된 특정 링크는 설치 후 터미널에 표시됩니다.
아직 존재하지 않는 Firebase 리소스(Cloud Firestore 컬렉션, Realtime Database 경로, Cloud Storage 버킷)를 사용하도록 확장 프로그램을 구성한 경우 확장 프로그램을 사용하기 전에 먼저 만듭니다.
Eventarc 이벤트 핸들러 만들기
일부 확장 프로그램은 실행 중에 중요한 이벤트가 발생하면 Eventarc에 게시됩니다. 확장 프로그램에서 이벤트를 게시하고 설치 중에 이벤트를 사용 설정한 경우 이러한 이벤트에 반응하는 함수를 자체 커스텀 로직으로 작성할 수 있습니다. 이 방식은 예를 들어 장기 실행 작업이 완료될 때 사용자에게 알리거나 확장 함수의 출력을 후처리하는 데 유용할 수 있습니다.
[[["이해하기 쉬움","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\nYou can install (and [manage](/docs/extensions/manage-installed-extensions)) any\nof the official Firebase extensions using either the Firebase console,\nthe [Firebase CLI](/docs/cli) (command-line interface), or using an\nautogenerated SDK.\n\nMake sure to review the\n[differences](/docs/extensions/overview-use-extensions#console-vs-cli) in the\nsupported actions for each installation method. \nFirebase console Firebase CLI Autogenerated SDK \n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\n| To try out a Firebase Extension for the first time, we recommend that you install the extension in a test or development project.\n\n\u003cbr /\u003e\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\nBefore you begin\n\nIf you haven't already, [add Firebase to your project](/docs/guides) and upgrade\nyour Firebase project to the **Blaze** (pay as you go) plan.\n\n**Step 1**: View detailed information about an extension\n\nThis step is optional, but strongly recommended.\n\nBefore installing a Firebase Extension, we recommend that you\nreview detailed information about the extension, including:\n\n- How the extension works, any pre-installation tasks, and details about the extension\n- General identifying information and description\n- Whether the extension's tasks require a billing account\n- Google services (APIs) and [access roles](/docs/extensions/permissions-granted-to-extension) required for operation\n- [Resources](/docs/extensions/overview-use-extensions#resources) created for the extension (like functions)\n- Descriptions of user-configurable parameters\n\n**To view an extension's detailed information:**\n\n1. Browse official Firebase extensions in the [Extensions Hub](https://extensions.dev/extensions).\n\n2. Click an extension's card to:\n\n - Display the detailed information for the extension.\n\n - Find the link to the extension's source code in the\n [Firebase Extensions source repository](https://github.com/firebase/extensions).\n\n In the extension's\n [*extension directory*](/docs/extensions/overview-use-extensions#view-source-code),\n you can view this detailed information in the `README`.\n\n**Step 2**: Install an extension\n\nDuring the installation process, you'll be prompted to review the basic\nspecifications for the extension (such as APIs enabled,\n[resources](/docs/extensions/overview-use-extensions#resources) created,\n[access](/docs/extensions/permissions-granted-to-extension) granted, etc.).\nYou'll be notified of any billing requirements, and you'll also be prompted to\nspecify values for the extension's configurable parameters.\n\n1. Browse official Firebase extensions in the [Extensions Hub](https://extensions.dev/extensions).\n\n2. Click an extension's card, then review the detailed information for the\n extension, which can offer specific usage instructions and any\n pre-installation tasks.\n\n3. Click **Install**, then follow the on-screen instructions to install\n the extension.\n\n | **Note:** Deploying and provisioning an extension may take the system 3-5 minutes.\n\n**Step 3**: Complete post-install setup\n\nSome extensions have required or optional steps for you to complete before using\nthem. Find these instructions in your extension's post-install details page in\nthe Extensions dashboard of the Firebase console (the specific link to\nthe dashboard is displayed in the terminal after installation).\n\nYou can also find these instructions in the `POSTINSTALL.md` file included in\nthe [extension's source directory](/docs/extensions/overview-use-extensions#view-source-code).\n\nCreate Firebase resources\n\nIf you configured the extension to use Firebase resources (Cloud Firestore\ncollections, Realtime Database paths, Cloud Storage buckets) that don't already exist,\ncreate them before using the extension.\n\nCreate Eventarc event handlers\n\nSome extensions publish to [Eventarc](https://cloud.google.com/eventarc)\nwhen important events happen during execution. If an extension publishes events,\nand you enabled events during installation, you can write functions that react\nto these events with your own custom logic. This can be useful, for example, to\nnotify users when long-running tasks complete, or to post-process the output of\nan extension function.\n\nSee the extension's documentation for a list of events (if any) it publishes.\nFor example, see the\n[event types for the Run Payments with Stripe extension](https://github.com/stripe/stripe-firebase-extensions/blob/98c97775d54fb0be4601864b74d2fe5ce24dab83/firestore-stripe-payments/extension.yaml).\n\nThen, see [Custom event triggers](/docs/functions/custom-events#handle-events) for\ninformation on writing Eventarc event handlers.\n| **Important:** Enabling events can result in charges if you exceed the free quota. See [Eventarc pricing](https://cloud.google.com/eventarc/pricing).\n\nInstall multiple extension instances\n\nYou can install the same extension more than once in the same project.\nEach installed instance can have its own customized configuration and its own\nextension resources. You identify and refer to each installed instance using its\n*instance ID*, which is unique within your project.\n\nYou'll\nbe prompted to confirm or edit the instance ID of each additional instance of\nthe extension you install.\n\nNext Steps\n\n- [View the details and the\n configuration](/docs/extensions/manage-installed-extensions?platform=console#view-details-installed-extension)\n of your installed extension in the Firebase console.\n\n- [Monitor the activity](/docs/extensions/manage-installed-extensions#monitor)\n of your installed extension, including checks on its health, usage, and logs.\n\n- Using the Firebase console,\n [manage](/docs/extensions/manage-installed-extensions?platform=console) your\n installed extension. For official Firebase extensions, you can reconfigure\n or uninstall your extension, as well as update your extension to the latest\n version.\n\n- As a best practice for all projects, make sure to set up\n [budget alerts](/docs/projects/billing/avoid-surprise-bills#set-up-budget-alert-emails)\n for your project and monitor your [*Usage and billing*\n dashboard](//console.firebase.google.com/project/_/usage)\n in the Firebase console."]]
