Firebase 에뮬레이터 제품군을 사용한 로컬 개발

1. 시작하기 전에

Cloud Firestore 및 Cloud Functions와 같은 서버리스 백엔드 도구는 사용하기 매우 쉽지만 테스트하기 어려울 수 있습니다. Firebase 로컬 에뮬레이터 제품군을 사용하면 개발 컴퓨터에서 이러한 서비스의 로컬 버전을 실행할 수 있으므로 앱을 빠르고 안전하게 개발할 수 있습니다.

전제 조건

  • Visual Studio Code, Atom 또는 Sublime Text와 같은 간단한 편집기
  • Node.js 10.0.0 이상(Node.js를 설치하려면 nvm을 사용하고 , 버전을 확인하려면 node --version 실행하세요.)
  • Java 7 이상(Java를 설치하려면 이 지침을 사용하고 , 버전을 확인하려면 java -version 실행하세요.)

당신은 무엇을 할 것인가

이 Codelab에서는 여러 Firebase 서비스로 구동되는 간단한 온라인 쇼핑 앱을 실행하고 디버깅합니다.

  • Cloud Firestore: 실시간 기능을 갖춘 전 세계적으로 확장 가능한 서버리스 NoSQL 데이터베이스입니다.
  • Cloud Functions : 이벤트 또는 HTTP 요청에 대한 응답으로 실행되는 서버리스 백엔드 코드입니다.
  • Firebase 인증 : 다른 Firebase 제품과 통합되는 관리형 인증 서비스입니다.
  • Firebase 호스팅 : 웹 앱을 위한 빠르고 안전한 호스팅입니다.

로컬 개발을 활성화하려면 앱을 에뮬레이터 도구 모음에 연결합니다.

2589e2f95b74fa88.png

또한 다음 방법도 알아봅니다.

  • 앱을 에뮬레이터 제품군에 연결하는 방법과 다양한 에뮬레이터가 연결되는 방법입니다.
  • Firebase 보안 규칙의 작동 방식과 로컬 에뮬레이터에 대해 Firestore 보안 규칙을 테스트하는 방법입니다.
  • Firestore 이벤트에 의해 트리거되는 Firebase 함수를 작성하는 방법과 에뮬레이터 도구 모음에 대해 실행되는 통합 테스트를 작성하는 방법입니다.

2. 설정

소스 코드 받기

이 Codelab에서는 거의 완성된 Fire Store 샘플 버전으로 시작하므로 가장 먼저 해야 할 일은 소스 코드를 복제하는 것입니다.

$ git clone https://github.com/firebase/emulators-codelab.git

그런 다음 Codelab 디렉터리로 이동하여 이 Codelab의 나머지 부분을 작업하게 됩니다.

$ cd emulators-codelab/codelab-initial-state

이제 코드를 실행할 수 있도록 종속성을 설치합니다. 인터넷 연결 속도가 느린 경우 1~2분 정도 걸릴 수 있습니다.

# Move into the functions directory
$ cd functions

# Install dependencies
$ npm install

# Move back into the previous directory
$ cd ../

Firebase CLI 가져오기

에뮬레이터 도구 모음은 다음 명령을 사용하여 컴퓨터에 설치할 수 있는 Firebase CLI(명령줄 인터페이스)의 일부입니다.

$ npm install -g firebase-tools

다음으로 최신 버전의 CLI가 있는지 확인하세요. 이 Codelab은 버전 9.0.0 이상에서 작동하지만 이후 버전에는 더 많은 버그 수정이 포함되어 있습니다.

$ firebase --version
9.6.0

Firebase 프로젝트에 연결

Firebase 프로젝트가 없으면 Firebase 콘솔 에서 새 Firebase 프로젝트를 만듭니다. 선택한 프로젝트 ID를 기록해 두십시오. 나중에 필요합니다.

이제 이 코드를 Firebase 프로젝트에 연결해야 합니다. 먼저 다음 명령어를 실행하여 Firebase CLI에 로그인하세요.

$ firebase login

그런 다음 다음 명령을 실행하여 프로젝트 별칭을 만듭니다. $YOUR_PROJECT_ID Firebase 프로젝트의 ID로 바꿉니다.

$ firebase use $YOUR_PROJECT_ID

이제 앱을 실행할 준비가 되었습니다!

3. 에뮬레이터 실행

이 섹션에서는 앱을 로컬로 실행합니다. 이는 Emulator Suite를 부팅할 시간이라는 의미입니다.

에뮬레이터 시작

Codelab 소스 디렉터리 내에서 다음 명령어를 실행하여 에뮬레이터를 시작합니다.

$ firebase emulators:start --import=./seed

다음과 같은 출력이 표시됩니다.

