Trigger

Available in VPC

This guide describes the Trigger interface layout and how to create triggers.
A trigger is a file that specifies a task schedule. Trigger cannot operate alone and operates when integrated with a job during workflow configuration.
To add a trigger as a workflow configuration component, see Create workflow.

Trigger interface

The trigger interface includes the following components:

View trigger information

To view the settings information on a created trigger:

1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Flow.
2. Click the Trigger menu.
3. When the trigger list appears, view the trigger information.
   • Trigger name: The unique name entered by the user when creating a trigger
   • Run option: The run option entered by the user when creating a trigger. One of the following values is displayed: Recurring execution, Cloud Functions event, or Manual execution.
   • Execution cycle: The execution cycle set by the user when creating a trigger. Example: Every Tuesday, daily 15:00.
   • Update date and time: Created date and time of the trigger
   • Click a trigger to expand its details below the list, where you can view the execution type, execution method or event source, creation date and time, and the associated workflow. For triggers with the Event execution type, the execution guide is also displayed.

Create triggers

To create a trigger:

1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Flow.
2. Click the Trigger menu.
3. Click [Create Trigger].
4. In the Create trigger popup, enter the following items:
   • Name: Enter the trigger name. Use 3 to 100 characters consisting only of uppercase and lowercase letters, numbers, hyphens (-), and underscores (). The value must begin with a letter or an underscore ().
   • Execution type: Select one of the following options: Schedule, Event, or Manual execution.
     • Schedule: Automatically run the workflow at a specified cycle or at a specific date and time.
     • Event: A Cloud Functions Action that receives an external event calls the DataFlow execution API to run the workflow.
     • Manual execution: Not executed automatically. Used when a user runs a workflow directly from the console.
   • Execution method: If Schedule is selected as the execution type: Select either Recurring execution or One-time execution
   • When selecting Recurring execution as the execution, Execute cycle: Select hourly, daily, weekly, or monthly.
   • When selecting Execution cycle Weekly, Execution week: Select the week for the workflow to run. Multiple selections allowed.
   • When selecting Execution cycle Monthly, Execution date: Enter the date between 1 to 31. Separate multiple dates with commas (,). If Last day of month is selected, the workflow also runs on the last day of each month. In this case, you do not need to enter a date.
   • When selecting Recurring execution as the execution method, Run time: Enter the time for the workflow to run.
     • When selecting Hourly as the execution cycle: Enter a number between 0 and 59 to specify the minute at which the workflow runs each hour. Example: 30 (Run at 30 minutes past every hour)
     • When selecting Daily, Weekly, or Monthly as the execution cycle: Enter the execution time in HH:mm format. Example: 12:00
   • When selecting One-time execution as the execution method, execution date: Click the icon, select the date and time to run the workflow, and then click [Apply]. The execution date and time must be at least 5 minutes later than the current time.
   • When selecting Event for the execution type, Event source: Select Cloud Functions. No additional input fields are required. After creating the trigger, you must configure a Cloud Functions Action to call the Data Flow execution API for the workflow to run. For more information about the configuration procedure, refer to Configuring Cloud Functions event triggers.
   • When selecting Manual execution for the execution type: No additional input field is required
5. Click [Create].
   • Creating a trigger is complete and is shown on the trigger list.
   • The created trigger is registered on NAVER Cloud Platform as resource. For more information, see Resource Manager concepts.

Delete triggers

To delete a trigger:

1. In the VPC environment of the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Flow.
2. Click the Trigger menu.
3. Select the specific trigger from the trigger list, and click [Delete].
   • The trigger is deleted from the trigger list.
   • Workflows that include a deleted trigger no longer run.

Set a Cloud Functions event trigger

Triggers with the Event execution type run the associated workflow when a Cloud Functions Action calls the Data Flow workflow execution API. You can use triggers supported by Cloud Functions, such as Object Storage file uploads, Cron schedules, and API Gateway requests, as workflow execution conditions.

For the configuration sequence, follow these steps:

1. Create a trigger with the Event execution type and add it to the workflow that you want to run. To add a trigger to the workflow, see Create workflow.
2. In the Trigger menu, click the trigger in the trigger list to expand its details. Check the following items:
   • Associated workflow: Copy the workflow ID
   • Execution guide: Click [View Sample Code] to copy the Python sample code for use in a Cloud Functions Action
3. In the Cloud Functions console, create an Action by using the copied sample code. Then, register NCLOUD_ACCESS_KEY, NCLOUD_SECRET_KEY, and DATAFLOW_WORKFLOW_ID as default parameters, and connect a Cloud Functions trigger that will be used as the workflow execution condition to the Action.
   • For detailed procedures on creating an Action, connecting a trigger, and verifying execution results, refer to Cloud Functions sample code - Data Flow integration.