Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nếu bạn muốn lên lịch chạy các hàm vào thời gian cụ thể, hãy sử dụng trình xử lý onSchedule do firebase-functions/v2/scheduler cung cấp.
Các hàm này sử dụng Cloud Scheduler để gọi logic hàm tại thời điểm hoặc khoảng thời gian mà bạn xác định.
Trước khi bắt đầu
Mặc dù cần phải thanh toán, nhưng bạn có thể yên tâm rằng tổng chi phí sẽ nằm trong khả năng chi trả, vì mỗi Cloud Scheduler công việc có giá 0,10 USD/tháng và mỗi Tài khoản Google được phép có 3 công việc mà không mất phí. Sử dụng công cụ tính mức giá của Blaze để tạo chi phí ước tính dựa trên mức sử dụng dự kiến của bạn.
Bạn phải bật API Cloud Scheduler cho dự án của mình. Tính năng này sẽ được bật cho hầu hết các dự án Firebase; bạn có thể xác minh trong bảng điều khiển của Google Cloud.
Viết một hàm theo lịch
Trong Cloud Functions for Firebase, logic lập lịch nằm trong mã hàm của bạn mà không có yêu cầu đặc biệt nào về thời gian triển khai.
Ví dụ: để dọn dẹp các tài khoản người dùng không hoạt động mỗi ngày một lần, bạn có thể viết một hàm bắt đầu bằng các câu lệnh nhập sau:
Node.js
// The Cloud Functions for Firebase SDK to set up triggers and logging.const{onSchedule}=require("firebase-functions/v2/scheduler");const{logger}=require("firebase-functions");// The Firebase Admin SDK to delete inactive users.constadmin=require("firebase-admin");admin.initializeApp();// The es6-promise-pool to limit the concurrency of promises.constPromisePool=require("es6-promise-pool").default;// Maximum concurrent account deletions.constMAX_CONCURRENT=3;
# The Cloud Functions for Firebase SDK to set up triggers and logging.fromfirebase_functionsimportscheduler_fn# The Firebase Admin SDK to delete users.importfirebase_adminfromfirebase_adminimportauthfirebase_admin.initialize_app()
Sau đó, bạn có thể dùng onSchedule để bắt đầu một tác vụ Cloud Scheduler:
Node.js
// Run once a day at midnight, to clean up the users// Manually run the task here https://console.cloud.google.com/cloudschedulerexports.accountcleanup=onSchedule("every day 00:00",async(event)=>{// Fetch all user details.constinactiveUsers=awaitgetInactiveUsers();// Use a pool so that we delete maximum `MAX_CONCURRENT` users in parallel.constpromisePool=newPromisePool(()=>deleteInactiveUser(inactiveUsers),MAX_CONCURRENT,);awaitpromisePool.start();logger.log("User cleanup finished");});
# Run once a day at midnight, to clean up inactive users.# Manually run the task here https://console.cloud.google.com/cloudscheduler@scheduler_fn.on_schedule(schedule="every day 00:00")defaccountcleanup(event:scheduler_fn.ScheduledEvent)-> None:"""Delete users who've been inactive for 30 days or more."""user_page:auth.ListUsersPage|None=auth.list_users()whileuser_pageisnotNone:inactive_uids=[user.uidforuserinuser_page.usersifis_inactive(user,timedelta(days=30))]auth.delete_users(inactive_uids)user_page=user_page.get_next_page()
Khi bạn triển khai một hàm theo lịch, một tác vụ lập lịch và một hàm HTTP sẽ tự động được tạo. CLI Firebase sẽ lặp lại tên hàm và bạn có thể xem công việc cũng như hàm trong bảng điều khiển Google Cloud.
Chủ đề được đặt tên theo quy ước sau:
firebase-schedule-function_name-region
Ví dụ:
firebase-schedule-accountcleanup-us-east1.
Vào thời gian đã lên lịch, tài khoản dịch vụ mặc định của Compute Engine sẽ gọi hàm HTTP được liên kết. Điều này có nghĩa là chỉ có tác vụ Cloud Scheduler được liên kết mới có quyền chạy hàm.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[],[],null,["\u003cbr /\u003e\n\nIf you want to schedule functions to run at specified times, use\nthe `onSchedule` handler provided by `firebase-functions/v2/scheduler`.\nThese functions use [Cloud Scheduler](https://cloud.google.com/scheduler/)\nto invoke function logic at the times or intervals that you define.\n\nBefore you begin\n\nThough scheduled functions are billed, you can expect the overall\ncost to be manageable, as\neach Cloud Scheduler job costs $0.10 (USD) per month, and there is an\nallowance of three jobs per Google account, at no charge. Use the Blaze\n[pricing calculator](/pricing#blaze-calculator) to generate a cost estimate\nbased on your projected usage.\n\nThe Cloud Scheduler API must be enabled for your\nproject. It should already be enabled for most Firebase projects; you can\nverify in the [Google Cloud console](https://console.cloud.google.com/).\n\nWrite a scheduled function\n\nIn Cloud Functions for Firebase, scheduling logic resides in your functions code,\nwith no special deploy-time requirements.\nFor example, to clean up inactive user accounts once daily, you could write\na function starting with the following import statements: \n\nNode.js \n\n // The Cloud Functions for Firebase SDK to set up triggers and logging.\n const {onSchedule} = require(\"firebase-functions/v2/scheduler\");\n const {logger} = require(\"firebase-functions\");\n\n // The Firebase Admin SDK to delete inactive users.\n const admin = require(\"firebase-admin\");\n admin.initializeApp();\n\n // The es6-promise-pool to limit the concurrency of promises.\n const PromisePool = require(\"es6-promise-pool\").default;\n // Maximum concurrent account deletions.\n const MAX_CONCURRENT = 3; \n https://github.com/firebase/functions-samples/blob/c4fde45b65fab584715e786ce3264a6932d996ec/Node/delete-unused-accounts-cron/functions/index.js#L20-L31\n\nPython \n\n # The Cloud Functions for Firebase SDK to set up triggers and logging.\n from firebase_functions import scheduler_fn\n\n # The Firebase Admin SDK to delete users.\n import firebase_admin\n from firebase_admin import auth\n\n firebase_admin.initialize_app() \n https://github.com/firebase/functions-samples/blob/c4fde45b65fab584715e786ce3264a6932d996ec/Python/delete-unused-accounts-cron/functions/main.py#L19-L26\n\nThen, you could use `onSchedule` to start a Cloud Scheduler task: \n\nNode.js \n\n // Run once a day at midnight, to clean up the users\n // Manually run the task here https://console.cloud.google.com/cloudscheduler\n exports.accountcleanup = onSchedule(\"every day 00:00\", async (event) =\u003e {\n // Fetch all user details.\n const inactiveUsers = await getInactiveUsers();\n\n // Use a pool so that we delete maximum `MAX_CONCURRENT` users in parallel.\n const promisePool = new PromisePool(\n () =\u003e deleteInactiveUser(inactiveUsers),\n MAX_CONCURRENT,\n );\n await promisePool.start();\n\n logger.log(\"User cleanup finished\");\n }); \n https://github.com/firebase/functions-samples/blob/c4fde45b65fab584715e786ce3264a6932d996ec/Node/delete-unused-accounts-cron/functions/index.js#L35-L49\n\nPython \n\n # Run once a day at midnight, to clean up inactive users.\n # Manually run the task here https://console.cloud.google.com/cloudscheduler\n @scheduler_fn.on_schedule(schedule=\"every day 00:00\")\n def accountcleanup(event: scheduler_fn.ScheduledEvent) -\u003e None:\n \"\"\"Delete users who've been inactive for 30 days or more.\"\"\"\n user_page: auth.ListUsersPage | None = auth.list_users()\n while user_page is not None:\n inactive_uids = [\n user.uid for user in user_page.users if is_inactive(user, timedelta(days=30))\n ]\n auth.delete_users(inactive_uids)\n user_page = user_page.get_next_page() \n https://github.com/firebase/functions-samples/blob/c4fde45b65fab584715e786ce3264a6932d996ec/Python/delete-unused-accounts-cron/functions/main.py#L31-L42\n\nBoth Unix Crontab and App Engine syntax\nare supported by Cloud Scheduler. For example, to use Crontab, do something like this: \n\nNode.js \n\n exports.scheduledFunctionCrontab = onSchedule(\"5 11 * * *\", async (event) =\u003e {\n // ...\n });\n\nPython \n\n @scheduler_fn.on_schedule(schedule=\"5 11 * * *\")\n\n| **Important:** Depending on how you design your scheduling logic, a function may be triggered multiple times, with the next instance running while the previous instance is still executing.\n\nDeploy a scheduled function\n\nWhen you deploy a scheduled function, a scheduler job and an HTTP function\nare created automatically. The Firebase CLI echoes the function name,\nand you can view the job and the function in the\n[Google Cloud console](https://console.cloud.google.com/project/_/cloudscheduler).\nThe topic is named according to the following convention:\n\n**firebase-schedule-\u003cvar translate=\"no\"\u003efunction_name\u003c/var\u003e-\u003cvar translate=\"no\"\u003eregion\u003c/var\u003e**\n\nFor example:\n\n**firebase-schedule-accountcleanup-us-east1.**\n\nAt the scheduled time, the default compute service account invokes the\nassociated HTTP function. This means that only the associated Cloud Scheduler\njob has permission to run the function.\n| **Important:** Make sure you do not manually delete or modify the function or scheduler job in the console. Doing this could cause errors in the execution of your scheduled function."]]