$ firebase emulators:start --import=./seed
i  emulators: Starting emulators: auth, functions, firestore, hosting
⚠  functions: The following emulators are not running, calls to these services from the Functions emulator will affect production: database, pubsub
i  firestore: Importing data from /Users/samstern/Projects/emulators-codelab/codelab-initial-state/seed/firestore_export/firestore_export.overall_export_metadata
i  firestore: Firestore Emulator logging to firestore-debug.log
i  hosting: Serving hosting files from: public
✔  hosting: Local server: http://127.0.0.1:5000
i  ui: Emulator UI logging to ui-debug.log
i  functions: Watching "/Users/samstern/Projects/emulators-codelab/codelab-initial-state/functions" for Cloud Functions...
✔  functions[calculateCart]: firestore function initialized.

┌─────────────────────────────────────────────────────────────┐
│ ✔  All emulators ready! It is now safe to connect your app. │
│ i  View Emulator UI at http://127.0.0.1:4000                │
└─────────────────────────────────────────────────────────────┘

┌────────────────┬────────────────┬─────────────────────────────────┐
│ Emulator       │ Host:Port      │ View in Emulator UI             │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Authentication │ 127.0.0.1:9099 │ http://127.0.0.1:4000/auth      │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Functions      │ 127.0.0.1:5001 │ http://127.0.0.1:4000/functions │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Firestore      │ 127.0.0.1:8080 │ http://127.0.0.1:4000/firestore │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Hosting        │ 127.0.0.1:5000 │ n/a                             │
└────────────────┴────────────────┴─────────────────────────────────┘
  Emulator Hub running at 127.0.0.1:4400
  Other reserved ports: 4500

Issues? Report them at https://github.com/firebase/firebase-tools/issues and attach the *-debug.log files.

모든 에뮬레이터가 시작되었다는 메시지가 표시되면 앱을 사용할 준비가 된 것입니다.

웹 앱을 에뮬레이터에 연결

로그의 표를 보면 Cloud Firestore 에뮬레이터가 포트 8080 에서 수신 대기하고 인증 에뮬레이터가 포트 9099 에서 수신 대기하고 있음을 알 수 있습니다.

┌────────────────┬────────────────┬─────────────────────────────────┐
│ Emulator       │ Host:Port      │ View in Emulator UI             │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Authentication │ 127.0.0.1:9099 │ http://127.0.0.1:4000/auth      │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Functions      │ 127.0.0.1:5001 │ http://127.0.0.1:4000/functions │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Firestore      │ 127.0.0.1:8080 │ http://127.0.0.1:4000/firestore │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Hosting        │ 127.0.0.1:5000 │ n/a                             │
└────────────────┴────────────────┴─────────────────────────────────┘

프런트엔드 코드를 프로덕션이 아닌 에뮬레이터에 연결해 보겠습니다. public/js/homepage.js 파일을 열고 onDocumentReady 함수를 찾으세요. 코드가 표준 Firestore 및 인증 인스턴스에 액세스하는 것을 볼 수 있습니다.

공개/js/homepage.js

  const auth = firebaseApp.auth();
  const db = firebaseApp.firestore();

로컬 에뮬레이터를 가리키도록 dbauth 객체를 업데이트해 보겠습니다.

공개/js/homepage.js

  const auth = firebaseApp.auth();
  const db = firebaseApp.firestore();

  // ADD THESE LINES
  if (location.hostname === "127.0.0.1") {
    console.log("127.0.0.1 detected!");
    auth.useEmulator("http://127.0.0.1:9099");
    db.useEmulator("127.0.0.1", 8080);
  }

이제 앱이 로컬 머신(호스팅 에뮬레이터에서 제공)에서 실행 중일 때 Firestore 클라이언트도 프로덕션 데이터베이스가 아닌 로컬 에뮬레이터를 가리킵니다.

에뮬레이터UI 열기

웹 브라우저에서 http://127.0.0.1:4000/ 으로 이동합니다. Emulator Suite UI가 표시됩니다.

에뮬레이터 UI 홈 화면

Firestore 에뮬레이터의 UI를 보려면 클릭하세요. --import 플래그로 가져온 데이터로 인해 items 컬렉션에 이미 데이터가 포함되어 있습니다.

4ef88d0148405d36.png

4. 앱 실행

앱 열기

웹 브라우저에서 http://127.0.0.1:5000 으로 이동하면 Fire Store가 컴퓨터에서 로컬로 실행되는 것을 볼 수 있습니다!

939f87946bac2ee4.png

앱 사용

홈페이지에서 상품을 선택하고 장바구니에 추가를 클릭하세요. 안타깝게도 다음과 같은 오류가 발생합니다.

a11bd59933a8e885.png

그 버그를 고치자! 모든 것이 에뮬레이터에서 실행되기 때문에 실제 데이터에 영향을 미칠까 걱정하지 않고 실험할 수 있습니다.

5. 앱 디버그

버그 찾기

이제 Chrome 개발자 콘솔을 살펴보겠습니다. Control+Shift+J (Windows, Linux, Chrome OS) 또는 Command+Option+J (Mac)를 눌러 콘솔에서 오류를 확인하세요.

74c45df55291dab1.png

