함수 예약

지정된 시간에 함수를 실행하도록 예약하려면 onSchedule 핸들러를 사용하여 Cloud Scheduler를 통해 해당 주제의 이벤트를 트리거하는 Pub/Sub 주제를 만듭니다.

시작하기 전에

결제는 필수지만 각 Cloud Scheduler 작업의 월별 비용은 $0.10(USD)이고 Google 계정당 작업이 3개까지 무료로 허용되므로 전반적인 비용은 부담스럽지 않은 수준일 것입니다. Blaze 가격 계산기를 사용하여 예상 사용량에 따른 예상 비용을 확인해 보세요.

프로젝트에 Pub/Sub 및 Cloud Scheduler API를 사용 설정해야 합니다. 대부분의 Firebase 프로젝트에는 이미 사용 설정되어 있어야 하며 Google Cloud 콘솔에서 사용 설정 여부를 확인할 수 있습니다.

예약 함수 작성

Cloud Functions for Firebase에서 일정 예약 로직은 별다른 배포 시간 요구사항 없이 함수 코드에 상주하고 있습니다. 예약된 함수를 만들려면 functions.pubsub.schedule('your schedule').onRun((context))을 사용합니다. 예를 들어 App Engine cron.yaml 구문을 사용하여 5분마다 함수를 실행하려면 다음과 같이 작성하면 됩니다.

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

Unix 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) => {
  functions.logger.log('This will be run every day at 11:05 AM Eastern!');
  return null;
});

timeZone의 값은 tz 데이터베이스에 등록된 시간대 이름이어야 합니다. 지원되는 속성에 대한 자세한 내용은 Cloud Scheduler 참조를 확인하세요.

예약된 함수의 context 객체에는 함수를 트리거한 Pub/Sub 이벤트에 관한 정보가 포함됩니다. 예를 들면 다음과 같습니다.

{
  "resource": {
    "name": "projects/PROJECT_ID/topics/PROJECT_TOPIC",
    "service": "pubsub.googleapis.com",
    "type": "type.googleapis.com/google.pubsub.v1.PubsubMessage"
  },
  "timestamp": "YYYY-MM-DDTHH:MM:SS.sssZ",
  "eventType": "google.pubsub.topic.publish",
  "eventId": "EVENT_ID",
  "params": {}
}

예약 함수 배포

예약 함수를 배포하면 관련 스케줄러 작업과 Pub/Sub 주제가 자동으로 만들어집니다. Firebase CLI는 주제 이름을 반영하며 Google Cloud 콘솔에서 작업과 주제를 볼 수 있습니다. 주제 이름은 다음 규칙에 따라 지정됩니다.

firebase-scheduled-function_name-region

예를 들면 다음과 같습니다.

firebase-scheduled-scheduledFunctionCrontab-us-east1.