Quản lý hàm


Bạn có thể triển khai, xoá và sửa đổi các hàm bằng cách sử dụng lệnh CLI của Firebase hoặc bằng cách đặt tuỳ chọn thời gian chạy trong mã nguồn của hàm.

Triển khai hàm

Để triển khai các hàm, hãy chạy lệnh CLI trong Firebase này:

firebase deploy --only functions

Theo mặc định, Giao diện dòng lệnh (CLI) của Firebase triển khai cùng lúc tất cả các hàm bên trong nguồn của bạn. Nếu dự án chứa nhiều hơn 5 hàm, bạn nên sử dụng cờ --only với các tên hàm cụ thể để chỉ triển khai các hàm đã chỉnh sửa. Việc triển khai các chức năng cụ thể bằng cách này sẽ đẩy nhanh quá trình triển khai và giúp bạn tránh đạt đến hạn mức triển khai. Ví dụ:

firebase deploy --only functions:addMessage,functions:makeUppercase

Khi triển khai số lượng lớn hàm, bạn có thể vượt quá hạn mức chuẩn và nhận được thông báo lỗi HTTP 429 hoặc 500. Để giải quyết vấn đề này, hãy triển khai các hàm theo nhóm từ 10 trở xuống.

Xem tài liệu tham khảo về CLI của Firebase để biết danh sách đầy đủ các lệnh có sẵn.

Theo mặc định, giao diện dòng lệnh (CLI) của Firebase sẽ tìm mã nguồn trong thư mục functions/. Nếu muốn, bạn có thể sắp xếp các hàm trong cơ sở mã hoặc nhiều tập hợp tệp.

Xoá hàm

Bạn có thể xoá các hàm đã triển khai trước đó theo những cách sau:

  • một cách rõ ràng trong Giao diện dòng lệnh (CLI) của Firebase với functions:delete
  • một cách rõ ràng trong bảng điều khiển Google Cloud.
  • ngầm ẩn bằng cách xoá hàm khỏi nguồn trước khi triển khai.

Mọi thao tác xoá đều nhắc bạn xác nhận trước khi xoá hàm khỏi phiên bản phát hành công khai.

Việc xoá hàm rõ ràng trong CLI của Firebase hỗ trợ nhiều đối số cũng như nhóm hàm, đồng thời cho phép bạn chỉ định một hàm chạy ở một khu vực cụ thể. Ngoài ra, bạn có thể ghi đè lời nhắc xác nhận.

# Delete all functions that match the specified name in all regions.
firebase functions:delete myFunction
# Delete a specified function running in a specific region.
firebase functions:delete myFunction --region us-east-1
# Delete more than one function
firebase functions:delete myFunction myOtherFunction
# Delete a specified functions group.
firebase functions:delete groupA
# Bypass the confirmation prompt.
firebase functions:delete myFunction --force

Khi xoá hàm ngầm ẩn, firebase deploy sẽ phân tích cú pháp nguồn của bạn và xoá khỏi phiên bản chính thức mọi hàm đã bị xoá khỏi tệp.

Sửa đổi tên, khu vực hoặc điều kiện kích hoạt của hàm

Nếu bạn đổi tên hoặc thay đổi các khu vực hay điều kiện kích hoạt cho các hàm đang xử lý lưu lượng truy cập chính thức, hãy làm theo các bước trong phần này để tránh bị mất các sự kiện trong quá trình sửa đổi. Trước khi làm theo các bước này, đầu tiên, hãy đảm bảo rằng hàm của bạn không hoạt động, vì cả phiên bản mới và phiên bản cũ của hàm đều sẽ chạy cùng lúc trong quá trình thay đổi.

Đổi tên hàm

Để đổi tên một hàm, hãy tạo một phiên bản mới được đổi tên của hàm đó trong nguồn, sau đó chạy 2 lệnh triển khai riêng biệt. Lệnh đầu tiên triển khai hàm mới được đặt tên và lệnh thứ hai xoá phiên bản đã triển khai trước đó. Ví dụ: nếu bạn muốn đổi tên một webhook được HTTP kích hoạt, hãy sửa đổi mã như sau:

Node.js

// before
const {onRequest}  = require('firebase-functions/v2/https');

exports.webhook = onRequest((req, res) => {
    res.send("Hello");
});

// after
const {onRequest}  = require('firebase-functions/v2/https');

exports.webhookNew = onRequest((req, res) => {
    res.send("Hello");
});

Python

# before
from firebase_functions import https_fn

@https_fn.on_request()
def webhook(req: https_fn.Request) -> https_fn.Response:
    return https_fn.Response("Hello world!")

# after
from firebase_functions import https_fn

@https_fn.on_request()
def webhook_new(req: https_fn.Request) -> https_fn.Response:
    return https_fn.Response("Hello world!")

Sau đó, hãy chạy các lệnh sau để triển khai hàm mới:

# Deploy new function
firebase deploy --only functions:webhookNew

# Wait until deployment is done; now both functions are running

# Delete webhook
firebase functions:delete webhook

Thay đổi khu vực hoặc khu vực của hàm

Nếu đang thay đổi khu vực đã chỉ định cho một hàm xử lý lưu lượng truy cập phát hành công khai, bạn có thể ngăn chặn tình trạng mất sự kiện bằng cách thực hiện các bước sau theo thứ tự:

  1. Đổi tên hàm rồi thay đổi vùng hoặc các vùng của hàm theo ý muốn.
  2. Triển khai hàm đã đổi tên, kết quả là sẽ tạm thời chạy cùng một mã ở cả hai nhóm khu vực.
  3. Xoá hàm trước đó.

Ví dụ: nếu bạn có một hàm được kích hoạt trên Cloud Firestore hiện đang ở khu vực hàm mặc định của us-central1 và bạn muốn di chuyển hàm đó sang asia-northeast1, thì trước tiên bạn cần sửa đổi mã nguồn để đổi tên hàm và sửa đổi khu vực.

Node.js

// before
exports.firestoreTrigger = onDocumentCreated(
  "my-collection/{docId}",
  (event) => {},
);

// after
exports.firestoreTriggerAsia = onDocumentCreated(
  {
    document: "my-collection/{docId}",
    region: "asia-northeast1",
  },
  (event) => {},
);

Mã cập nhật phải chỉ định đúng bộ lọc sự kiện (trong trường hợp này là document) cùng với khu vực. Hãy xem vị trí của Cloud Functions để biết thêm thông tin.

Python

# Before
@firestore_fn.on_document_created("my-collection/{docId}")
def firestore_trigger(event):
    pass

# After
@firestore_fn.on_document_created("my-collection/{docId}",
                                  region="asia-northeast1")
def firestore_trigger_asia(event):
    pass

Sau đó, triển khai bằng cách chạy:

firebase deploy --only functions:firestoreTriggerAsia

Hiện có 2 hàm giống hệt nhau đang chạy: firestoreTrigger đang chạy trong us-central1firestoreTriggerAsia đang chạy trong asia-northeast1.

Sau đó, xoá firestoreTrigger:

firebase functions:delete firestoreTrigger

Hiện chỉ có một hàm là firestoreTriggerAsia, đang chạy trong asia-northeast1.

Thay đổi loại điều kiện kích hoạt của hàm

Khi phát triển việc triển khai Cloud Functions cho Firebase theo thời gian, bạn có thể cần thay đổi loại điều kiện kích hoạt của một hàm vì nhiều lý do. Ví dụ: bạn có thể muốn thay đổi từ một loại Cơ sở dữ liệu theo thời gian thực của Firebase hoặc sự kiện trên Cloud Firestore sang một loại khác.

Bạn không thể thay đổi loại sự kiện của một hàm chỉ bằng cách thay đổi mã nguồn và chạy firebase deploy. Để tránh lỗi, hãy thay đổi loại điều kiện kích hoạt của một hàm theo quy trình sau:

  1. Sửa đổi mã nguồn để bao gồm một hàm mới có loại điều kiện kích hoạt mong muốn.
  2. Triển khai hàm, kết quả là sẽ tạm thời chạy cả hàm cũ và hàm mới.
  3. Xoá rõ ràng hàm cũ khỏi phiên bản phát hành công khai bằng cách sử dụng Firebase CLI.