addToCart 메소드에 오류가 있었던 것 같습니다. 이를 살펴보겠습니다. 해당 메소드에서 uid 라는 항목에 액세스하려고 하는 위치는 어디이며 왜 null 이 될까요? 현재 메소드는 public/js/homepage.js 에서 다음과 같습니다.

공개/js/homepage.js

  addToCart(id, itemData) {
    console.log("addToCart", id, JSON.stringify(itemData));
    return this.db
      .collection("carts")
      .doc(this.auth.currentUser.uid)
      .collection("items")
      .doc(id)
      .set(itemData);
  }

아하! 앱에 로그인되어 있지 않습니다. Firebase 인증 문서 에 따르면 로그인하지 않은 경우 auth.currentUsernull 입니다. 이에 대한 검사를 추가해 보겠습니다.

공개/js/homepage.js

  addToCart(id, itemData) {
    // ADD THESE LINES
    if (this.auth.currentUser === null) {
      this.showError("You must be signed in!");
      return;
    }

    // ...
  }

앱 테스트

이제 페이지를 새로 고친 다음 장바구니에 추가를 클릭하세요. 이번에는 더 좋은 오류가 발생합니다.

c65f6c05588133f7.png

하지만 상단 툴바에서 로그인을 클릭한 후 다시 장바구니에 추가를 클릭하면 장바구니가 업데이트된 것을 확인할 수 있습니다.

그러나 숫자가 전혀 정확하지 않은 것 같습니다.

239f26f02f959eef.png

걱정하지 마세요. 해당 버그는 곧 수정될 예정입니다. 먼저, 장바구니에 상품을 추가했을 때 실제로 무슨 일이 일어났는지 자세히 살펴보겠습니다.

6. 로컬 기능 트리거

장바구니에 추가를 클릭하면 여러 에뮬레이터와 관련된 일련의 이벤트가 시작됩니다. 장바구니에 항목을 추가하면 Firebase CLI 로그에 다음과 같은 메시지가 표시됩니다.

i  functions: Beginning execution of "calculateCart"
i  functions: Finished "calculateCart" in ~1s

해당 로그를 생성하기 위해 발생한 네 가지 주요 이벤트와 관찰한 UI 업데이트가 있습니다.

68c9323f2ad10f7a.png

1) Firestore 쓰기 - 클라이언트

Firestore 컬렉션 /carts/{cartId}/items/{itemId}/ 에 새 문서가 추가되었습니다. public/js/homepage.js 내의 addToCart 함수에서 이 코드를 볼 수 있습니다.

공개/js/homepage.js

  addToCart(id, itemData) {
    // ...
    console.log("addToCart", id, JSON.stringify(itemData));
    return this.db
      .collection("carts")
      .doc(this.auth.currentUser.uid)
      .collection("items")
      .doc(id)
      .set(itemData);
  }

2) Cloud 함수가 트리거됨

Cloud 함수 calculateCart functions/index.js 에서 볼 수 있는 onWrite 트리거를 사용하여 장바구니 항목에 발생하는 모든 쓰기 이벤트(생성, 업데이트 또는 삭제)를 수신합니다.

함수/index.js

exports.calculateCart = functions.firestore
    .document("carts/{cartId}/items/{itemId}")
    .onWrite(async (change, context) => {
      try {
        let totalPrice = 125.98;
        let itemCount = 8;

        const cartRef = db.collection("carts").doc(context.params.cartId);

        await cartRef.update({
          totalPrice,
          itemCount
        });
      } catch(err) {
      }
    }
);

3) Firestore 쓰기 - 관리자

calculateCart 함수는 장바구니에 있는 모든 항목을 읽고 총 수량과 가격을 합산한 다음 "cart" 문서를 새로운 합계로 업데이트합니다(위의 cartRef.update(...) 참조).

4) Firestore 읽기 - 클라이언트

웹 프런트엔드는 장바구니 변경 사항에 대한 업데이트를 수신하도록 구독됩니다. public/js/homepage.js 에서 볼 수 있듯이 Cloud 함수가 새 합계를 작성하고 UI를 업데이트한 후 실시간 업데이트를 받습니다.

공개/js/homepage.js

this.cartUnsub = cartRef.onSnapshot(cart => {
   // The cart document was changed, update the UI
   // ...
});

요약

잘 하셨어요! 완전한 로컬 테스트를 위해 세 가지 다른 Firebase 에뮬레이터를 사용하는 완전한 로컬 앱을 설정하기만 하면 됩니다.

db82eef1706c9058.gif

하지만 더 많은 것이 있습니다! 다음 섹션에서는 다음 내용을 학습합니다.

  • Firebase 에뮬레이터를 사용하는 단위 테스트를 작성하는 방법
  • Firebase 에뮬레이터를 사용하여 보안 규칙을 디버깅하는 방법

7. 앱에 맞는 보안 규칙 만들기

