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

앱을 Firebase용 Cloud Storage 에뮬레이터에 연결하기 전에 전반적인 Firebase 로컬 에뮬레이터 도구 모음 워크플로를 이해하고 로컬 에뮬레이터 도구 모음을 설치 및 구성하며 CLI 명령어를 검토해야 합니다.

Firebase 프로젝트 선택

Firebase 로컬 에뮬레이터 도구 모음은 단일 Firebase 프로젝트의 제품을 에뮬레이션합니다.

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

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

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

실제 Firebase 프로젝트는 주로 Firebase Console을 통해 만들고 구성한 프로젝트입니다.

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

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

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

데모

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

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

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

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

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

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

Android, Apple 플랫폼, 웹 SDK

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

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)
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);
Swift
Storage.storage().useEmulator(withHost: "127.0.0.1", port: 9199)

웹 모듈식 API

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);
} 

웹 네임스페이스화된 API

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

에뮬레이터를 사용하여 Firebase용 Cloud Storage 이벤트로 트리거되는 Cloud 함수를 테스트할 때는 추가 설정이 필요하지 않습니다. Firebase용 Cloud Storage와 Cloud Functions 에뮬레이터가 모두 실행되면 자동으로 함께 작동합니다.

Admin SDK

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

export FIREBASE_STORAGE_EMULATOR_HOST="127.0.0.1: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 Admin 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 메서드가 지원됩니다.

Cloud IAM

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

Pub/Sub 알림

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

버킷 수준 메타데이터

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

다음 단계