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

Firebase 에뮬레이터용 Cloud Storage에 앱 연결

앱을 Firebase용 Cloud Storage 에뮬레이터에 연결하기 전에 전체 Firebase 로컬 에뮬레이터 제품군 워크플로를 이해하고 로컬 에뮬레이터 제품군설치 및 구성 하고 해당 CLI 명령 을 검토해야 합니다.

Firebase 프로젝트 선택

Firebase 로컬 에뮬레이터 제품군은 단일 Firebase 프로젝트에 대한 제품을 에뮬레이트합니다.

사용할 프로젝트를 선택하려면 에뮬레이터를 시작하기 전에 CLI에서 작업 디렉터리에서 firebase use 를 실행합니다. 또는 --project 플래그를 각 에뮬레이터 명령에 전달할 수 있습니다.

로컬 에뮬레이터 제품군은 실제 Firebase 프로젝트 및 데모 프로젝트의 에뮬레이션을 지원합니다.

프로젝트 유형 특징 에뮬레이터와 함께 사용
진짜

실제 Firebase 프로젝트는 사용자가 만들고 구성한 프로젝트입니다(대부분 Firebase 콘솔을 통해).

실제 프로젝트에는 데이터베이스 인스턴스, 저장소 버킷, 함수 또는 해당 Firebase 프로젝트에 대해 설정한 기타 리소스와 같은 라이브 리소스가 있습니다.

실제 Firebase 프로젝트로 작업할 때 지원되는 제품의 일부 또는 전체에 대해 에뮬레이터를 실행할 수 있습니다.

에뮬레이트하지 않는 제품의 경우 앱과 코드가 라이브 리소스(데이터베이스 인스턴스, 스토리지 버킷, 기능 등)와 상호 작용합니다.

데모

데모 Firebase 프로젝트에는 실제 Firebase 구성과 라이브 리소스가 없습니다. 이러한 프로젝트는 일반적으로 Codelab 또는 기타 자습서를 통해 액세스합니다.

데모 프로젝트의 프로젝트 ID에는 demo- 접두사가 있습니다.

데모 Firebase 프로젝트로 작업할 때 앱과 코드는 에뮬레이터와 상호 작용합니다. 앱이 에뮬레이터가 실행되고 있지 않은 리소스와 상호 작용하려고 하면 해당 코드가 실패합니다.

가능하면 데모 프로젝트를 사용하는 것이 좋습니다. 혜택은 다음과 같습니다.

  • Firebase 프로젝트를 생성하지 않고도 에뮬레이터를 실행할 수 있으므로 설정이 간편합니다.
  • 코드가 실수로 에뮬레이션되지 않은(프로덕션) 리소스를 호출하는 경우 데이터 변경, 사용 및 청구 가능성이 없으므로 더 강력한 안전성
  • SDK 구성을 다운로드하기 위해 인터넷에 액세스할 필요가 없기 때문에 더 나은 오프라인 지원.

에뮬레이터와 통신하도록 앱 계측

Android, Apple 플랫폼 및 웹 SDK

다음과 같이 Firebase용 Cloud Storage 에뮬레이터와 상호작용하도록 인앱 구성 또는 테스트 클래스를 설정합니다.

기계적 인조 인간
FirebaseStorage.getInstance().useEmulator("10.0.2.2", 9199);
빠른
Storage.storage().useEmulator(withHost:"localhost", port:9199)
웹 v8
var storage = firebase.storage();
storage.useEmulator("localhost", 9199);
웹 v9
import { getStorage, connectStorageEmulator } from "firebase/storage";

const storage = getStorage();
connectStorageEmulator(storage, "localhost", 9199);

에뮬레이터를 사용하여 Firebase용 Cloud Storage 이벤트에 의해 트리거된 Cloud 기능을 테스트하기 위해 추가 설정이 필요하지 않습니다. Firebase용 Cloud Storage 및 Cloud Functions 에뮬레이터가 모두 실행 중인 경우 자동으로 함께 작동합니다.

관리 SDK

Firebase Admin SDK는 FIREBASE_STORAGE_EMULATOR_HOST 환경 변수가 설정되면 Firebase용 Cloud Storage 에뮬레이터에 자동으로 연결됩니다.

export FIREBASE_STORAGE_EMULATOR_HOST="localhost:9199"

Cloud Functions 에뮬레이터는 Firebase용 Cloud Storage 에뮬레이터를 자동으로 인식하므로 Cloud Functions와 Firebase용 Cloud Storage 에뮬레이터 간의 통합을 테스트할 때 이 단계를 건너뛸 수 있습니다. Firebase용 Cloud Storage의 Admin SDK에 대해 환경 변수가 자동으로 설정됩니다.