우리 웹 앱은 데이터를 읽고 쓰지만 지금까지는 보안에 대해 전혀 걱정하지 않았습니다. Cloud Firestore는 '보안 규칙'이라는 시스템을 사용하여 데이터를 읽고 쓸 수 있는 액세스 권한이 있는 사람을 선언합니다. Emulator Suite는 이러한 규칙을 프로토타입화하는 좋은 방법입니다.

편집기에서 emulators-codelab/codelab-initial-state/firestore.rules 파일을 엽니다. 규칙에는 세 가지 주요 섹션이 있음을 알 수 있습니다.

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // User's cart metadata
    match /carts/{cartID} {
      // TODO: Change these! Anyone can read or write.
      allow read, write: if true;
    }

    // Items inside the user's cart
    match /carts/{cartID}/items/{itemID} {
      // TODO: Change these! Anyone can read or write.
      allow read, write: if true;
    }

    // All items available in the store. Users can read
    // items but never write them.
    match /items/{itemID} {
      allow read: if true;
    }
  }
}

지금은 누구나 우리 데이터베이스에 데이터를 읽고 쓸 수 있습니다! 우리는 유효한 작업만 통과하고 민감한 정보가 유출되지 않도록 하고 싶습니다.

이 Codelab에서는 최소 권한 원칙에 따라 모든 문서를 잠그고 모든 사용자가 필요한 모든 액세스 권한을 가질 때까지 점진적으로 액세스 권한을 추가합니다. 조건을 false 로 설정하여 액세스를 거부하도록 처음 두 규칙을 업데이트해 보겠습니다.

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // User's cart metadata
    match /carts/{cartID} {
      // UPDATE THIS LINE
      allow read, write: if false;
    }

    // Items inside the user's cart
    match /carts/{cartID}/items/{itemID} {
      // UPDATE THIS LINE
      allow read, write: if false;
    }

    // All items available in the store. Users can read
    // items but never write them.
    match /items/{itemID} {
      allow read: if true;
    }
  }
}

8. 에뮬레이터 및 테스트 실행

에뮬레이터 시작

명령줄에서 emulators-codelab/codelab-initial-state/ 에 있는지 확인하세요. 이전 단계에서 에뮬레이터가 계속 실행 중일 수 있습니다. 그렇지 않은 경우 에뮬레이터를 다시 시작하십시오.

$ firebase emulators:start --import=./seed

에뮬레이터가 실행되면 로컬에서 테스트를 실행할 수 있습니다.

테스트 실행

emulators-codelab/codelab-initial-state/ 디렉터리의 새 터미널 탭에 있는 명령줄에서

먼저 함수 디렉터리로 이동합니다(나머지 Codelab 동안 여기에 머물겠습니다).

$ cd functions

이제 함수 디렉터리에서 mocha 테스트를 실행하고 출력 상단으로 스크롤합니다.

# Run the tests
$ npm test

> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha

  shopping carts
    1) can be created and updated by the cart owner
    2) can be read only by the cart owner

  shopping cart items
    3) can be read only by the cart owner
    4) can be added only by the cart owner

  adding an item to the cart recalculates the cart total. 
    - should sum the cost of their items


  0 passing (364ms)
  1 pending
  4 failing

지금은 네 번의 실패가 있습니다. 규칙 파일을 빌드할 때 더 많은 테스트가 통과하는 것을 관찰하여 진행 상황을 측정할 수 있습니다.

9. 안전한 카트 접근

처음 두 가지 실패는 다음을 테스트하는 "장바구니" 테스트입니다.

  • 사용자는 자신의 카트만 생성하고 업데이트할 수 있습니다.
  • 사용자는 자신의 카트만 읽을 수 있습니다.

함수/test.js

  it('can be created and updated by the cart owner', async () => {
    // Alice can create her own cart
    await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart").set({
      ownerUID: "alice",
      total: 0
    }));

    // Bob can't create Alice's cart
    await firebase.assertFails(bobDb.doc("carts/alicesCart").set({
      ownerUID: "alice",
      total: 0
    }));

    // Alice can update her own cart with a new total
    await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart").update({
      total: 1
    }));

    // Bob can't update Alice's cart with a new total
    await firebase.assertFails(bobDb.doc("carts/alicesCart").update({
      total: 1
    }));
  });

  it("can be read only by the cart owner", async () => {
    // Setup: Create Alice's cart as admin
    await admin.doc("carts/alicesCart").set({
      ownerUID: "alice",
      total: 0
    });

    // Alice can read her own cart
    await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart").get());

    // Bob can't read Alice's cart
    await firebase.assertFails(bobDb.doc("carts/alicesCart").get());
  });

이 테스트를 통과하도록 합시다. 편집기에서 보안 규칙 파일인 firestore.rules 열고 match /carts/{cartID} 내의 명령문을 업데이트합니다.

Firestore.rules

