Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

Firebase 확장 프로그램 설치

Firebase 콘솔 또는 Firebase CLI (명령줄 인터페이스)를 사용하여 모든 공식 Firebase 확장 프로그램을 설치(및 관리 )할 수 있습니다.

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


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

확장 프로그램을 설치하려면 프로젝트가 Blaze (종량제) 요금제에 있어야 합니다. 확장 프로그램 설치에 대한 비용은 없지만 사용량이 서비스의 프리 티어를 초과하는 경우 Firebase 서비스 또는 Cloud Secret Manager 와 같은 클라우드 서비스 사용에 대해 비용이 청구될 수 있습니다.

시작하기 전에

  1. 아직 프로젝트에 Firebase를 추가 하지 않았다면 추가합니다.

  2. 아직 업그레이드하지 않았다면 프로젝트를 Blaze (종량제) 요금제로 업그레이드하십시오.

  3. 최신 버전의 Firebase CLI를 설치하거나 업데이트합니다.

  4. Firebase 프로젝트 ID 또는 이전에 구성된 프로젝트 별칭을 기록해 둡니다.

    • 프로젝트 ID — 컴퓨터 어디에서나 firebase projects:list 을 실행합니다.
    • 프로젝트 별칭 — 로컬 앱 디렉터리에서 firebase use 을 실행합니다.

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

이 단계는 선택 사항이지만 강력히 권장됩니다.

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

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

확장 프로그램의 세부 정보를 보려면 다음 단계를 따르세요.

  1. 환경을 설정 하고 확장 프로그램을 선택 했는지 확인합니다.

  2. 컴퓨터의 어디에서나 extension-info 명령을 실행합니다.

    firebase ext:info publisher-id/extension-id

    publisher-idextension-id 인수는 필수이며 확장 프로그램의 사전 설치 세부 정보 페이지에서 찾을 수 있습니다.

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

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

  1. 환경을 설정 하고 확장 프로그램을 선택 했는지 확인합니다.

  2. 로컬 Firebase 디렉토리에서 extension-install 명령을 실행합니다. 메시지가 표시되면 매개변수 값을 입력하여 확장 인스턴스를 사용자 정의합니다.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-idextension-id 인수는 필수이며 확장 프로그램의 사전 설치 세부 정보 페이지에서 찾을 수 있습니다.

    이 명령을 실행하면 확장 매니페스트 에 확장 인스턴스가 추가됩니다.

  3. 그런 다음 매니페스트의 확장을 Firebase 프로젝트에 배포하려면

    firebase deploy --only extensions --project=projectId-or-alias
    을 실행합니다.

3단계 : 설치 후 설정 완료

일부 확장에는 사용하기 전에 완료해야 하는 필수 또는 선택적 단계가 있습니다. Firebase 콘솔의 확장 프로그램 대시보드에 있는 확장 프로그램의 설치 후 세부정보 페이지에서 이 지침을 찾으세요(대시보드에 대한 특정 링크는 설치 후 터미널에 표시됨).

확장 프로그램의 소스 디렉토리 에 포함된 POSTINSTALL.md 파일에서도 이러한 지침을 찾을 수 있습니다.

Firebase 리소스 만들기

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

Eventarc 이벤트 핸들러 생성

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

게시하는 이벤트(있는 경우) 목록은 확장의 설명서를 참조하세요.

그런 다음 Eventarc 이벤트 핸들러 작성에 대한 정보는 사용자 정의 이벤트 트리거 를 참조하십시오.

여러 확장 인스턴스 설치

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

다음 단계