Admin SDK 코드가 다른 환경에서 실행되는 공유 에뮬레이터에 연결되도록 하려면 Firebase CLI를 사용하여 설정한 것과 동일한 프로젝트 ID 를 지정해야 합니다. 프로젝트 ID를 initializeApp 에 직접 전달하거나 GCLOUD_PROJECT 환경 변수를 설정할 수 있습니다.

Node.js 관리 SDK
admin.initializeApp({ projectId: "your-project-id" });
환경 변수
export GCLOUD_PROJECT="your-project-id"

데이터 가져오기 및 내보내기

Firebase 에뮬레이터용 데이터베이스 및 Cloud Storage를 사용하면 실행 중인 에뮬레이터 인스턴스에서 데이터를 내보낼 수 있습니다. 단위 테스트 또는 지속적 통합 워크플로에서 사용할 기본 데이터 세트를 정의한 다음 팀 간에 공유할 수 있도록 내보냅니다.

firebase emulators:export ./dir

테스트에서 에뮬레이터 시작 시 기준 데이터를 가져옵니다.

firebase emulators:start --import=./dir

내보내기 경로를 지정하거나 단순히 --import 플래그에 전달된 경로를 사용하여 종료 시 데이터를 내보내도록 에뮬레이터에 지시할 수 있습니다.

firebase emulators:start --import=./dir --export-on-exit

이러한 데이터 가져오기 및 내보내기 옵션은 firebase emulators:exec 명령어에서도 작동합니다. 자세한 내용은 에뮬레이터 명령 참조 를 참조하십시오.

Firebase용 Cloud Storage 에뮬레이터와 프로덕션의 차이점

클라이언트 앱 테스트의 경우 Firebase용 Cloud Storage 에뮬레이터는 Firebase API 노출 영역과 관련하여 프로덕션에 거의 완벽하게 맞춰집니다. 모든 Firebase 명령은 일반 Firebase SDK(웹, Android 및 Apple 플랫폼) 간에 작동해야 합니다.

서버 측 앱 테스트에는 제한 사항이 있습니다. Firebase Admin SDK는 Google Cloud API 노출 영역을 사용하며 이 API의 모든 엔드포인트가 에뮬레이트되는 것은 아닙니다. 일반적으로 클라이언트 SDK에서 수행할 수 있는 모든 작업(파일 업로드 또는 삭제, 메타데이터 가져오기 및 설정)도 Admin SDK에서 사용하기 위해 구현되지만 그 이상은 구현되지 않습니다. 주목할만한 제외 사항은 다음과 같습니다.

Google Cloud Storage와의 차이점

저장소 에뮬레이터를 포함한 Firebase용 Cloud Storage 제품은 Firebase 앱 개발에 매우 ​​유용한 저장소 객체에 중점을 둔 Google Cloud Storage(GCS) 기능의 하위 집합을 제공합니다. Firebase용 Cloud Storage는 다음과 같은 점에서 GCS와 다릅니다.

  • Firebase용 Cloud Storage는 현재 저장소 버킷 생성, 나열, 가져오기 또는 삭제를 위한 Bucket API를 지원하지 않습니다.
  • Google Cloud Storage Objects API 에서 지원되는 메서드는 copy , delete , get , insert , list , patch , rewrite , update 입니다.

클라우드 IAM

Firebase 에뮬레이터 제품군은 실행을 위한 IAM 관련 동작을 복제하거나 존중하지 않습니다. 에뮬레이터는 제공된 Firebase 보안 규칙을 준수하지만 IAM이 일반적으로 사용되는 상황(예: Cloud Functions 호출 서비스 계정 및 권한 설정)에서는 에뮬레이터를 구성할 수 없으며 개발자 컴퓨터에서 전역적으로 사용 가능한 계정을 사용합니다. 로컬 스크립트를 직접 실행하는 것과 유사합니다.

게시/구독 알림

Firebase용 Cloud Storage 에뮬레이터는 Cloud Pub/Sub 에뮬레이터와 통합되지 않으므로 저장소 객체 변경에 대한 채널/알림 생성을 지원하지 않습니다. Cloud Functions Storage 트리거를 직접 사용하는 것이 좋습니다.

버킷 수준 메타데이터

Firebase용 Cloud Storage 에뮬레이터는 저장소 클래스, 버킷 수준 CORS 구성, 라벨 또는 보관 정책을 포함한 버킷 수준 구성을 지원하지 않습니다. Firebase는 시간이 지남에 따라 이 지원을 개선할 계획입니다.

다음은?