rules_version = '2';
service cloud.firestore {
    // UPDATE THESE LINES
    match /carts/{cartID} {
      allow create: if request.auth.uid == request.resource.data.ownerUID;
      allow read, update, delete: if request.auth.uid == resource.data.ownerUID;
    }

    // ...
  }
}

이제 이러한 규칙은 카트 소유자의 읽기 및 쓰기 액세스만 허용합니다.

들어오는 데이터와 사용자 인증을 확인하기 위해 모든 규칙의 컨텍스트에서 사용할 수 있는 두 개체를 사용합니다.

  • request 개체에는 시도 중인 작업에 대한 데이터와 메타데이터가 포함되어 있습니다.
  • Firebase 프로젝트가 Firebase 인증을 사용하는 경우 request.auth 객체는 요청하는 사용자를 설명합니다.

10. 테스트 카트 액세스

에뮬레이터 도구 모음은 firestore.rules 저장될 때마다 규칙을 자동으로 업데이트합니다. 에뮬레이터를 실행하는 탭에서 규칙 업데이트됨 메시지를 보면 에뮬레이터에서 Rules updated 되었는지 확인할 수 있습니다.

5680da418b420226.png

테스트를 다시 실행하고 처음 두 테스트가 이제 통과하는지 확인합니다.

$ npm test

> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha

  shopping carts
    ✓ can be created and updated by the cart owner (195ms)
    ✓ can be read only by the cart owner (136ms)

  shopping cart items
    1) can be read only by the cart owner
    2) can be added only by the cart owner

  adding an item to the cart recalculates the cart total. 
    - should sum the cost of their items

  2 passing (482ms)
  1 pending
  2 failing

잘했어요! 이제 장바구니에 대한 액세스가 확보되었습니다. 다음 실패한 테스트로 넘어가겠습니다.

11. UI에서 '장바구니에 추가' 흐름을 확인하세요.

현재 장바구니 소유자는 장바구니를 읽고 쓸 수 있지만 장바구니에 있는 개별 항목을 읽거나 쓸 수는 없습니다. 그 이유는 소유자가 장바구니 문서에 액세스할 수 있지만 장바구니의 항목 하위 컬렉션 에는 액세스할 수 없기 때문입니다.

이는 사용자에게 손상된 상태입니다.

http://127.0.0.1:5000, 에서 실행 중인 웹 UI로 돌아가 장바구니에 항목을 추가해 보세요. items 하위 컬렉션에 생성된 문서에 대한 사용자 액세스 권한을 아직 사용자에게 부여하지 않았기 때문에 디버그 콘솔에 표시되는 Permission Denied 오류가 표시됩니다.

12. 장바구니 항목 접근 허용

이 두 가지 테스트는 사용자가 자신의 장바구니에만 항목을 추가하거나 항목을 읽을 수 있음을 확인합니다.

  it("can be read only by the cart owner", async () => {
    // Alice can read items in her own cart
    await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart/items/milk").get());

    // Bob can't read items in alice's cart
    await firebase.assertFails(bobDb.doc("carts/alicesCart/items/milk").get())
  });

  it("can be added only by the cart owner",  async () => {
    // Alice can add an item to her own cart
    await firebase.assertSucceeds(aliceDb.doc("carts/alicesCart/items/lemon").set({
      name: "lemon",
      price: 0.99
    }));

    // Bob can't add an item to alice's cart
    await firebase.assertFails(bobDb.doc("carts/alicesCart/items/lemon").set({
      name: "lemon",
      price: 0.99
    }));
  });

따라서 현재 사용자가 장바구니 문서의 ownerUID와 동일한 UID를 가지고 있는 경우 액세스를 허용하는 규칙을 작성할 수 있습니다. create, update, delete 에 대해 다른 규칙을 지정할 필요가 없으므로 데이터를 수정하는 모든 요청에 ​​적용되는 write 규칙을 사용할 수 있습니다.

항목 하위 컬렉션의 문서에 대한 규칙을 업데이트합니다. 조건문의 get Firestore에서 값(이 경우 장바구니 문서의 ownerUID 을 읽는 것입니다.

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // ...

    // UPDATE THESE LINES
    match /carts/{cartID}/items/{itemID} {
      allow read, write: if get(/databases/$(database)/documents/carts/$(cartID)).data.ownerUID == request.auth.uid;
    }

    // ...
  }
}

13. 테스트 장바구니 항목 액세스

이제 테스트를 다시 실행할 수 있습니다. 출력 상단으로 스크롤하여 추가 테스트가 통과하는지 확인합니다.

$ npm test

> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha

  shopping carts
    ✓ can be created and updated by the cart owner (195ms)
    ✓ can be read only by the cart owner (136ms)

  shopping cart items
    ✓ can be read only by the cart owner (111ms)
    ✓ can be added only by the cart owner


  adding an item to the cart recalculates the cart total. 
    - should sum the cost of their items


  4 passing (401ms)
  1 pending

멋진! 이제 모든 테스트가 통과되었습니다. 보류 중인 테스트가 하나 있지만 몇 단계를 거쳐 이를 완료하겠습니다.

