Bắt đầu: viết, kiểm thử và triển khai các hàm đầu tiên (thế hệ thứ nhất)

Sau khi các hàm hoạt động như mong muốn trong trình mô phỏng, bạn có thể tiến hành triển khai, kiểm thử và chạy các hàm đó trong môi trường thực tế. Xin lưu ý rằng để triển khai cho môi trường thời gian chạy Node.js 14, dự án của bạn phải sử dụng gói giá Blaze. Xem giá của Cloud Functions.

Để hoàn tất hướng dẫn, hãy triển khai các hàm rồi thực thi addMessage() để kích hoạt makeUppercase().

1. Chạy lệnh này để triển khai các hàm:

    firebase deploy --only functions
    

   Sau khi bạn chạy lệnh này, CLI Firebase sẽ xuất URL cho mọi điểm cuối của hàm HTTP. Trong dòng lệnh, bạn sẽ thấy một dòng như sau:

   Function URL (addMessage): https://us-central1-MY_PROJECT.cloudfunctions.net/addMessage
   

   URL này chứa mã dự án cũng như khu vực cho hàm HTTP. Mặc dù bạn không cần lo lắng về vấn đề này, nhưng một số hàm HTTP chính thức nên chỉ định một vị trí để giảm thiểu độ trễ mạng.

   Nếu bạn gặp lỗi truy cập, chẳng hạn như "Không thể uỷ quyền truy cập vào dự án", hãy thử kiểm tra bí danh dự án.

2. Sử dụng URL addMessage() do CLI xuất ra, thêm tham số truy vấn văn bản và mở tham số đó trong trình duyệt:

   https://us-central1-MY_PROJECT.cloudfunctions.net/addMessage?text=uppercasemetoo
   

   Hàm này thực thi và chuyển hướng trình duyệt đến bảng điều khiển Firebase tại vị trí cơ sở dữ liệu nơi lưu trữ chuỗi văn bản. Sự kiện ghi này kích hoạt makeUppercase(), ghi phiên bản viết hoa của chuỗi.

Sau khi triển khai và thực thi các hàm, bạn có thể xem nhật ký trong bảng điều khiển Google Cloud. Nếu bạn cần xoá các hàm trong quá trình phát triển hoặc phát hành công khai, hãy sử dụng CLI Firebase.

Trong môi trường thực tế, bạn nên tối ưu hoá hiệu suất của hàm và kiểm soát chi phí bằng cách đặt số lượng thực thể tối thiểu và tối đa để chạy. Hãy xem phần Kiểm soát hành vi điều chỉnh tỷ lệ để biết thêm thông tin về các tuỳ chọn thời gian chạy này.

Xem mã mẫu hoàn chỉnh

Dưới đây là functions/index.js hoàn chỉnh chứa các hàm addMessage() và makeUppercase(). Các hàm này cho phép bạn truyền một tham số đến một điểm cuối HTTP ghi giá trị vào Cloud Firestore, sau đó biến đổi giá trị đó bằng cách viết hoa tất cả ký tự trong chuỗi.

// The Cloud Functions for Firebase SDK to create Cloud Functions and set up triggers.
const functions = require('firebase-functions/v1');

// The Firebase Admin SDK to access Firestore.
const { initializeApp } = require("firebase-admin/app");
const { getFirestore } = require("firebase-admin/firestore");
initializeApp();

// Take the text parameter passed to this HTTP endpoint and insert it into
// Firestore under the path /messages/:documentId/original
exports.addMessage = functions.https.onRequest(async (req, res) => {
  // Grab the text parameter.
  const original = req.query.text;
  // Push the new message into Firestore using the Firebase Admin SDK.
  const writeResult = await getFirestore()
    .collection("messages")
    .add({ original: original });
  // Send back a message that we've successfully written the message
  res.json({ result: `Message with ID: ${writeResult.id} added.` });
});

// Listens for new messages added to /messages/:documentId/original and creates an
// uppercase version of the message to /messages/:documentId/uppercase
exports.makeUppercase = functions.firestore
  .document("/messages/{documentId}")
  .onCreate((snap, context) => {
    // Grab the current value of what was written to Firestore.
    const original = snap.data().original;

    // Access the parameter `{documentId}` with `context.params`
    functions.logger.log("Uppercasing", context.params.documentId, original);

    const uppercase = original.toUpperCase();

    // You must return a Promise when performing asynchronous tasks inside a Functions such as
    // writing to Firestore.
    // Setting an 'uppercase' field in Firestore document returns a Promise.
    return snap.ref.set({ uppercase }, { merge: true });
  });
index.js

Các bước tiếp theo

Trong tài liệu này, bạn có thể tìm hiểu thêm về cách quản lý hàm cho Cloud Functions cũng như cách xử lý tất cả các loại sự kiện mà Cloud Functions hỗ trợ.

Để tìm hiểu thêm về Cloud Functions, bạn cũng có thể làm như sau:

• Đọc về các trường hợp sử dụng Cloud Functions.
• Hãy thử lớp học lập trình Cloud Functions.
• Xem lại và chạy mã mẫu trên GitHub