Ví dụ: nếu bạn có một hàm được kích hoạt khi một đối tượng bị xoá, nhưng sau đó bạn đã bật tính năng tạo phiên bản đối tượng và muốn đăng ký sự kiện lưu trữ, thì trước tiên hãy đổi tên hàm đó và chỉnh sửa để có loại trình kích hoạt mới.

Node.js

// before
const {onObjectDeleted} = require("firebase-functions/v2/storage");

exports.objectDeleted = onObjectDeleted((event) => {
    // ...
});

// after
const {onObjectArchived} = require("firebase-functions/v2/storage");

exports.objectArchived = onObjectArchived((event) => {
    // ...
});

Python

# before
from firebase_functions import storage_fn

@storage_fn.on_object_deleted()
def object_deleted(event):
  # ...

# after 
from firebase_functions import storage_fn

@storage_fn.on_object_archived()
def object_archived(event):
  # ...

Sau đó, trước tiên, hãy chạy các lệnh sau để tạo hàm mới, trước khi xoá hàm cũ:

# Create new function objectArchived
firebase deploy --only functions:objectArchived

# Wait until deployment is done; now both objectDeleted and objectArchived are running

# Delete objectDeleted
firebase functions:delete objectDeleted

Đặt tuỳ chọn thời gian chạy

Hàm đám mây dành cho Firebase cho phép bạn chọn các tuỳ chọn thời gian chạy, chẳng hạn như phiên bản thời gian chạy Node.js và thời gian chờ trên mỗi hàm, phân bổ bộ nhớ cũng như các phiên bản hàm tối thiểu/tối đa.

Tốt nhất là bạn nên đặt các tuỳ chọn này (ngoại trừ phiên bản Node.js) trên đối tượng cấu hình bên trong mã hàm. Đối tượng RuntimeOptions này là nguồn đáng tin cậy cho các tuỳ chọn thời gian chạy của hàm và sẽ ghi đè các tuỳ chọn được đặt thông qua bất kỳ phương thức nào khác (chẳng hạn như thông qua bảng điều khiển Google Cloud hoặc gcloud CLI).

Nếu quy trình phát triển của bạn liên quan đến việc đặt các tuỳ chọn thời gian chạy theo cách thủ công qua bảng điều khiển Google Cloud hoặc gcloud CLI và bạn không muốn ghi đè các giá trị này trên mỗi lần triển khai, hãy đặt tuỳ chọn preserveExternalChanges thành true. Khi bạn đặt tuỳ chọn này thành true, Firebase sẽ hợp nhất các tuỳ chọn thời gian chạy đã đặt trong mã của bạn với chế độ cài đặt của phiên bản hàm đang được triển khai với mức độ ưu tiên như sau:

  1. Tuỳ chọn được đặt trong mã hàm: ghi đè các thay đổi bên ngoài.
  2. Tuỳ chọn được đặt thành RESET_VALUE trong mã hàm: ghi đè các thay đổi bên ngoài bằng giá trị mặc định.
  3. Tuỳ chọn không được đặt trong mã hàm nhưng được đặt trong hàm hiện đã triển khai: sử dụng tuỳ chọn được chỉ định trong hàm đã triển khai.

Bạn không nên sử dụng tuỳ chọn preserveExternalChanges: true trong hầu hết trường hợp, vì mã nguồn của bạn sẽ không còn là nguồn thông tin đầy đủ cho các tuỳ chọn thời gian chạy cho các hàm của bạn. Nếu bạn sử dụng, hãy kiểm tra bảng điều khiển Google Cloud hoặc sử dụng gcloud CLI để xem cấu hình đầy đủ của một chức năng.

Đặt phiên bản Node.js

Firebase SDK cho Cloud Functions cho phép lựa chọn thời gian chạy Node.js. Bạn có thể chọn chạy tất cả hàm trong một dự án chỉ trên môi trường thời gian chạy tương ứng với một trong các phiên bản Node.js được hỗ trợ sau:

  • Node.js 22 (bản xem trước)
  • Node.js 20
  • Node.js 18