14. "장바구니에 추가" 흐름을 다시 확인하세요.

웹 프런트 엔드( http://127.0.0.1:5000 )로 돌아가 장바구니에 항목을 추가합니다. 이는 테스트와 규칙이 클라이언트가 요구하는 기능과 일치하는지 확인하는 중요한 단계입니다. (마지막으로 UI 사용자를 시도했을 때 장바구니에 항목을 추가할 수 없었다는 점을 기억하세요!)

69ad26cee520bf24.png

클라이언트는 firestore.rules 저장되면 자동으로 규칙을 다시 로드합니다. 그러니 장바구니에 뭔가를 추가해 보세요.

요약

잘 하셨어요! 방금 앱의 보안을 향상시켰습니다. 이는 프로덕션 준비를 위한 필수 단계입니다! 이것이 프로덕션 앱이라면 이러한 테스트를 지속적인 통합 파이프라인에 추가할 수 있습니다. 이렇게 하면 다른 사람이 규칙을 수정하더라도 장바구니 데이터에 이러한 액세스 제어 기능이 있을 것이라는 확신을 가질 수 있습니다.

ba5440b193e75967.gif

하지만 더 많은 것이 있습니다!

계속하면 다음 내용을 배울 수 있습니다.

  • Firestore 이벤트에 의해 트리거되는 함수를 작성하는 방법
  • 여러 에뮬레이터에서 작동하는 테스트를 만드는 방법

15. Cloud Functions 테스트 설정

지금까지는 웹 앱의 프런트엔드와 Firestore 보안 규칙에 중점을 두었습니다. 하지만 이 앱은 사용자 장바구니를 최신 상태로 유지하기 위해 Cloud Functions도 사용하므로 해당 코드도 테스트하고 싶습니다.

에뮬레이터 도구 모음을 사용하면 Cloud Functions는 물론 Cloud Firestore 및 기타 서비스를 사용하는 기능도 쉽게 테스트할 수 있습니다.

편집기에서 emulators-codelab/codelab-initial-state/functions/test.js 파일을 열고 파일의 마지막 테스트로 스크롤합니다. 현재는 보류 중으로 표시되어 있습니다.

//  REMOVE .skip FROM THIS LINE
describe.skip("adding an item to the cart recalculates the cart total. ", () => {
  // ...

  it("should sum the cost of their items", async () => {
    ...
  });
});

테스트를 활성화하려면 .skip 제거하면 다음과 같이 됩니다.

describe("adding an item to the cart recalculates the cart total. ", () => {
  // ...

  it("should sum the cost of their items", async () => {
    ...
  });
});

그런 다음 파일 상단에서 REAL_FIREBASE_PROJECT_ID 변수를 찾아 실제 Firebase 프로젝트 ID로 변경합니다.

// CHANGE THIS LINE
const REAL_FIREBASE_PROJECT_ID = "changeme";

프로젝트 ID를 잊어버린 경우 Firebase 콘솔의 프로젝트 설정에서 Firebase 프로젝트 ID를 찾을 수 있습니다.

d6d0429b700d2b21.png

16. 기능 테스트 살펴보기

이 테스트는 Cloud Firestore와 Cloud Functions 간의 상호작용을 검증하므로 이전 Codelab의 테스트보다 더 많은 설정이 필요합니다. 이 테스트를 살펴보고 예상되는 내용에 대해 알아보겠습니다.

장바구니 만들기

Cloud Functions는 신뢰할 수 있는 서버 환경에서 실행되며 Admin SDK에서 사용하는 서비스 계정 인증을 사용할 수 있습니다. 먼저, initializeApp initializeAdminApp 사용하여 앱을 초기화합니다. 그런 다음 항목을 추가할 카트에 대한 DocumentReference를 만들고 카트를 초기화합니다.

it("should sum the cost of their items", async () => {
    const db = firebase
        .initializeAdminApp({ projectId: REAL_FIREBASE_PROJECT_ID })
        .firestore();

    // Setup: Initialize cart
    const aliceCartRef = db.doc("carts/alice")
    await aliceCartRef.set({ ownerUID: "alice", totalPrice: 0 });

    ...
  });

기능 트리거

그런 다음 기능을 실행하려면 장바구니 문서의 items 하위 컬렉션에 문서를 추가하세요. 두 개의 항목을 추가하여 함수에서 발생하는 추가를 테스트하고 있는지 확인하세요.

it("should sum the cost of their items", async () => {
    const db = firebase
        .initializeAdminApp({ projectId: REAL_FIREBASE_PROJECT_ID })
        .firestore();

    // Setup: Initialize cart
    const aliceCartRef = db.doc("carts/alice")
    await aliceCartRef.set({ ownerUID: "alice", totalPrice: 0 });

    //  Trigger calculateCart by adding items to the cart
    const aliceItemsRef = aliceCartRef.collection("items");
    await aliceItemsRef.doc("doc1").set({name: "nectarine", price: 2.99});
    await aliceItemsRef.doc("doc2").set({ name: "grapefruit", price: 6.99 });

    ...
    });
  });

