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 에뮬레이터와 상호작용하도록 인앱 구성 또는 테스트 클래스를 설정합니다.

Kotlin+KTX
Firebase.storage.useEmulator("10.0.2.2", 9199)
Java
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_STORAGE_EMULATOR_HOST 환경 변수가 설정되면 Firebase Admin SDK는 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는 시간이 지남에 따라 이 지원을 개선할 계획입니다.

다음은?

  • 선별된 동영상 모음과 자세한 사용 방법 예시를 보려면 Firebase Emulators Training Playlist 를 따르세요.
  • 트리거 함수는 Firebase용 Cloud Storage와의 일반적인 통합이므로 Run functions local 에서 Firebase용 Cloud Functions 에뮬레이터에 대해 자세히 알아보세요.