Các phiên bản Node.js 14 và 16 không được dùng nữa và sẽ ngừng hoạt động vào đầu năm 2025. Tính năng triển khai với các phiên bản không dùng nữa sẽ bị tắt.

Cách đặt phiên bản Node.js:

Bạn có thể đặt phiên bản trong trường engines của tệp package.json được tạo trong thư mục functions/ trong quá trình khởi chạy. Ví dụ: để chỉ sử dụng phiên bản 18, hãy chỉnh sửa dòng này trong package.json:

  "engines": {"node": "20"}

Nếu đang sử dụng trình quản lý gói Yarn hoặc có các yêu cầu cụ thể khác đối với trường engines, bạn có thể đặt thời gian chạy cho Firebase SDK cho Cloud Functions trong firebase.json:

  {
    "functions": {
      "runtime": "nodejs18" // or nodejs20
    }
  }

CLI sử dụng giá trị được đặt trong firebase.json ưu tiên cho mọi giá trị hoặc dải ô mà bạn đặt riêng trong package.json.

Nâng cấp thời gian chạy Node.js

Cách nâng cấp thời gian chạy Node.js:

  1. Đảm bảo dự án của bạn đang sử dụng Gói giá linh hoạt.
  2. Đảm bảo rằng bạn đang sử dụng Firebase CLI phiên bản 11.18.0 trở lên.
  3. Thay đổi giá trị engines trong tệp package.json đã được tạo trong thư mục functions/ trong quá trình khởi tạo. Ví dụ: nếu bạn đang nâng cấp từ phiên bản 18 lên phiên bản 20, thì mục nhập sẽ có dạng như sau: "engines": {"node": "20"}
  4. Bạn có thể kiểm thử các thay đổi bằng Bộ mô phỏng cục bộ Firebase (không bắt buộc).
  5. Triển khai lại tất cả các chức năng.

Đặt phiên bản Python

Firebase SDK for Cloud Functions phiên bản 12.0.0 trở lên cho phép lựa chọn thời gian chạy Python. Thiết lập phiên bản thời gian chạy trong firebase.json như dưới đây:

  {
    "functions": {
      "runtime": "python310" // or python311
    }
  }

Kiểm soát hành vi điều chỉnh tỷ lệ

Theo mặc định, Cloud Functions cho Firebase sẽ điều chỉnh số lượng thực thể đang chạy dựa trên số lượng yêu cầu gửi đến, có thể giảm xuống mức 0 thực thể khi lưu lượng truy cập giảm. Tuy nhiên, nếu ứng dụng của bạn yêu cầu độ trễ giảm và bạn muốn giới hạn số lần khởi động nguội, thì bạn có thể thay đổi hành vi mặc định này bằng cách chỉ định số lượng thực thể vùng chứa tối thiểu được giữ ấm và sẵn sàng phân phát các yêu cầu.

Tương tự, bạn có thể đặt một số tối đa để giới hạn việc mở rộng quy mô của thực thể để phản hồi các yêu cầu gửi đến. Hãy sử dụng chế độ cài đặt này như một cách để kiểm soát chi phí hoặc giới hạn số lượng kết nối với một dịch vụ sao lưu, chẳng hạn như một cơ sở dữ liệu.

Khi sử dụng các chế độ cài đặt này cùng với chế độ cài đặt đồng thời cho mỗi phiên bản (mới trong thế hệ thứ 2), bạn có thể kiểm soát và điều chỉnh hành vi điều chỉnh tỷ lệ cho các hàm của mình. Bản chất của ứng dụng và chức năng sẽ xác định chế độ cài đặt nào tiết kiệm chi phí nhất và sẽ mang lại hiệu suất cao nhất.

Đối với một số ứng dụng có lưu lượng truy cập thấp, tuỳ chọn CPU thấp hơn mà không có mô hình đa đồng thời là lựa chọn tối ưu. Đối với những thực thể khác mà quy trình khởi động nguội là vấn đề nghiêm trọng, việc đặt tính đồng thời cao và thực thể tối thiểu có nghĩa là một tập hợp các thực thể luôn được giữ ấm để xử lý các trường hợp tăng đột biến về lưu lượng truy cập.

