توابع زمانبندی

نسل دوم نسل اول

اگر می‌خواهید عملکردها را برای اجرا در زمان‌های مشخص زمان‌بندی کنید، از کنترل‌کننده onSchedule برای ایجاد یک موضوع Pub/Sub استفاده کنید که از Cloud Scheduler برای راه‌اندازی رویدادها در آن موضوع استفاده می‌کند.

قبل از شروع

برای استفاده از این راه حل در پروژه Firebase، پروژه شما باید در طرح قیمت گذاری Blaze باشد. اگر قبلاً در طرح Blaze نیست، طرح قیمت گذاری خود را ارتقا دهید .

اگرچه صورت‌حساب مورد نیاز است، می‌توانید انتظار داشته باشید که هزینه کلی قابل مدیریت باشد، زیرا هر کار Cloud Scheduler 0.10 دلار (دلار آمریکا) در ماه هزینه دارد، و سه شغل برای هر حساب Google بدون هیچ هزینه‌ای وجود دارد. از ماشین حساب قیمت گذاری Blaze برای ایجاد برآورد هزینه بر اساس استفاده پیش بینی شده خود استفاده کنید.

APIهای Pub/Sub و Cloud Scheduler باید برای پروژه شما فعال باشند. اینها قبلاً باید برای اکثر پروژه های Firebase فعال باشند. می توانید در کنسول Google Cloud تأیید کنید.

مهم: Cloud Scheduler برای پروژه شما نیاز به برنامه Google App Engine داشت. در طول راه اندازی آن از شما خواسته شد یک مکان را انتخاب کنید، و این مکان مکان پروژه شما برای منابع پیش فرض Google Cloud شد ( Cloud Scheduler یکی از این منابع است). این مکان برای منابعی در پروژه شما استفاده می‌شود که با App Engine مرتبط هستند، از جمله نمونه پایگاه داده پیش‌فرض Cloud Firestore و سطل Cloud Storage پیش‌فرض شما (مخصوصاً با فرمت نام *.appspot.com ).

با این حال، اکنون که Cloud Scheduler و اخیراً سطل‌های پیش‌فرض Cloud Storage (با قالب نام *.firebasestorage.app ) دیگر به App Engine وابستگی ندارد، فقط در صورتی که از توابع برنامه ریزی شده نسل اول استفاده می کنید، باید این مکان را در نظر بگیرید. سطل *.appspot.com .

یک تابع زمان بندی شده بنویسید

در Cloud Functions for Firebase ، منطق زمان‌بندی در کد توابع شما قرار دارد، بدون نیاز به زمان استقرار خاص. برای ایجاد یک تابع زمان بندی شده، از functions.pubsub.schedule('your schedule').onRun((context)) استفاده کنید. به عنوان مثال، برای اجرای یک تابع هر پنج دقیقه با دستور App Engine cron.yaml ، این کار را انجام دهید:

exports.scheduledFunction = functions.pubsub.schedule('every 5 minutes').onRun((context) => {
  console.log('This will be run every 5 minutes!');
  return null;
});

هر دو یونیکس Crontab و App Engine توسط Cloud Scheduler پشتیبانی می شوند. به عنوان مثال، برای استفاده از Crontab برای انتخاب یک منطقه زمانی خاص که در آن یک تابع زمان‌بندی شده اجرا شود، این کار را انجام دهید:

exports.scheduledFunctionCrontab = functions.pubsub.schedule('5 11 * * *')
  .timeZone('America/New_York') // Users can choose timezone - default is America/Los_Angeles
  .onRun((context) => {
  console.log('This will be run every day at 11:05 AM Eastern!');
  return null;
});

مقدار timeZone باید نام منطقه زمانی از پایگاه داده tz باشد. برای اطلاعات بیشتر در مورد ویژگی های پشتیبانی شده به مرجع Cloud Scheduler مراجعه کنید.

مهم: بسته به نحوه طراحی منطق زمان‌بندی خود، یک تابع ممکن است چندین بار راه‌اندازی شود و نمونه بعدی در حالی که نمونه قبلی هنوز در حال اجرا است اجرا شود.

یک تابع برنامه ریزی شده را مستقر کنید

وقتی یک تابع زمان‌بندی شده را اجرا می‌کنید، کار زمان‌بندی مرتبط و موضوع میخانه/فرعی به‌طور خودکار ایجاد می‌شود. Firebase CLI بازتاب نام موضوع است و می‌توانید کار و موضوع را در کنسول Google Cloud مشاهده کنید. موضوع بر اساس قرارداد زیر نامگذاری شده است:

firebase-scheduled- function_name - region

به عنوان مثال:

firebase-scheduled-scheduledFunctionCrontab-us-east1.

مهم: مطمئن شوید که موضوع یا زمان‌بندی کار را در کنسول به صورت دستی حذف یا تغییر ندهید. انجام این کار می تواند باعث ایجاد خطا در اجرای عملکرد برنامه ریزی شده شما شود.