NavigationContentFooter
Jump toSuggest an edit
Was this page helpful?

How to create a job

Reviewed on 13 May 2025Published on 09 November 2023

This page shows you how to create Serverless Jobs using the Scaleway console.

You can create a job from the Scaleway Container Registry, or any other public container registry, such as Docker Hub, AWS Container registries, GitLab container registry, etc.

Before you startLink to this anchor

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 Container Registry namespace and pushed a container image to it

Create a job from the Scaleway Container RegistryLink to this anchor

Scaleway’s Serverless Jobs allows you to create jobs from several container registries, including the Scaleway Container Registry which allows you to store, secure and manage all your custom container images effortlessly.

  1. Click Jobs in the Serverless section of the side menu. The jobs page displays.

  2. Click Create job. The job creation wizard displays.

Job configurationLink to this anchor

  1. Select the Scaleway Container Registry.

  2. Select the required Container Registry namespace from the drop-down list, and then select the container image and tag.

  3. Enter a name or use the automatically generated one. The name can only contain lowercase alphanumeric characters and dashes.

  4. Select the region in which your job will be created.

Job resources and scalingLink to this anchor

  1. Select the resources to allocate to your job at runtime. These define the performance characteristics of your job.

  2. Add a cron schedule in the * * * * * format, and select your time zone to run your job periodically. Refer to the cron schedules documentation for more information.

Job advanced optionsLink to this anchor

  1. Declare environment variables you want to inject into your job. For each environment variable, click +Add variable and enter the key/value pair.
  2. Add secrets references for your Job. Secret references are environment variables fetched from Scaleway Secret Manager that are injected into your job, but the values are not retained or displayed by Scaleway after initial validation.
    Note

    Encode your environment variables and secrets to base64 if they are too large, and contain carriage returns.

Job creation and executionLink to this anchor

  1. Verify the estimated cost.

  2. Click Create a job definition to finish. You are directed to the listing of your Serverless Jobs.

  3. Click the name of the job you just created. The Overview tab displays.

  4. Click Run job to execute it.

The execution appears in the Job runs section of the Overview tab.

Note

Refer to How to monitor a job to see the logs of the job you just executed.

Create a job from an external container registryLink to this anchor

Scaleway Serverless Jobs allows you to create jobs from external public container registries, such as Docker Hub, AWS container registries, GitLab container registry, etc.

Private external container registries are currently not supported.

Important

Scaleway's Container Registry allows for a seamless integration with Serverless Containers and Jobs at a competitive price. Serverless products support external public registries (such as Docker Hub), but we do not recommend using them due to uncontrolled rate limiting, which can lead to failures when starting resources, unexpected usage conditions, and pricing changes.

  1. Click Jobs in the Serverless section of the side menu. The jobs page displays.

  2. Click Create job. The job creation wizard displays.

Job configurationLink to this anchor

  1. Select the external container registry.

  2. Enter the public container image URL provided by the external registry, such as docker.io/alpine:latest.

  3. Enter a name or use the automatically generated one. The name can only contain lowercase alphanumeric characters and dashes.

  4. Select the region in which your job will be created.

Job resources and scalingLink to this anchor

  1. Select the resources to allocate to your job at runtime. These define the performance characteristics of your job.

  2. Add a cron schedule in the * * * * * format, and select your time zone to run your job periodically. Refer to the cron schedules documentation for more information.

Job advanced optionsLink to this anchor

  1. Declare environment variables you want to inject into your job. For each environment variable, click +Add variable and enter the key/value pair.
  2. Add secrets references for your Job. Secret references are environment variables fetched from Scaleway Secret Manager that are injected into your job, but the values are not retained or displayed by Scaleway after initial validation.
    Note

    Encode your environment variables and secrets to base64 if they are too large, and contain carriage returns.

Job creation and executionLink to this anchor

  1. Verify the estimated cost.

  2. Click Create a job definition to finish. You are directed to the listing of your Serverless Jobs.

  3. Click the name of the job you just created. The Overview tab displays.

  4. Click Run job to execute it.

The execution appears in the Job runs section of the Overview tab.

Note

Refer to How to monitor a job to see the logs of the job you just executed.

See also
How to run a job
Was this page helpful?
API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2025 – Scaleway
OSZAR »