Đối với các ứng dụng có quy mô nhỏ hơn và nhận được rất ít lưu lượng truy cập, việc đặt các thực thể tối đa thấp có tính đồng thời cao có nghĩa là ứng dụng có thể xử lý các đợt tăng lưu lượng truy cập mà không phát sinh chi phí quá mức. Tuy nhiên, lưu ý rằng khi số thực thể tối đa được đặt quá thấp, yêu cầu có thể bị loại bỏ khi đạt đến mức trần.

Cho phép các yêu cầu đồng thời

Trong Cloud Functions cho Firebase (thế hệ thứ 1), mỗi thực thể có thể xử lý một yêu cầu tại một thời điểm. Vì vậy, hành vi điều chỉnh tỷ lệ chỉ được thiết lập với các chế độ cài đặt số lượng thực thể tối thiểu và tối đa. Ngoài việc kiểm soát số lượng thực thể, trong Hàm đám mây dành cho Firebase (thế hệ thứ 2), bạn còn có thể kiểm soát số lượng yêu cầu mà mỗi thực thể có thể phân phát cùng lúc bằng tuỳ chọn concurrency. Giá trị mặc định cho mô hình đồng thời là 80, nhưng bạn có thể thiết lập thành bất kỳ số nguyên nào từ 1 đến 1000.

Các hàm có chế độ cài đặt đồng thời cao hơn có thể hấp thụ lưu lượng truy cập tăng đột biến mà không cần khởi động nguội vì mỗi thực thể có thể có một mức trần. Nếu một thực thể được định cấu hình để xử lý tối đa 50 yêu cầu đồng thời nhưng hiện chỉ xử lý 25 yêu cầu, thì thực thể đó có thể xử lý trường hợp tăng đột biến 25 yêu cầu bổ sung mà không cần có phiên bản mới để khởi động nguội. Ngược lại, với chế độ cài đặt đồng thời chỉ là 1, mức tăng đột biến về số yêu cầu có thể dẫn đến 25 lần khởi động nguội.

Trường hợp đơn giản này minh hoạ mức tăng hiệu quả tiềm năng của mô hình đồng thời. Trong thực tế, việc mở rộng quy mô hành vi để tối ưu hoá hiệu quả và giảm tình trạng khởi động nguội bằng mô hình đồng thời phức tạp hơn. Tính năng đồng thời trong Cloud Functions cho Firebase thế hệ thứ 2 sử dụng công nghệ của Cloud Run và tuân theo các quy tắc của Cloud Run về việc tự động cấp tài nguyên bổ sung cho thực thể vùng chứa.

Khi thử nghiệm các chế độ cài đặt đồng thời cao hơn trong Cloud Functions cho Firebase (thế hệ thứ 2), hãy lưu ý những điều sau:

  • Các chế độ cài đặt đồng thời cao hơn có thể yêu cầu CPU và RAM cao hơn để có hiệu suất tối ưu cho đến khi đạt giới hạn thực tế. Ví dụ: một hàm xử lý nhiều hình ảnh hoặc video có thể thiếu tài nguyên để xử lý 1.000 yêu cầu đồng thời, ngay cả khi chế độ cài đặt CPU và RAM của hàm đó được tối đa hoá.
  • Vì Cloud Functions cho Firebase (thế hệ thứ 2) hoạt động dựa trên sự hỗ trợ của Cloud Run, nên bạn cũng có thể tham khảo hướng dẫn của Google Cloud để tối ưu hoá mô hình đồng thời.
  • Hãy nhớ kiểm thử kỹ lưỡng mô hình đa đồng thời trong một môi trường kiểm thử trước khi chuyển sang mô hình đa đồng thời trong thực tế.

Duy trì số lượng thực thể tối thiểu

Bạn có thể đặt số lượng thực thể tối thiểu cho một hàm trong mã nguồn. Ví dụ: hàm này đặt tối thiểu 5 thực thể để giữ ấm:

Node.js