테스트 기대치 설정

장바구니 문서의 변경 사항에 대한 리스너를 등록하려면 onSnapshot() 사용하세요. onSnapshot() 리스너 등록을 취소하기 위해 호출할 수 있는 함수를 반환합니다.

이 테스트에서는 $9.98 가격의 두 항목을 추가합니다. 그런 다음 장바구니에 예상된 itemCounttotalPrice 있는지 확인하세요. 그렇다면 함수가 제 역할을 한 것입니다.

it("should sum the cost of their items", (done) => {
    const db = firebase
        .initializeAdminApp({ projectId: REAL_FIREBASE_PROJECT_ID })
        .firestore();

    // Setup: Initialize cart
    const aliceCartRef = db.doc("carts/alice")
    aliceCartRef.set({ ownerUID: "alice", totalPrice: 0 });

    //  Trigger calculateCart by adding items to the cart
    const aliceItemsRef = aliceCartRef.collection("items");
    aliceItemsRef.doc("doc1").set({name: "nectarine", price: 2.99});
    aliceItemsRef.doc("doc2").set({ name: "grapefruit", price: 6.99 });
    
    // Listen for every update to the cart. Every time an item is added to
    // the cart's subcollection of items, the function updates `totalPrice`
    // and `itemCount` attributes on the cart.
    // Returns a function that can be called to unsubscribe the listener.
    await new Promise((resolve) => {
      const unsubscribe = aliceCartRef.onSnapshot(snap => {
        // If the function worked, these will be cart's final attributes.
        const expectedCount = 2;
        const expectedTotal = 9.98;
  
        // When the `itemCount`and `totalPrice` match the expectations for the
        // two items added, the promise resolves, and the test passes.
        if (snap.data().itemCount === expectedCount && snap.data().totalPrice == expectedTotal) {
          // Call the function returned by `onSnapshot` to unsubscribe from updates
          unsubscribe();
          resolve();
        };
      });
    });
   });
 });

17. 테스트 실행

이전 테스트에서 에뮬레이터가 계속 실행 중일 수 있습니다. 그렇지 않은 경우 에뮬레이터를 시작하십시오. 명령줄에서 다음을 실행하세요.

$ firebase emulators:start --import=./seed

새 터미널 탭을 열고(에뮬레이터는 계속 실행 상태로 유지) 함수 디렉터리로 이동합니다. 보안 규칙 테스트에서 아직 열려 있을 수 있습니다.

$ cd functions

이제 단위 테스트를 실행하면 총 5개의 테스트가 표시됩니다.

$ npm test

> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha

  shopping cart creation
    ✓ can be created by the cart owner (82ms)

  shopping cart reads, updates, and deletes
    ✓ cart can be read by the cart owner (42ms)

  shopping cart items
    ✓ items can be read by the cart owner (40ms)
    ✓ items can be added by the cart owner

  adding an item to the cart recalculates the cart total. 
    1) should sum the cost of their items

  4 passing (2s)
  1 failing

구체적인 실패 내용을 보면 타임아웃 오류인 것으로 보입니다. 이는 테스트가 함수가 올바르게 업데이트되기를 기다리고 있지만 결코 업데이트되지 않기 때문입니다. 이제 테스트를 만족시키는 함수를 작성할 준비가 되었습니다.

18. 함수 작성

이 테스트를 수정하려면 functions/index.js 에서 함수를 업데이트해야 합니다. 이 기능 중 일부가 작성되었지만 완전하지는 않습니다. 현재 함수의 모습은 다음과 같습니다.

// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
    .firestore.document("carts/{cartId}/items/{itemId}")
    .onWrite(async (change, context) => {
      console.log(`onWrite: ${change.after.ref.path}`);
      if (!change.after.exists) {
        // Ignore deletes
        return;
      }

      let totalPrice = 125.98;
      let itemCount = 8;
      try {
        
        const cartRef = db.collection("carts").doc(context.params.cartId);

        await cartRef.update({
          totalPrice,
          itemCount
        });
      } catch(err) {
      }
    });

함수는 장바구니 참조를 올바르게 설정하지만 totalPriceitemCount 값을 계산하는 대신 하드코딩된 값으로 업데이트합니다.

가져오기 및 반복

items 하위 컬렉션

items 하위 컬렉션이 되도록 새 상수 itemsSnap 초기화합니다. 그런 다음 컬렉션의 모든 문서를 반복합니다.

// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
    .firestore.document("carts/{cartId}/items/{itemId}")
    .onWrite(async (change, context) => {
      console.log(`onWrite: ${change.after.ref.path}`);
      if (!change.after.exists) {
        // Ignore deletes
        return;
      }


      try {
        let totalPrice = 125.98;
        let itemCount = 8;

        const cartRef = db.collection("carts").doc(context.params.cartId);
        // ADD LINES FROM HERE
        const itemsSnap = await cartRef.collection("items").get();

        itemsSnap.docs.forEach(item => {
          const itemData = item.data();
        })
        // TO HERE
       
        return cartRef.update({
          totalPrice,
          itemCount
        });
      } catch(err) {
      }
    });

