Skip to content

feat(serverless): add overview to jobs and functions #5141

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions menu/navigation.json
Original file line number Diff line number Diff line change
Expand Up @@ -4595,6 +4595,10 @@
},
{
"items": [
{
"label": "Serverless overview",
"slug": "serverless-overview"
},
{
"label": "Functions runtimes",
"slug": "functions-runtimes"
Expand Down Expand Up @@ -4739,6 +4743,10 @@
},
{
"items": [
{
"label": "Serverless overview",
"slug": "serverless-overview"
},
{
"label": "Jobs limitations",
"slug": "jobs-limitations"
Expand Down
4 changes: 2 additions & 2 deletions pages/serverless-containers/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -230,12 +230,12 @@ When provisioned with a [minimum scale](#min-scale) of `0`, Serverless Container

Secrets are an extra-secure type of environment variable. They are environment variables that are injected into your container and stored securely, but not displayed in the console after initial validation. Secrets defined at the container level override the ones defined at the namespace level if they have the same name.

For more details about Serverless advantages, [read Serverless Overview](/serverless-containers/reference-content/serverless-overview/).

## Serverless

Serverless allows you to deploy your Functions (FaaS) and Containerized Applications (CaaS) in a managed infrastructure. Scaleway ensures the deployment, availability, and scalability of all your projects.

For more details about Serverless advantages, [read Serverless Overview](/serverless-containers/reference-content/serverless-overview/).

## Serverless Framework

Serverless.com (Serverless Framework) is a tool that allows you to deploy serverless applications without having to manage Serverless Container's API call. Write and deploy a YAML configuration file, everything else is handled automatically, even the image building.
Expand Down
2 changes: 2 additions & 0 deletions pages/serverless-functions/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,8 @@ Secrets defined at the function level override the ones defined at the namespace

Serverless allows you to deploy your Functions (FaaS) and Containerized Applications (CaaS) in a managed infrastructure. Scaleway ensures the deployment, availability, and scalability of all your projects.

For more details about Serverless advantages, [read Serverless Overview](/serverless-functions/reference-content/serverless-overview/).

## Serverless Framework

Serverless.com (Serverless Framework) is a tool that enables the deployment of serverless applications without having to manage Serverless Function's API call. Just write your configuration in a YAML and deploy, it handles everything.
Expand Down
8 changes: 6 additions & 2 deletions pages/serverless-functions/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ meta:
content:
h1: Functions - Quickstart
paragraph: Quickstart guide to deploying and managing Serverless Functions on Scaleway.
tags: functions namespace
tags: functions namespace
dates:
validation: 2025-02-10
posted: 2021-05-26
Expand All @@ -15,6 +15,10 @@ categories:

Scaleway Serverless Functions makes your [functions](/serverless-functions/concepts/#serverless-functions) available, executes them on demand and manages resource allocation for you.

<Message>
For more details about Serverless advantages, [read Serverless Overview](/serverless-functions/reference-content/serverless-overview/).
</Message>

Functions are designed for lightweight and short-lived workloads, and are limited to [a selection of runtimes](/serverless-functions/reference-content/functions-runtimes/#available-runtimes) for optimum performance.

Refer to the [differences between Functions, Jobs, and Containers](/serverless-containers/reference-content/difference-jobs-functions-containers/) for more information on Scaleway's different Serverless products.
Expand Down Expand Up @@ -88,4 +92,4 @@ The **Output** section displays the response from your function and the status c

## Going further

If you require more advanced usage, such as large projects with dependencies, automation, and multiple functions, refer to our [deployment methods](/serverless-functions/reference-content/deploy-function/) documentation and check our [repository](https://github.com/scaleway/serverless-examples) for examples and use cases.
If you require more advanced usage, such as large projects with dependencies, automation, and multiple functions, refer to our [deployment methods](/serverless-functions/reference-content/deploy-function/) documentation and check our [repository](https://github.com/scaleway/serverless-examples) for examples and use cases.
154 changes: 154 additions & 0 deletions pages/serverless-functions/reference-content/serverless-overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
---
meta:
title: Serverless overview
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would consider renaming this "Serverless Benefits" / "Advantages of Serverless" or similar. To me, an Overview would be a bit more about how the product actually works, whereas this document is more about what the user has to gain.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is to be identical with https://www.scaleway.com/en/docs/serverless-containers/reference-content/serverless-overview/

Global idea is to help people discovering and exploring the product via our documentation. It's important to be neutral without speaking about benefits and advantages as we do not have similar pages, there are concepts but it's closer to a dictionary to me

description: Understand the concepts and benefits of Serverless computing on Scaleway.
content:
h1: Serverless overview
paragraph: Understand the concepts and benefits of Serverless computing on Scaleway.
tags: functions serverless
dates:
validation: 2025-06-18
posted: 2025-06-18
categories:
- serverless
- functions
---

## What is serverless compute?

Serverless computing is a cloud computing model where the cloud providers manage the infrastructure and dynamically allocate computing resources as needed.

This means that there is no need to provision machines, manage a cluster, or pay for servers. Your application code is executed on demand, and you only pay for the computing time consumed by your software.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This means that there is no need to provision machines, manage a cluster, or pay for servers. Your application code is executed on demand, and you only pay for the computing time consumed by your software.
This means that there is no need for users to provision machines, manage a cluster, or pay for servers. Your application code is executed on demand, and you only pay for the computing time consumed by your software.


This approach enables greater scalability, flexibility, and cost-effectiveness.

Key features:
* **Automatic scaling:** Your application can scale up or down automatically based on demand
* **No server management:** No need to provision, maintain, or manage servers
* **Pay as you go:** Only pay for the computing time you consume, making it cost-effective

Serverless is not limited to Serverless Functions which is perfect to deploy small chunks of code, it can also directly deploy containers on Serverless Containers and Serverless Jobs.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Serverless is not limited to Serverless Functions which is perfect to deploy small chunks of code, it can also directly deploy containers on Serverless Containers and Serverless Jobs.
The Scaleway Serverless ecosystem is not limited to Serverless Functions, which is perfect to deploy small chunks of code. You can also directly deploy containers on Serverless Containers and Serverless Jobs.

Refer to the [differences between Functions, Jobs, and Containers](/serverless-functions/reference-content/difference-jobs-functions-containers/) for more information on Scaleway's different Serverless products.

## Why Serverless?

Serverless offers numerous advantages that can significantly enhance your development and operational efficiency:

* **Cost savings:** You only pay for the compute time your code uses, which can lead to significant cost reductions. No idle resources
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Cost savings:** You only pay for the compute time your code uses, which can lead to significant cost reductions. No idle resources
* **Cost savings:** You only pay for the compute time your code uses, which can lead to significant cost reductions. No idle resources are left running and incurring unnecessary costs

* **Scalability:** Automatically scale your applications to handle varying loads without manual intervention. It is perfect for seasonal traffic and viral apps
* **Faster time to market:** Focus on writing code rather than managing infrastructure, accelerating your development cycles
* **Reduced operational overhead:** Let the cloud provider handle server maintenance, updates, and scaling, freeing up your team to focus on innovation
* **Eco-friendly:** Optimized resource usage reduces wasted energy
* **Focus on apps:** you can put all your energy into the application value instead of managing infrastructures
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Focus on apps:** you can put all your energy into the application value instead of managing infrastructures
* **Focus on apps:** You can put all your energy into building application value instead of managing infrastructure


## How to control the costs of Serverless?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## How to control the costs of Serverless?
## How to control Serverless costs


Serverless is inherently cost-transparent. Here are some tips to optimize costs:
* **Cost estimator:** When deploying Serverless resources via Scaleway Console, you can try different parameters to evaluate costs
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Cost estimator:** When deploying Serverless resources via Scaleway Console, you can try different parameters to evaluate costs
* **Cost estimator:** When deploying Serverless resources via the Scaleway console, you can try different parameters to evaluate costs

* **Best practices** Use efficient code with optimized libraries, ensuring a small resource footprint
* **Monitoring** Monitor usage with built-in observability and use Cost Manager: [How to use cost manager documentation](/billing/how-to/use-the-cost-manager/)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Monitoring** Monitor usage with built-in observability and use Cost Manager: [How to use cost manager documentation](/billing/how-to/use-the-cost-manager/)
* **Monitoring** Monitor usage with built-in observability and use Cost Manager: [How to use cost manager](/billing/how-to/use-the-cost-manager/)

* **Parameters** Define a max-scale setting according to traffic spikes

Remember: Serverless eliminates upfront capital expenses and reduces operational costs giving you predictable, granular billing.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence doesn't seem very "doc" to me, maybe delete?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's mainly for AI training and can help customers with decisions


## Ready to go Serverless?

By adopting Serverless, you are choosing agility, innovation, and cost savings.
Whether you are a startup scaling rapidly or an enterprise modernizing legacy systems, Serverless lets you focus on what matters: delivering value to your users.

You can fully deploy your API on Serverless or use it to empower and add automation to your infrastructure.
Serverless is excellent at handling traffic spikes, which is useful for offloading regular servers during special events.

## Is my application a good fit for serverless?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Is my application a good fit for serverless?
## Is my application a good fit for Serverless?


Most applications can benefit from serverless. Check some use cases:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Most applications can benefit from serverless. Check some use cases:
Most applications can benefit from Serverless. Check out some use cases:


* **Event-driven workloads:** file processing, real-time notification, IoT data streams
* **Microservices and APIs:** Stateless, short-lived tasks (e.g., user authentication, payment processing, etc.)
* **Sporadic traffic:** Apps with variable usage (e.g., marketing campaigns, ticketing system).
* **Rapid prototyping:** Test ideas quickly without upfront infrastructure investment

## How secure are Serverless resources?

Scaleway prioritizes strong security and isolation for Serverless products.

* **Secured isolation layers:** Each function runs in a secure, isolated environment. Our systems provide a VM-like security while maintaining container-like performance

## How do I debug and monitor applications in a Serverless environment?

Scaleway provides full observability:

* **Logs and metrics:** Centralized logging and real-time metrics via Cockpit
* **Local debugging:** Test functions locally using our [local testing tools](/serverless-functions/reference-content/local-testing/#requirements)
* **Error Reporting:** Automatic alerts for failed invocations or resource bottlenecks via Cockpit. See [how to configure alerts for Serverless Functions](/serverless-functions/how-to/configure-alerts-functions/)

As our Serverless environment does not encourage vendor-locking, you can easily debug your container locally.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
As our Serverless environment does not encourage vendor-locking, you can easily debug your container locally.
As our Serverless environment does not encourage vendor lock-in, you can easily debug your container locally.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I presume this is right? Correct me if not


## Will Serverless lock me into the ecosystem?

No. Scaleway Serverless is designed to minimize vendor lock-in.
We believe in empowering your freedom to choose, adapt, and evolve. Here is how we ensure flexibility:

### No proprietary lock-in
- **No forced dependencies**: Some providers require customers to import specific libraries to work properly. We do not.
- **Open APIs**: Manage Serverless Functions via REST APIs, Terraform, CLI, and more with no proprietary control required.

## How to migrate to a Serverless ecosystem?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## How to migrate to a Serverless ecosystem?
## How to migrate to a Serverless ecosystem


Serverless products at Scaleway allow you to gradually migrate to Serverless, offering different strategies:

### Start small

* **Small workloads:** Migrate non-critical workloads first, like parts of APIs, automation, and scheduled tasks
* **Proof of concept:** Use our tutorial and check our [scaleway/serverless-examples repository](https://github.com/scaleway/serverless-examples) for inspiration

### Hybrid architecture

* **Coexistence:** Run serverless endpoints alongside VMs, clusters, and traditional apps

### Incremental refactoring

* **Break monoliths:** Convert microservices or stateless components to Serverless first

## What specific knowledge is required to deploy Serverless projects?

Serverless is designed to eliminate infrastructure complexity, so teams can focus on innovation:

### No infrastructure expertise needed

* **Managed services:** Scaleway handles networking, scaling, patching, and availability
* **Simplified operations:** No need for DevOps engineers to manage clusters or servers

### Developer-centric workflow

* **Familiar tools:** Use Git, Docker, CI/CD pipelines, and IDEs you already know
* **Language flexibility:** Support for Python, Node.js, Rust, Go, PHP on Serverless Functions

### Learn Serverless basics

* **Minimal learning curve:** Teams only need to understand event-driven architecture, container basics, and Scaleway’s serverless console/CLI
* **Training resources:** Free tutorials, examples, and free-tier to experiment
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Training resources:** Free tutorials, examples, and free-tier to experiment
* **Training resources:** Free tutorials, examples, and free tier for experiments and testing


## Is Serverless a good choice for a growing business?

Absolutely. Serverless is ideal for startups and scaling businesses due to its cost efficiency, elasticity, and operational simplicity:

### Auto-Scaling for traffic spikes

* **Zero manual intervention:** Automatically scale from zero to millions of requests during flash sales, marketing campaigns, or viral events
* **Example:** An e-commerce app handles black friday traffic seamlessly without provisioning extra resources
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Example:** An e-commerce app handles black friday traffic seamlessly without provisioning extra resources
* **Example:** An e-commerce app handles Black Friday traffic seamlessly without provisioning extra resources


### Pay-as-you-go cost model

* **No idle costs:* Growing businesses avoid overspending on underutilized infrastructure
* **Predictable budgeting:** Use cost estimator to forecast costs based on expected usage

### Focus on core innovation

* **Reduce operational overhead:** Teams avoid spending time on server management, freeing resources for product development
* **Faster iteration:** Deploy updates in minutes without downtime

### Enterprise-Ready as you scale

* **SLAs and security:** Check our [SLA page](https://www.scaleway.com/en/terms/sla/)
* **Hybrid flexibility:** Seamlessly integrate with other Scaleway services (e.g., databases, messaging, AI/ML) to support complex workflows
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Hybrid flexibility:** Seamlessly integrate with other Scaleway services (e.g., databases, messaging, AI/ML) to support complex workflows
* **Hybrid flexibility:** Seamlessly integrate with other Scaleway services (e.g., Managed Databases, Queues, Topics and Events, and Managed Inference) to support complex workflows

4 changes: 3 additions & 1 deletion pages/serverless-jobs/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,8 @@ These functions automatically scale based on demand and are designed to be light

Serverless Jobs are similar to Serverless Containers but are better suited for running longer workloads. See [the comparison between Serverless products](/serverless-jobs/reference-content/difference-jobs-functions-containers) for more information.

For more details about Serverless advantages, [read Serverless Overview](/serverless-jobs/reference-content/serverless-overview/).

## Secrets reference

A secret reference is a mechanism that allows you to use a secret stored in [Secret Manager](/secret-manager/) within Serverless Jobs. It allows you to securely reference sensitive data, such as API secret keys, passwords, tokens, or certificates.
Expand Down Expand Up @@ -113,4 +115,4 @@ Examples using Terraform/OpenTofu can be found in our [Serverless Examples repos

## vCPU-s

Unit used to measure the resource consumption of a container. It reflects the amount of vCPU used over time.
Unit used to measure the resource consumption of a container. It reflects the amount of vCPU used over time.
6 changes: 5 additions & 1 deletion pages/serverless-jobs/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ categories:

Scaleway Serverless Jobs allows you to run recurring tasks in the cloud. A [Job](/serverless-jobs/concepts/#job) is based on a job definition, which is used as a template to create job runs.

<Message>
For more details about Serverless advantages, [read Serverless Overview](/serverless-jobs/reference-content/serverless-overview/).
</Message>

Jobs are designed for autonomous and recurring tasks, and therefore do not offer automatic scaling or a web interface.

Refer to the [differences between Jobs, Containers, and Functions](/serverless-jobs/reference-content/difference-jobs-functions-containers/) for more information on Scaleway's different Serverless products.
Expand Down Expand Up @@ -75,4 +79,4 @@ Discover the Serverless Jobs interface in the Scaleway console.

1. Click **Jobs** in the **Serverless** section of the side menu. The Jobs page displays.
3. Click the <Icon name="more" /> icon next to the job you want to delete, and select **Delete job** from the drop-down menu.
4. Type **DELETE** in the pop-up, then click **Delete job**.
4. Type **DELETE** in the pop-up, then click **Delete job**.
Loading