const { onCall } = require("firebase-functions/v2/https");

exports.getAutocompleteResponse = onCall(
  {
    // Keep 5 instances warm for this latency-critical function
    minInstances: 5,
  },
  (event) => {
    // Autocomplete user’s search term
  }
);

Python

@https_fn.on_call(min_instances=5)
def get_autocomplete_response(event: https_fn.CallableRequest) -> https_fn.Response:

Dưới đây là một số điều cần xem xét khi đặt giá trị số thực thể tối thiểu:

  • Nếu Cloud Functions cho Firebase mở rộng quy mô ứng dụng của bạn trên mức tuỳ chọn cài đặt của bạn, thì bạn sẽ phải khởi động nguội cho mỗi thực thể vượt quá ngưỡng đó.
  • Khởi động nguội có ảnh hưởng nghiêm trọng nhất đến các ứng dụng có lưu lượng truy cập tăng đột biến. Nếu ứng dụng có lưu lượng truy cập tăng đột biến và bạn đặt giá trị đủ cao để giảm số lượt khởi động nguội mỗi khi lưu lượng truy cập tăng lên, thì bạn sẽ thấy độ trễ giảm đáng kể. Đối với các ứng dụng có lưu lượng truy cập liên tục, việc khởi động nguội không có khả năng ảnh hưởng nghiêm trọng đến hiệu suất.
  • Việc đặt các thực thể tối thiểu có thể phù hợp với môi trường phát hành chính thức, nhưng thường nên tránh trong môi trường kiểm thử. Để điều chỉnh tỷ lệ về 0 trong dự án kiểm thử nhưng vẫn giảm số lượt khởi động nguội trong dự án chính thức, bạn có thể đặt giá trị thực thể tối thiểu trong cấu hình có tham số:

    Node.js

    const functions = require('firebase-functions');
    const { defineInt, defineString } = require('firebase-functions/params');
    
    // Define some parameters
    const minInstancesConfig = defineInt('HELLO_WORLD_MININSTANCES');
    const welcomeMessage = defineString('WELCOME_MESSAGE');
    
    // To use configured parameters inside the config for a function, provide them 
    // directly. To use them at runtime, call .value() on them.
    export const helloWorld = functions.runWith({ minInstances: minInstancesConfig}).https.onRequest(
      (req, res) => {
        res.send(`${welcomeMessage.value()}! I am a function.`);
      }
    );
    

    Python

    MIN_INSTANCES = params.IntParam("HELLO_WORLD_MININSTANCES")
    WELCOME_MESSAGE = params.StringParam("WELCOME_MESSAGE")
    
    @https_fn.on_request(min_instances=MIN_INSTANCES.value())
    def get_autocomplete_response(event: https_fn.Request) -> https_fn.Response:
        return https_fn.Response(f"{WELCOME_MESSAGE.value()} I'm a function.")
    

Giới hạn số lượng thực thể tối đa của một hàm

Bạn có thể đặt giá trị cho số thực thể tối đa trong mã nguồn của hàm. Ví dụ: hàm này đặt giới hạn 100 thực thể để không gây choáng ngợp cơ sở dữ liệu cũ giả định:

Node.js

const { onMessagePublished } = require("firebase-functions/v2/pubsub");

exports.mirrorevents = onMessagePublished(
  { topic: "topic-name", maxInstances: 100 },
  (event) => {
    // Connect to legacy database
  }
);

Python

@pubsub_fn.on_message_published(topic="topic-name", max_instances=100)
def mirrorevents(event: pubsub_fn.CloudEvent):
#  Connect to legacy database

Nếu một hàm HTTP được mở rộng đến giới hạn số thực thể tối đa, thì các yêu cầu mới sẽ được thêm vào hàng đợi trong 30 giây, sau đó bị từ chối bằng mã phản hồi 429 Too Many Requests nếu không có thực thể nào sau đó.

Để tìm hiểu thêm về các phương pháp hay nhất khi sử dụng chế độ cài đặt số thực thể tối đa, hãy xem các phương pháp hay nhất để đặt số thực thể tối đa.

Đặt thời gian chờ và phân bổ bộ nhớ

