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

앱을 Cloud Storage for Firebase 에뮬레이터에 연결하기 전에 전반적인 Firebase Local Emulator Suite 워크플로를 이해하고 사용자가 설치 및 구성하고 Local Emulator Suite를 확인하고 CLI 명령어를 검토합니다.

Firebase 프로젝트 선택

Firebase Local Emulator Suite는 단일 Firebase 프로젝트의 제품을 에뮬레이션합니다.

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

Local Emulator Suite는 실제 Firebase 프로젝트의 에뮬레이션을 지원합니다. demo 프로젝트를 모두 지원합니다.

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

실제 Firebase 프로젝트는 직접 만들고 구성한 프로젝트입니다. 대부분의 경우 Firebase 콘솔을 통해)

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

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

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

데모

데모 Firebase 프로젝트에는 실제 Firebase 구성이 없으며 라이브 리소스도 없습니다. 이러한 프로젝트는 일반적으로 Codelab 또는 기타 튜토리얼을 통해 액세스합니다.

데모 프로젝트의 프로젝트 ID에는 demo- 프리픽스가 있습니다.

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

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

  • 손쉬운 설정: Firebase 프로젝트를 만들지 않고도 에뮬레이터를 실행할 수 있습니다.
  • 강력한 안전성: 코드에서 실수로 에뮬레이션되지 않은(프로덕션) 리소스를 호출하더라도 데이터 변경, 사용, 청구 등이 발생할 가능성이 없습니다.
  • 오프라인 지원 향상: SDK 구성을 다운로드하기 위해 인터넷에 액세스할 필요가 없습니다.

에뮬레이터와 통신하도록 앱 구현

Android, Apple 플랫폼, 웹 SDK

다음과 상호작용하도록 인앱 구성이나 테스트 클래스를 설정합니다. Cloud Storage for Firebase 에뮬레이터에 추가하는 방법을 보여줍니다.

Kotlin+KTX
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
val storage = Firebase.storage
storage.useEmulator("10.0.2.2", 9199)
EmulatorSuite.kt
Java
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseStorage storage = FirebaseStorage.getInstance();
storage.useEmulator("10.0.2.2", 9199);
EmulatorSuite.java
Swift
Storage.storage().useEmulator(withHost: "127.0.0.1", port: 9199)
ViewController.swift

Web

const { getStorage, connectStorageEmulator } = require("firebase/storage");

const storage = getStorage();
if (location.hostname === "localhost") {
  // Point to the Storage emulator running on localhost.
  connectStorageEmulator(storage, "127.0.0.1", 9199);
} 
emulator-suite.js

Web

var storage = firebase.storage();
if (location.hostname === "localhost") {
  // Point to the Storage emulator running on localhost.
  storage.useEmulator("127.0.0.1", 9199);
} 
emulator-suite.js

Cloud Storage for Firebase 이벤트에 의해 트리거되는 Cloud 함수를 테스트하는 데는 추가 설정이 필요하지 않습니다. 시작할 수 있습니다. Cloud Storage for Firebase 및 Cloud Functions가 에뮬레이터가 둘 다 실행되고 있으면 자동으로 함께 작동합니다.

Admin SDK초

Firebase Admin SDK는 자동으로 Cloud Storage for Firebase에 연결됩니다. 에뮬레이터가 실행(FIREBASE_STORAGE_EMULATOR_HOST 환경 변수 설정)됩니다.

export FIREBASE_STORAGE_EMULATOR_HOST="127.0.0.1:9199"

Cloud Functions 에뮬레이터는 테스트 시 이 단계를 건너뛸 수 있는 Cloud Storage for Firebase 에뮬레이터 Cloud Functions 및 Cloud Storage for Firebase 간 통합 에뮬레이터입니다. Admin SDK에 환경 변수가 자동으로 설정됩니다. Cloud Storage for Firebase.

Admin SDK 코드를 다른 환경에서는 Firebase CLI를 사용하여 설정한 것과 동일한 프로젝트 ID를 지정해야 합니다. 프로젝트 ID를 initializeApp에 직접 전달하거나 GCLOUD_PROJECT 환경 변수입니다.

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

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

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

firebase emulators:export ./dir

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

firebase emulators:start --import=./dir

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

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

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

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

클라이언트 앱 테스트의 경우 Cloud Storage for Firebase 에뮬레이터는 다음과 같이 정렬됩니다. 거의 완벽한 프로덕션 환경을 제공합니다. 모든 Firebase 명령어는 일반 Firebase SDK(웹, Android, Apple 플랫폼)에서 작동합니다.

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

Google Cloud Storage와의 차이점

스토리지 에뮬레이터를 비롯한 Cloud Storage for Firebase 제품은 저장소 객체에 중점을 둔 Google Cloud Storage (GCS) 기능의 하위 집합 Firebase 앱 개발에 매우 유용합니다. Cloud Storage for Firebase GCS와 다른 점은 다음과 같습니다.

  • Cloud Storage for Firebase에서는 현재 다음 용도로 Bucket API를 지원하지 않습니다. 스토리지 버킷 생성, 나열, 가져오기 또는 삭제
  • Google Cloud Storage Objects API에서 copy, delete, get, insert, list, patch, rewrite, update 메서드가 지원됩니다.

Cloud IAM

Firebase 에뮬레이터 도구 모음은 실행을 위해 IAM 관련 동작을 복제하거나 준수하려는 시도를 하지 않습니다. 에뮬레이터는 제공된 Firebase 보안 규칙을 준수하지만 일반적으로 IAM을 사용하게 되는 상황(예: 서비스 계정과 따라서 권한을 호출하는 Cloud Functions를 설정)에서는 에뮬레이터를 구성할 수 없으며 로컬 스크립트를 직접 실행하는 것과 유사한 방식으로 개발 머신에서 글로벌 가용 계정을 사용하게 됩니다.

Pub/Sub 알림

Cloud Storage for Firebase 에뮬레이터가 Cloud와 통합되지 않음 Pub/Sub 에뮬레이터이므로 스토리지 객체 변경사항에 대한 채널/알림 이때 Cloud Functions 스토리지가 직접 트리거됩니다.

버킷 수준 메타데이터

Cloud Storage for Firebase 에뮬레이터는 버킷 수준을 지원하지 않음 스토리지 클래스, 버킷 수준 CORS 구성, 라벨, 보관 정책 등이 있습니다 Firebase는 관련 지원을 앞으로 개선하고자 합니다.

다음 단계