totalPrice 및 itemCount 계산

먼저 totalPriceitemCount 값을 0으로 초기화하겠습니다.

그런 다음 반복 블록에 논리를 추가합니다. 먼저 상품에 가격이 있는지 확인하세요. 항목에 지정된 수량이 없으면 기본값을 1 로 둡니다. 그런 다음 itemCount 의 누계에 수량을 추가합니다. 마지막으로 항목의 가격에 수량을 곱한 값을 totalPrice 의 누계에 추가합니다.

// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
    .firestore.document("carts/{cartId}/items/{itemId}")
    .onWrite(async (change, context) => {
      console.log(`onWrite: ${change.after.ref.path}`);
      if (!change.after.exists) {
        // Ignore deletes
        return;
      }

      try {
        // CHANGE THESE LINES
        let totalPrice = 0;
        let itemCount = 0;

        const cartRef = db.collection("carts").doc(context.params.cartId);
        const itemsSnap = await cartRef.collection("items").get();

        itemsSnap.docs.forEach(item => {
          const itemData = item.data();
          // ADD LINES FROM HERE
          if (itemData.price) {
            // If not specified, the quantity is 1
            const quantity = itemData.quantity ? itemData.quantity : 1;
            itemCount += quantity;
            totalPrice += (itemData.price * quantity);
          }
          // TO HERE
        })

        await cartRef.update({
          totalPrice,
          itemCount
        });
      } catch(err) {
      }
    });

성공 및 오류 상태 디버깅에 도움이 되도록 로깅을 추가할 수도 있습니다.

// Recalculates the total cost of a cart; triggered when there's a change
// to any items in a cart.
exports.calculateCart = functions
    .firestore.document("carts/{cartId}/items/{itemId}")
    .onWrite(async (change, context) => {
      console.log(`onWrite: ${change.after.ref.path}`);
      if (!change.after.exists) {
        // Ignore deletes
        return;
      }

      let totalPrice = 0;
      let itemCount = 0;
      try {
        const cartRef = db.collection("carts").doc(context.params.cartId);
        const itemsSnap = await cartRef.collection("items").get();

        itemsSnap.docs.forEach(item => {
          const itemData = item.data();
          if (itemData.price) {
            // If not specified, the quantity is 1
            const quantity = (itemData.quantity) ? itemData.quantity : 1;
            itemCount += quantity;
            totalPrice += (itemData.price * quantity);
          }
        });

        await cartRef.update({
          totalPrice,
          itemCount
        });

        // OPTIONAL LOGGING HERE
        console.log("Cart total successfully recalculated: ", totalPrice);
      } catch(err) {
        // OPTIONAL LOGGING HERE
        console.warn("update error", err);
      }
    });

19. 테스트 재실행

명령줄에서 에뮬레이터가 아직 실행 중인지 확인하고 테스트를 다시 실행하세요. 기능 변경 사항이 자동으로 적용되므로 에뮬레이터를 다시 시작할 필요가 없습니다. 모든 테스트가 통과된 것을 볼 수 있습니다.

$ npm test
> functions@ test .../emulators-codelab/codelab-initial-state/functions
> mocha

  shopping cart creation
    ✓ can be created by the cart owner (306ms)

  shopping cart reads, updates, and deletes
    ✓ cart can be read by the cart owner (59ms)

  shopping cart items
    ✓ items can be read by the cart owner
    ✓ items can be added by the cart owner

  adding an item to the cart recalculates the cart total. 
    ✓ should sum the cost of their items (800ms)


  5 passing (1s)

잘했어요!

20. Storefront UI를 사용하여 사용해 보세요.

최종 테스트를 위해 웹 앱( http://127.0.0.1:5000/ )으로 돌아가서 장바구니에 항목을 추가하세요.

69ad26cee520bf24.png

장바구니가 올바른 합계로 업데이트되는지 확인하세요. 환상적입니다!

요약

Firebase용 Cloud Functions와 Cloud Firestore 간의 복잡한 테스트 사례를 살펴보았습니다. 테스트를 통과하기 위해 Cloud 함수를 작성했습니다. 또한 새로운 기능이 UI에서 작동하는 것을 확인했습니다! 이 모든 작업은 로컬에서 수행되었으며 자신의 컴퓨터에서 에뮬레이터를 실행했습니다.

또한 로컬 에뮬레이터에 대해 실행되는 웹 클라이언트를 만들고, 데이터를 보호하기 위한 맞춤형 보안 규칙을 만들고, 로컬 에뮬레이터를 사용하여 보안 규칙을 테스트했습니다.

c6a7aeb91fe97a64.gif