Trong một số trường hợp, các hàm của bạn có thể có yêu cầu đặc biệt về giá trị thời gian chờ dài hoặc quy trình phân bổ bộ nhớ lớn. Bạn có thể đặt các giá trị này trong bảng điều khiển Google Cloud hoặc trong mã nguồn hàm (chỉ dành cho Firebase).

Để thiết lập quy trình phân bổ bộ nhớ và thời gian chờ trong mã nguồn của các hàm, hãy sử dụng các tuỳ chọn chung cho bộ nhớ và thời gian chờ theo giây để tuỳ chỉnh máy ảo đang chạy các hàm của bạn. Ví dụ: hàm Cloud Storage này sử dụng 1GiB bộ nhớ và hết thời gian chờ sau 300 giây:

Node.js

exports.convertLargeFile = onObjectFinalized({
  timeoutSeconds: 300,
  memory: "1GiB",
}, (event) => {
  // Do some complicated things that take a lot of memory and time
});

Python

@storage_fn.on_object_finalized(timeout_sec=300, memory=options.MemoryOption.GB_1)
def convert_large_file(event: storage_fn.CloudEvent):
# Do some complicated things that take a lot of memory and time.

Giá trị tối đa cho số giây thời gian chờ là 540 hoặc 9 phút.

Cách thiết lập quy trình phân bổ bộ nhớ và thời gian chờ trong bảng điều khiển Google Cloud:

  1. Trong bảng điều khiển Google Cloud, hãy chọn Cloud Functions for Firebase (Chức năng đám mây cho Firebase) trên trình đơn bên trái.
  2. Chọn một hàm bằng cách nhấp vào tên của hàm đó trong danh sách hàm.
  3. Nhấp vào biểu tượng Chỉnh sửa trong trình đơn trên cùng.
  4. Chọn một quy trình phân bổ bộ nhớ trong trình đơn thả xuống có nhãn Đã phân bổ bộ nhớ.
  5. Nhấp vào More (Thêm) để hiển thị các tuỳ chọn nâng cao và nhập số giây vào hộp văn bản Hết thời gian chờ.
  6. Nhấp vào Lưu để cập nhật hàm.

Ghi đè giá trị mặc định của CPU

Phân bổ tối đa 2 GB bộ nhớ, mỗi hàm trong Cloud Functions cho Firebase (thế hệ thứ 2) mặc định là một CPU, sau đó tăng lên 2 CPU cho 4 và 8GB. Xin lưu ý rằng điều này khác biệt đáng kể so với hành vi mặc định thế hệ 1 theo cách có thể dẫn đến chi phí cao hơn một chút cho các hàm có bộ nhớ thấp như được thể hiện trong bảng sau:

RAM đã phân bổ CPU mặc định của phiên bản 1 (phân số) CPU mặc định của phiên bản 2 Mức tăng giá mỗi mili giây
128MB 1/12 1 10,5x
256MB 1/6 1 5,3x
512MB 1/3 1 Gấp 2,7 lần
1GB 12/7 1 1,6x
2GB 1 1 1x
4GB 2 2 1x
8GB 2 2 1x
16 GB không có 4 không có

Nếu bạn muốn hành vi của thế hệ 1 cho các hàm thế hệ 2 hơn, hãy đặt giá trị mặc định của thế hệ 1 làm tuỳ chọn chung:

Node.js

// Turn off Firebase defaults
setGlobalOptions({ cpu: 'gcf_gen1' });

Python

# Use 1st gen behavior
set_global_options(cpu="gcf_gen1")

Đối với các hàm cần nhiều CPU, thế hệ thứ 2 mang đến sự linh hoạt để định cấu hình CPU bổ sung. Bạn có thể tăng CPU theo từng chức năng như sau:

Node.js

// Boost CPU in a function:
export const analyzeImage = onObjectFinalized({ cpu: 2 }, (event) => {
  // computer vision goes here
});

Python

# Boost CPU in a function:
@storage_fn.on_object_finalized(cpu=2)
def analyze_image(event: storage_fn.CloudEvent):
# computer vision goes here