How to run a Serverless Job

Reviewed on June 09, 2025

This page shows you how to manually run a Serverless Job from the Scaleway console. You can also run a Serverless Job with contextual options that only apply to one 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 job

How to run a job

1. Click Jobs in the Serverless section of the side menu. The Serverless Jobs page displays.
2. Click the name of the job you want to run. The job Overview tab displays.
3. Click the Actions button, then click Run job in the drop-down menu. Your job starts, and a new entry appears in the Job runs section.

The Job runs section contains basic monitoring information for your jobs:

• A status, that can be running, succeeded, canceled, or failed
• A unique identifier
• A start date and an end date
• The duration of the job execution

How to run a job with contextual options

1. Click Jobs in the Serverless section of the side menu. The Serverless Jobs page displays.
2. Click the name of the job you want to run. The job Overview tab displays.
3. Click the Actions button, then click Run job with options in the drop-down menu. The contextual options wizard displays.
4. Enter the following elements in the wizard:
   • Number of jobs to run: the number of simultaneous jobs to execute at the same time.
   • Contextual environment variables: the environment variables to use for this specific job run (in case of collision, overrides environment variables with the same key defined in the job definition).
   • Contextual startup command: the startup command to use for this specific job (overrides the startup command defined in the job definition).
5. Click Run job. Your job starts, and a new entry appears in the Job runs section.

The Job runs section contains basic monitoring information for your jobs:

• A status, that can be running, succeeded, canceled, or failed
• A unique identifier
• A start date and an end date
• The duration of the job execution

Permissions and product dependencies

Depending on the settings used, Serverless Jobs can have dependencies on other products, such as:

• Secret Manager: to securely inject data into jobs
• Container Registry: to store images of jobs

Executing a Serverless Job can fail if some permissions are not definied properly in an IAM policy, for example:

• If the job definition uses an image from Container Registry, add the ContainerRegistryReadOnly permission.
• If the job definition consumes data from Secret Manager, add the SecretManagerSecretAccess permission.

Refer to the dedicated documentation for comprehensive information on how to monitor jobs using Scaleway Cockpit.