Skip to content

Commit 1941474

Browse files
thomas-tacquetRoRoJjcirinosclwySamyOubouaziz
authored andcommitted
fix(serverless): concepts missing and order fix (scaleway#4258)
* fix(serverless): concepts missing and order fix * Apply suggestions from code review Co-authored-by: Rowena Jones <[email protected]> * missing suggestions * missing suggestions * Apply suggestions from code review Co-authored-by: Jessica <[email protected]> * fix(docs): remove rebase fail --------- Co-authored-by: Rowena Jones <[email protected]> Co-authored-by: Jessica <[email protected]> Co-authored-by: SamyOubouaziz <[email protected]>
1 parent ce86de8 commit 1941474

File tree

3 files changed

+52
-24
lines changed

3 files changed

+52
-24
lines changed

pages/serverless-containers/concepts.mdx

Lines changed: 26 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,13 @@ Only one HTTP port can be exposed per Serverless Container.
142142

143143
A container's privacy policy defines whether a container may be invoked anonymously (**public**) or only via an authentication mechanism provided by the [Scaleway API](https://www.scaleway.com/en/developers/api/serverless-containers/#authentication) (**private**).
144144

145+
## Queue trigger
146+
147+
A queue trigger is a mechanism that connects a container to a queue created with [Scaleway Queues](/serverless/messaging/concepts/#queues), and invokes the container automatically whenever a message is added to the queue.
148+
149+
For each message that is sent to a queue, the trigger reads the message and invokes the associated container with the message as the input parameter.
150+
The container can then process the message and perform any required actions, such as updating a database or sending a notification.
151+
145152
## Registry endpoint
146153

147154
The registry endpoint parameter is the resource linked to the container image used in your Serverless Container.
@@ -154,6 +161,17 @@ Use cases:
154161
* **Shorter timeouts:** Ideal for use cases with quick, predictable response times, such as HTTP APIs or real-time applications.
155162
* **Longer timeouts:** Useful for tasks requiring extended processing times, like data processing, report generation, or integration with slower external services.
156163

164+
## Rolling update
165+
166+
When deploying a new version of a Serverless Container, a rolling update is applied by default. This means that the new version of the service is gradually rolled out to your users without downtime.
167+
Here is how it works:
168+
169+
* When a new version of your container is deployed, the platform automatically starts routing traffic to it incrementally, while still serving requests from the old version until the new one is fully deployed.
170+
* Once the new version is successfully running, we gradually shift all traffic to it, ensuring zero downtime.
171+
* The old version is decommissioned once the new version is fully serving traffic.
172+
173+
This process ensures a seamless update experience, minimizing user disruption during deployments. If needed, you can also manage traffic splitting between versions during the update process, allowing you to test new versions with a subset of traffic before fully migrating to it.
174+
157175
## Sandbox
158176

159177
A sandbox is an isolation area for your container. Serverless Containers offer two sandboxing environments:
@@ -180,33 +198,21 @@ Serverless allows you to deploy your Functions (FaaS) and Containerized Applicat
180198

181199
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.
182200

183-
## Serverless Function
201+
## Serverless Containers
184202

185-
Serverless Functions are serverless, fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events.
203+
Serverless Containers is a fully managed service that enables you to run containerized applications in a scalable and serverless environment.
186204

187-
These functions automatically scale based on demand and are designed to be lightweight, event-driven, and easily deployable, eliminating the need to worry about infrastructure management. Functions is built on top of Serverless Containers, meaning you can run your functions packaged in containers and have them scale efficiently.
188-
189-
## Serverless Job
205+
It automatically handles infrastructure management, scaling, and load balancing, allowing you to focus on writing code without worrying about servers or clusters. Serverless Containers supports any language, framework, or binary that can run in a container, and it integrates seamlessly with other Scaleway services, making it ideal for deploying modern, event-driven, and API-based applications.
190206

191-
Serverless Jobs are similar to Serverless Containers but are better suited for running longer workloads. See [the comparaison between Serverless products](/serverless-containers/reference-content/difference-jobs-functions-containers) for more information.
192-
193-
## Queue trigger
194-
195-
A queue trigger is a mechanism that connects a container to a queue created with [Scaleway Queues](/messaging/concepts/#queues), and invokes the container automatically whenever a message is added to the queue.
196-
197-
For each message that is sent to a queue, the trigger reads the message and invokes the associated container with the message as the input parameter.
198-
The container can then process the message and perform any required actions, such as updating a database or sending a notification.
207+
## Serverless Functions
199208

200-
## Rolling update
209+
Serverless Functions are fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events.
201210

202-
When deploying a new version of a Serverless Container, a rolling update is applied by default. This means that the new version of the service is gradually rolled out to your users without downtime.
203-
Here is how it works:
211+
These functions automatically scale based on demand and are designed to be lightweight, event-driven, and easily deployable, eliminating the need to worry about infrastructure management. Functions is built on top of Serverless Containers, meaning you can run your functions packaged in containers and have them scale efficiently.
204212

205-
* When a new version of your container is deployed, the platform automatically starts routing traffic to the new version incrementally, while still serving requests from the old version until the new one is fully deployed.
206-
* Once the new version is successfully running, we gradually shift all traffic to it, ensuring zero downtime.
207-
* The old version is decommissioned once the new version is fully serving traffic.
213+
## Serverless Jobs
208214

209-
This process ensures a seamless update experience, minimizing user disruption during deployments. If needed, you can also manage traffic splitting between versions during the update process, allowing you to test new versions with a subset of traffic before fully migrating to it
215+
Serverless Jobs are similar to Serverless Containers but are better suited for running longer workloads. See [the comparison between Serverless products](/serverless-containers/reference-content/difference-jobs-functions-containers) for more information.
210216

211217
## Stateless
212218

pages/serverless-functions/concepts.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -158,15 +158,21 @@ Serverless allows you to deploy your Functions (FaaS) and Containerized Applicat
158158

159159
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.
160160

161-
## Serverless Function
161+
## Serverless Containers
162162

163-
Serverless Functions are serverless, fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events.
163+
Serverless Containers is a fully managed service that enables you to run containerized applications in a scalable and serverless environment.
164+
165+
It automatically handles infrastructure management, scaling, and load balancing, allowing you to focus on writing code without worrying about servers or clusters. Serverless Containers supports any language, framework, or binary that can run in a container, and it integrates seamlessly with other Scaleway services, making it ideal for deploying modern, event-driven, and API-based applications.
166+
167+
## Serverless Functions
168+
169+
Serverless Functions are fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events.
164170

165171
These functions automatically scale based on demand and are designed to be lightweight, event-driven, and easily deployable, eliminating the need to worry about infrastructure management. Functions is built on top of Serverless Containers, meaning you can run your functions packaged in containers and have them scale efficiently.
166172

167-
## Serverless Job
173+
## Serverless Jobs
168174

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

171177
## Stateless
172178

pages/serverless-jobs/concepts.mdx

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,22 @@ Performance metrics for your Serverless resources are natively available: see [m
6060

6161
A schedule (cron) is a mechanism used to automatically start a Serverless Job at a specific time on a recurring schedule. It works similarly to a traditional Linux cron job, using the `* * * * *` format. Refer to our [cron schedules reference](/serverless-jobs/reference-content/cron-schedules/) for more information.
6262

63+
## Serverless Containers
64+
65+
Serverless Containers is a fully managed service that enables you to run containerized applications in a scalable and serverless environment.
66+
67+
It automatically handles infrastructure management, scaling, and load balancing, allowing you to focus on writing code without worrying about servers or clusters. Serverless Containers supports any language, framework, or binary that can run in a container, and it integrates seamlessly with other Scaleway services, making it ideal for deploying modern, event-driven, and API-based applications.
68+
69+
## Serverless Functions
70+
71+
Serverless Functions are fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events.
72+
73+
These functions automatically scale based on demand and are designed to be lightweight, event-driven, and easily deployable, eliminating the need to worry about infrastructure management. Functions is built on top of Serverless Containers, meaning you can run your functions packaged in containers and have them scale efficiently.
74+
75+
## Serverless Jobs
76+
77+
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.
78+
6379
## Secrets reference
6480

6581
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.

0 commit comments

Comments
 (0)