Catch up on everthing we announced at this year's Firebase Summit. Learn more

Firebase 확장 프로그램 설치

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

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


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

또한 확장 프로그램을 설치하려면 프로젝트에서 사용한 만큼만 지불하는 Blaze 요금제를 이용해야 합니다. 사용량과 관련된 요금 외에도 이 확장 프로그램에 필요한 Firebase 리소스에 대해 사용 여부와 관계없이 일반적으로 월 $0.01 정도의 소액이 청구됩니다.

시작하기 전에

  1. 아직 추가하지 않은 경우 프로젝트에 Firebase를 추가합니다.

  2. 사용한 만큼만 지불하는 Blaze 요금제로 프로젝트를 아직 업그레이드하지 않은 경우 업그레이드합니다.

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

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

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

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

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

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

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

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

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

  2. 컴퓨터의 어느 위치에서든 다음 확장 프로그램 정보 명령어를 실행합니다.

    firebase ext:info publisher-id/extension-id

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

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

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

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

  2. 확장 프로그램 설치 명령어를 실행합니다. 메시지가 표시되면 매개변수 값을 입력하여 확장 프로그램 인스턴스를 맞춤설정합니다.

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

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

  3. 설치가 완료되면 확장 프로그램 사용에 대한 안내를 검토합니다. 여기에는 설치 후 필요 작업이 포함될 수 있습니다.

    • Firebase Console의 확장 프로그램 대시보드에 있는 확장 프로그램의 설치 후 세부정보 페이지에서 이러한 안내를 확인하세요. 대시보드와 연결된 특정 링크는 설치 후 터미널에 표시됩니다.

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

    • 해당하는 경우 다음 안내에 따라 확장 프로그램을 테스트하는 방법을 확인할 수 있습니다 (직접 확인하기 섹션 참조).

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

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

다음 단계

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

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

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

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

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