Firebase 확장 프로그램 설치

Firebase Console 또는 Firebase CLI(명령줄 인터페이스)를 사용하여 공식 Firebase Extensions를 설치하고 관리할 수 있습니다.

Firebase CLI 및 Firebase Console에서 지원되는 작업의 차이점을 검토하세요.


확장 프로그램을 설치하거나 관리하려면 소유자 또는 편집자Firebase 관리자 역할 중 하나를 할당받아야 합니다.

확장 프로그램을 설치하려면 프로젝트에서 사용한 만큼만 지불하는 Blaze 요금제를 이용해야 합니다. 확장 프로그램 설치에는 요금이 청구되지 않지만 사용량이 서비스 무료 등급을 초과하면 Cloud Secret Manager과 같은 Firebase 서비스나 Cloud 서비스 사용에 대한 요금이 청구될 수 있습니다.

시작하기 전에

아직 추가하지 않은 경우 프로젝트에 Firebase를 추가하고 Firebase 프로젝트를 사용한 만큼만 지불하는 Blaze 요금제로 업그레이드하세요.

1단계: 확장 프로그램에 대한 자세한 정보 보기

이 단계는 선택사항이지만 적극 권장됩니다.

Firebase 확장 프로그램을 설치하기 전에 다음을 포함한 확장 프로그램에 대한 자세한 정보를 검토하는 것이 좋습니다.

  • 확장 프로그램의 작동 방식, 설치 전 작업, 확장 프로그램에 관한 세부정보
  • 일반 식별 정보 및 설명
  • 확장 프로그램의 작업을 수행하는 데 결제 계정이 필요한지 여부
  • 작업에 필요한 Google 서비스(API) 및 액세스 역할
  • 확장 프로그램용으로 생성된 리소스(예: 함수)
  • 사용자가 구성할 수 있는 매개변수에 대한 설명

확장 프로그램의 세부정보를 보는 방법은 다음과 같습니다.

  1. 확장 프로그램 허브에서 공식 Firebase Extensions를 둘러보세요.

  2. 확장 프로그램의 카드를 클릭하여 다음을 수행합니다.

2단계: 확장 프로그램 설치

설치 프로세스 중에 확장 프로그램의 기본 사양(예: 사용 설정된 API, 생성된 리소스, 부여된 액세스 권한 등)을 검토하라는 메시지가 표시됩니다. 결제 요구사항에 대한 알림이 전송되며 확장 프로그램의 구성 가능한 매개변수 값을 지정하라는 메시지도 표시됩니다.

  1. 확장 프로그램 허브에서 공식 Firebase Extensions를 둘러보세요.

  2. 확장 프로그램의 카드를 클릭한 다음 확장 프로그램의 세부정보를 검토하여 구체적인 사용법 안내 및 설치 전 작업을 확인합니다.

  3. 설치를 클릭한 다음 화면에 표시된 안내에 따라 확장 프로그램을 설치합니다.

3단계: 설치 후 설정 완료

일부 확장 프로그램의 경우 확장 프로그램을 사용하기 전에 완료해야 하는 단계(필수 또는 선택사항)가 있습니다. Firebase Console의 확장 프로그램 대시보드에 있는 확장 프로그램의 설치 후 세부정보 페이지에서 이러한 안내를 확인합니다. 대시보드와 연결된 특정 링크는 설치 후 터미널에 표시됩니다.

확장 프로그램의 소스 디렉터리에 포함된 POSTINSTALL.md 파일에서도 이러한 안내를 확인할 수 있습니다.

Firebase 리소스 만들기

아직 존재하지 않는 Firebase 리소스(Cloud Firestore 컬렉션, 실시간 데이터베이스 경로, Cloud Storage 버킷)를 사용하도록 확장 프로그램을 구성한 경우 확장 프로그램을 사용하기 전에 먼저 만듭니다(없는 경우).

Eventarc 이벤트 핸들러 만들기

일부 확장 프로그램은 실행 중에 중요한 이벤트가 발생하면 Eventarc에 게시됩니다. 확장 프로그램에서 이벤트를 게시하고 설치 중에 이벤트를 사용 설정한 경우 이러한 이벤트에 반응하는 함수를 자체 커스텀 로직으로 작성할 수 있습니다. 이 방식은 예를 들어 장기 실행 작업이 완료될 때 사용자에게 알리거나 확장 함수의 출력을 후처리하는 데 유용할 수 있습니다.

확장 프로그램이 게시하는 이벤트 목록(있는 경우)은 확장 프로그램의 설명서를 참고하세요. 예를 들어 Run Payments with Stripe 확장 프로그램의 이벤트 유형을 참조하세요.

Eventarc 이벤트 핸들러 작성에 관한 자세한 내용은 커스텀 이벤트 트리거를 참조하세요.

여러 확장 프로그램 인스턴스 설치

동일한 프로젝트에 동일한 확장 프로그램을 두 번 이상 설치할 수 있습니다. 설치된 각 인스턴스에는 고유한 커스텀 구성과 자체 확장 리소스가 있을 수 있습니다. 설치된 각 인스턴스는 프로젝트 내에서 고유한 인스턴스 ID를 사용하여 식별하고 참조할 수 있습니다. 설치하는 확장 프로그램의 각 추가 인스턴스에 대한 인스턴스 ID를 확인하거나 수정하라는 메시지가 표시됩니다.

다음 단계

  • Firebase Console에서 설치된 확장 프로그램의 세부정보 및 구성을 확인합니다.

  • 설치된 확장 프로그램의 상태, 사용량, 로그를 확인하는 등 활동을 모니터링합니다.

  • Firebase Console을 사용하여 설치된 확장 프로그램을 관리합니다. 공식 Firebase Extensions의 경우 확장 프로그램을 다시 구성하거나 제거하고 최신 버전으로 업데이트할 수 있습니다.

  • 모든 프로젝트에 대한 권장사항은 Firebase Console에서 프로젝트의 예산 알림을 설정하고 사용량 및 결제 대시보드를 모니터링하는 것입니다.