From 7224612e5d13909d05eb501f9a4118d96cd33cb2 Mon Sep 17 00:00:00 2001 From: Thomas Tacquet Date: Tue, 21 Jan 2025 10:06:24 +0100 Subject: [PATCH 1/6] fix(serverless): concepts missing and order fix --- pages/serverless-containers/concepts.mdx | 30 +++++++++++++++++++++--- pages/serverless-functions/concepts.mdx | 14 ++++++++--- pages/serverless-jobs/concepts.mdx | 16 +++++++++++++ 3 files changed, 54 insertions(+), 6 deletions(-) diff --git a/pages/serverless-containers/concepts.mdx b/pages/serverless-containers/concepts.mdx index 6dceafd001..084f41e012 100644 --- a/pages/serverless-containers/concepts.mdx +++ b/pages/serverless-containers/concepts.mdx @@ -142,6 +142,13 @@ Only one HTTP port can be exposed per Serverless Container. 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**). +## Queue trigger + +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. + +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. +The container can then process the message and perform any required actions, such as updating a database or sending a notification. + ## Registry endpoint The registry endpoint parameter is the resource linked to the container image used in your Serverless Container. @@ -154,6 +161,17 @@ Use cases: * **Shorter timeouts:** Ideal for use cases with quick, predictable response times, such as HTTP APIs or real-time applications. * **Longer timeouts:** Useful for tasks requiring extended processing times, like data processing, report generation, or integration with slower external services. +## Rolling update + +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. +Here is how it works: + +* 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. +* Once the new version is successfully running, we gradually shift all traffic to it, ensuring zero downtime. +* The old version is decommissioned once the new version is fully serving traffic. + +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 + ## Sandbox A sandbox is an isolation area for your container. Serverless Containers offer two sandboxing environments: @@ -180,15 +198,21 @@ Serverless allows you to deploy your Functions (FaaS) and Containerized Applicat 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. -## Serverless Function +## Serverless Containers + +Serverless Containers is a fully managed service that enables you to run containerized applications in a scalable and serverless environment. + +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. + +## Serverless Functions 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. 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. -## Serverless Job +## Serverless Jobs -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. +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. ## Queue trigger diff --git a/pages/serverless-functions/concepts.mdx b/pages/serverless-functions/concepts.mdx index 45f0243ca2..2b354d97af 100644 --- a/pages/serverless-functions/concepts.mdx +++ b/pages/serverless-functions/concepts.mdx @@ -158,15 +158,23 @@ Serverless allows you to deploy your Functions (FaaS) and Containerized Applicat 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. -## Serverless Function +## Serverless Containers + +Serverless Containers is a fully managed service that enables you to run containerized applications in a scalable and serverless environment. + +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. + +## Serverless Functions 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. 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. -## Serverless Job +## Serverless Jobs + +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. -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. +Serverless Jobs are similar to Serverless Functions 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. ## Stateless diff --git a/pages/serverless-jobs/concepts.mdx b/pages/serverless-jobs/concepts.mdx index 4c6ce24ba7..ec13da30b5 100644 --- a/pages/serverless-jobs/concepts.mdx +++ b/pages/serverless-jobs/concepts.mdx @@ -60,6 +60,22 @@ Performance metrics for your Serverless resources are natively available: see [m 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. +## Serverless Containers + +Serverless Containers is a fully managed service that enables you to run containerized applications in a scalable and serverless environment. + +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. + +## Serverless Functions + +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. + +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. + +## Serverless Jobs + +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. + ## 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. From e6c9f19582de2841d6217ceb11733a7f409b6967 Mon Sep 17 00:00:00 2001 From: Thomas TACQUET Date: Tue, 21 Jan 2025 13:37:25 +0100 Subject: [PATCH 2/6] Apply suggestions from code review Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> --- pages/serverless-containers/concepts.mdx | 20 +------------------- pages/serverless-jobs/concepts.mdx | 6 +++++- 2 files changed, 6 insertions(+), 20 deletions(-) diff --git a/pages/serverless-containers/concepts.mdx b/pages/serverless-containers/concepts.mdx index 084f41e012..e3aa2ab328 100644 --- a/pages/serverless-containers/concepts.mdx +++ b/pages/serverless-containers/concepts.mdx @@ -206,7 +206,7 @@ It automatically handles infrastructure management, scaling, and load balancing, ## Serverless Functions -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. +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. 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. @@ -214,24 +214,6 @@ 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-containers/reference-content/difference-jobs-functions-containers) for more information. -## Queue trigger - -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. - -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. -The container can then process the message and perform any required actions, such as updating a database or sending a notification. - -## Rolling update - -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. -Here is how it works: - -* 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. -* Once the new version is successfully running, we gradually shift all traffic to it, ensuring zero downtime. -* The old version is decommissioned once the new version is fully serving traffic. - -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 - ## Stateless Refers to a system or application that does not maintain any persistent state between executions. In a stateless environment, each request or operation is independent, and no information is retained from previous interactions. diff --git a/pages/serverless-jobs/concepts.mdx b/pages/serverless-jobs/concepts.mdx index ec13da30b5..014c44af59 100644 --- a/pages/serverless-jobs/concepts.mdx +++ b/pages/serverless-jobs/concepts.mdx @@ -68,13 +68,17 @@ It automatically handles infrastructure management, scaling, and load balancing, ## Serverless Functions -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. +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. 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. ## Serverless Jobs +<<<<<<< HEAD:pages/serverless-jobs/concepts.mdx 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. +======= +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. +>>>>>>> b19395d4f (Apply suggestions from code review):serverless/jobs/concepts.mdx ## Secrets reference From 5b8d68f4877b054695324d07aff02c533e386a86 Mon Sep 17 00:00:00 2001 From: Thomas Tacquet Date: Tue, 21 Jan 2025 13:39:03 +0100 Subject: [PATCH 3/6] missing suggestions --- pages/serverless-functions/concepts.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/pages/serverless-functions/concepts.mdx b/pages/serverless-functions/concepts.mdx index 2b354d97af..5f9bda7189 100644 --- a/pages/serverless-functions/concepts.mdx +++ b/pages/serverless-functions/concepts.mdx @@ -166,14 +166,12 @@ It automatically handles infrastructure management, scaling, and load balancing, ## Serverless Functions -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. +Serverless Functions, fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events. 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. ## Serverless Jobs -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. - Serverless Jobs are similar to Serverless Functions 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. ## Stateless From d291fbbfd73017dd66655f341c96ad5a007540a1 Mon Sep 17 00:00:00 2001 From: Thomas Tacquet Date: Tue, 21 Jan 2025 13:39:55 +0100 Subject: [PATCH 4/6] missing suggestions --- pages/serverless-functions/concepts.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/serverless-functions/concepts.mdx b/pages/serverless-functions/concepts.mdx index 5f9bda7189..bd5f52c139 100644 --- a/pages/serverless-functions/concepts.mdx +++ b/pages/serverless-functions/concepts.mdx @@ -166,13 +166,13 @@ It automatically handles infrastructure management, scaling, and load balancing, ## Serverless Functions -Serverless Functions, fully managed compute services that allow you to run small, stateless code snippets or functions in response to HTTP requests or events. +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. 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. ## Serverless Jobs -Serverless Jobs are similar to Serverless Functions 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. +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. ## Stateless From 20e50b97f047cad622adef99194130b9dca765a8 Mon Sep 17 00:00:00 2001 From: Thomas TACQUET Date: Wed, 22 Jan 2025 16:15:59 +0100 Subject: [PATCH 5/6] Apply suggestions from code review Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- pages/serverless-containers/concepts.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/serverless-containers/concepts.mdx b/pages/serverless-containers/concepts.mdx index e3aa2ab328..321004a78c 100644 --- a/pages/serverless-containers/concepts.mdx +++ b/pages/serverless-containers/concepts.mdx @@ -166,11 +166,11 @@ Use cases: 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. Here is how it works: -* 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. +* 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. * Once the new version is successfully running, we gradually shift all traffic to it, ensuring zero downtime. * The old version is decommissioned once the new version is fully serving traffic. -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 +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. ## Sandbox From e3c1a3750d0a93b5d00f71c25ec5f2e9fecefcaf Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 29 Jan 2025 11:02:58 +0100 Subject: [PATCH 6/6] fix(docs): remove rebase fail --- pages/serverless-jobs/concepts.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/pages/serverless-jobs/concepts.mdx b/pages/serverless-jobs/concepts.mdx index 014c44af59..5cdef37512 100644 --- a/pages/serverless-jobs/concepts.mdx +++ b/pages/serverless-jobs/concepts.mdx @@ -74,11 +74,7 @@ These functions automatically scale based on demand and are designed to be light ## Serverless Jobs -<<<<<<< HEAD:pages/serverless-jobs/concepts.mdx 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. -======= -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. ->>>>>>> b19395d4f (Apply suggestions from code review):serverless/jobs/concepts.mdx ## Secrets reference