NavigationContentFooter
Jump toSuggest an edit

How to add a trigger to a container

Reviewed on 15 October 2024Published on 27 April 2023

This page shows you how to configure triggers for your Serverless Containers. A trigger is an event that invokes a container.

In a serverless architecture, a container is not running constantly, but is rather activated only when an event occurs. A trigger is a mechanism that connects the container to an event source and enables the container to run automatically in response to specific events.

A trigger can be an HTTP request, a message from a queue or stream, a CRON schedule etc. It is configured during the container deployment, and determines how and when the container will run.

Before you start

To complete the actions presented below, you must have:

  • A Scaleway account logged into the console
  • Owner status or IAM permissions allowing you to perform actions in the intended Organization
  • Created a containers namespace
  • Deployed a container from Scaleway Container Registry or an external registry
  • Activated SQS
  • Created credentials for SQS
  • Created an SQS queue
Important

You can create triggers on private containers, but to update the privacy of a container from public to private, you must recreate the existing SQS and NATS triggers after the privacy change. We are actively working to make this operation as seamless as possible.

Note

Triggers send messages through a POST request with the message body in the request body.

SQS triggers

SQS triggers allow you to automatically invoke a container using events stored in a queue.

SQS queues of the Scaleway Messaging and Queuing product are compatible with Serverless Containers.

The configuration of the queue retention can affect the behavior of the trigger. Refer to the Considerations to configure event retention for SQS trigger inputs page for more information.

  1. Click Containers in the Serverless section of the side menu. The containers page displays.
  2. Click the relevant containers namespace.
  3. Click the name of the container you want to manage. The container overview displays.
  4. Click the Triggers tab. The trigger configuration displays.
  5. Click Create trigger. The trigger creation form displays in a pop-up.
  6. Enter a name for your trigger and select the SQS (Scaleway) type, then select your queue name.
  7. Click Create trigger to launch the trigger creation.

When a message is pushed to the selected queues, the container will be triggered with the message content passed in the event object’s body.

NATS triggers

NATS triggers allow you to automatically invoke a container using messages sent in a NATS subject.

NATS subjects of the Scaleway Messaging and Queuing product are compatible with Serverless Containers.

  1. Click Containers in the Serverless section of the side menu. The containers page displays.
  2. Click the relevant containers namespace.
  3. Click the name of the container you want to manage. The container overview displays.
  4. Click the Triggers tab. The trigger configuration displays.
  5. Click Create trigger. The trigger creation form displays in a pop-up.
  6. Enter a name for your trigger and select the NATS (Scaleway) type, then select your NATS account and subject name.
  7. Click Create trigger to launch the trigger creation.

CRON triggers

CRON triggers allow you to invoke your containers based on a recurring schedule. The CRON triggers for Serverless Containers use the UTC time zone.

  1. Click Containers in the Serverless section of the side menu. The containers page displays.
  2. Click the relevant containers namespace.
  3. Click the name of the container you want to manage. The container overview displays.
  4. Click the Triggers tab. The trigger configuration displays.
  5. Click Create trigger. The trigger creation form displays in a pop-up.
  6. Enter a name for your trigger and select the CRON type. Enter the cron schedule in UNIX format and paste your JSON arguments in the form.
  7. Click Create trigger to launch the trigger creation.

The container will be invoked at the indicated time.

Note

Refer to the cron schedules reference for more information.

See also
How to monitor container logs and metricsHow to delete a container
API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2024 – Scaleway