확장 프로그램을 설치하거나 관리하려면 소유자 또는 편집자나 Firebase 관리자 역할 중 하나를 할당받아야 합니다.
프로젝트의 설치된 확장 프로그램 인스턴스 나열하기
설치한 확장 프로그램의 모든 인스턴스를 나열할 수 있습니다.
확장 프로그램 나열 명령어를 실행합니다.
firebase ext:list --project=projectId-or-alias
설치된 확장 프로그램 인스턴스의 세부정보 및 구성 보기
Firebase 콘솔에서 Firebase Extensions 대시보드로 이동합니다.
설치된 확장 프로그램 인스턴스의 카드에서 관리를 클릭합니다.
설치된 확장 프로그램 인스턴스 모니터링
Firebase 콘솔에서 설치된 확장 프로그램의 상태, 사용량, 로그를 확인하는 등 활동을 모니터링할 수 있습니다.
예산 알림 설정
일반적으로 예산 알림을 설정하는 것이 좋으며 다른 당사자의 코드가 내 프로젝트 내에서 실행되도록 하는 경우에는 알림이 특히 더 중요할 수 있습니다.
Firebase 프로젝트에 예산 알림을 설정했는지 확인합니다.
확장 프로그램에서 생성한 함수 보기
Firebase 콘솔의 함수 대시보드로 이동합니다.
대시보드 탭에서 Firebase Extensions의 함수는 물론 프로젝트에 배포한 다른 함수도 볼 수 있습니다.
확장 프로그램에서 생성한 함수에는
ext-extension-instance-id-functionName형식의 이름이 지정됩니다.예:
ext-awesome-task-simplifier-onUserCreate
확장 프로그램에서 생성한 Cloud Scheduler 작업 보기
Google Cloud 콘솔에서 프로젝트의 Cloud Scheduler 페이지를 엽니다.
작업 목록에서 Firebase Extensions의 Cloud Scheduler 작업은 물론 프로젝트용으로 만든 다른 작업도 볼 수 있습니다.
확장 프로그램에서 생성한 작업에는
firebase-ext-extension-instance-id-functionName형식의 이름이 지정됩니다.예:
firebase-ext-awesome-task-simplifier-doTask
확장 프로그램에서 큐에 추가된 Cloud Tasks 보기 및 관리
일부 확장 프로그램은 Cloud Tasks를 사용하여 장기 실행 태스크를 실행합니다. 일반적으로 확장 프로그램의 수명 주기 중 여러 단계(설치, 재구성, 업그레이드 후)에서 실행되는 태스크를 처리합니다.
일반적으로 이러한 태스크는 사용자 개입 없이 자동으로 실행 및 완료됩니다. 그러나 확장 프로그램의 큐에 추가된 태스크를 수동으로 관리해야 하는 경우(예: 큐를 일시중지하거나 아직 시작되지 않은 태스크를 큐에서 제거) 다음 단계를 따르세요.
Firebase 콘솔 확장 프로그램 섹션에서 확장 프로그램 인스턴스의 세부정보 페이지를 엽니다.
세부정보 페이지에서 API 및 리소스 섹션을 엽니다. 확장 프로그램에서 Cloud Tasks를 사용하는 경우 하나 이상의 항목이 포함된 Cloud 태스크 큐 섹션이 존재합니다.
관리할 큐의 큐 보기를 클릭합니다. 그러면 Google Cloud 콘솔에서 큐 세부정보 페이지가 열리며 이 페이지에서 큐에 추가된 태스크를 보고 큐를 일시중지하고 큐에서 태스크를 삭제하는 등의 작업을 수행할 수 있습니다. Cloud Tasks 문서의 큐 및 태스크 관리를 참조하세요.
확장 프로그램에서 생성한 Cloud Secret Manager 보안 비밀 보기
Google Cloud 콘솔에서 프로젝트의 Secret Manager 페이지를 엽니다.
보안 비밀 목록에서 Firebase Extensions에 대해 생성된 보안 비밀과 함께 프로젝트용으로 만든 다른 보안 비밀을 볼 수 있습니다.
확장 프로그램에서 생성한 보안 비밀에는
ext-extension-instance-id-paramnName형식의 이름이 지정됩니다.예:
ext-awesome-task-simplifier-API_KEY보안 비밀은
firebase-extensions-managed키로 라벨이 지정됩니다. Firebase의 보안 비밀 관리를 중지하려는 경우가 아니면 이 라벨을 삭제하지 마세요.
설치된 확장 프로그램이 정상인지 확인
콘솔에서 함수(Firebase Extensions에서 생성한 함수 포함)의 모든 오류를 검토할 수 있습니다.
함수 대시보드의 상태 탭에서 프로젝트의 모든 함수에 대한 오류 및 성능 정보를 개략적으로 볼 수 있습니다.
특정 확장 프로그램에 대한 정보를 보려면 페이지 상단의 필터를 사용하여 특정 함수를 선택합니다.
설치된 확장 프로그램이 실행되는 빈도 확인
함수 대시보드의 대시보드 탭에서 확인할 Firebase Extension의 특정 함수를 찾습니다.
항목의 맨 오른쪽에 있는 (더보기 메뉴)를 클릭한 다음 자세한 사용 통계를 선택합니다.
표시된 Google Cloud 콘솔에서 함수의 다양한 호출을 상세히 살펴보고 소스 코드를 검사할 수도 있습니다.
확장 프로그램의 로그 보기
프로젝트를 디버그하거나 Firebase에 버그 보고서를 제출하려는 경우 프로젝트에서 실행 중인 함수의 로그를 확인하는 것이 좋습니다.
함수 대시보드의 로그 탭에서 페이지 상단의 필터를 사용하여 확장 프로그램에서 생성한 함수를 선택합니다.
설치된 확장 프로그램 인스턴스를 최신 버전으로 업데이트
설치된 확장 프로그램 인스턴스를 최신 출시 버전으로 업데이트할 수 있습니다. 테스트, 프로젝트 또는 앱 워크플로에서 인스턴스가 이미 실행 중에 있거나 또는 설정되어 있기 때문에 설치된 인스턴스를 업데이트할 필요가 있습니다.
인스턴스를 업데이트하면 새 버전의 소스 코드와 파일을 사용하도록 모든 인스턴스의 확장 프로그램 관련 리소스와 로직을 덮어씁니다. 확장 프로그램의 인스턴스 ID와 서비스 계정은 변경되지 않습니다.
업데이트 프로세스 중에 새 버전의 변경사항에 대한 알림이 전송되며 새 매개변수의 값을 지정할 수 있습니다.
Firebase Extensions 대시보드로 이동한 후 설치된 확장 프로그램 인스턴스의 카드에서 관리를 클릭합니다.
오른쪽 상단에서 확장 프로그램 업데이트를 클릭합니다.
확장 프로그램에 사용 가능한 새 버전이 없는 경우 세부정보 페이지에 업데이트 버튼이 표시되지 않습니다.
업데이트의 새로운 기능을 검토하고 필요한 경우 확장 프로그램을 구성합니다.
확장 프로그램 업데이트를 클릭합니다.
설치된 확장 프로그램 인스턴스 재구성
설치된 확장 프로그램 인스턴스의 사용자 구성 매개변수 값을 변경할 수 있습니다. 이러한 새 값은 인스턴스의 모든 향후 트리거에 사용되지만, 확장 프로그램에서 생성한 기존의 아티팩트나 구조적 요소(예: 저장된 이미지 또는 기존 스토리지 버킷)는 변경되지 않습니다.
Firebase Extensions 대시보드로 이동한 후 설치된 확장 프로그램 인스턴스의 카드에서 관리를 클릭합니다.
오른쪽 상단에서 확장 프로그램 재구성을 클릭합니다.
화면에 표시된 안내에 따라 확장 프로그램의 매개변수 값을 다시 구성합니다.
저장을 클릭합니다.
확장 프로그램 인스턴스 제거
Firebase 프로젝트에서 확장 프로그램 인스턴스를 제거할 수 있습니다. 이 작업은 Firebase가 확장 프로그램의 인스턴스용으로 특별히 만든 서비스 계정 및 모든 리소스(예: 함수 세트)를 삭제합니다. 하지만 다음 항목은 삭제되지 않습니다.
확장 프로그램에서 생성한 아티팩트(예: 저장된 이미지)
프로젝트의 다른 모든 리소스(예: 데이터베이스 인스턴스 또는 Cloud Storage 버킷). 확장 프로그램이 이러한 다른 리소스와 상호작용했더라도 해당 리소스는 확장 프로그램 관련 리소스가 아니므로 확장 프로그램을 제거해도 삭제되지 않습니다.
확장 프로그램을 제거하는 방법은 다음과 같습니다.
Firebase Extensions 대시보드로 이동한 후 설치된 확장 프로그램 인스턴스의 카드에서 관리를 클릭합니다.
화면 하단에서 확장 프로그램 제거를 클릭합니다.
삭제할 항목을 검토한 후 확장 프로그램 제거를 클릭하여 삭제를 확인합니다.