Skip to content

Commit 1569a64

Browse files
thomas-tacquetjcirinosclwySamyOubouaziz
authored
feat(containers): product handbook doc (#5018)
* draft: feat(containers): product doc * add more content * mv * description * review * Apply suggestions from code review Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> * Update pages/serverless-containers/reference-content/serverless-handbook.mdx Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> * small workloads sentence * rename page to serverless overview * add item in menu * Update pages/serverless-containers/reference-content/serverless-overview.mdx Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> * add more links * docs(srv): update * docs(srv): update --------- Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> Co-authored-by: SamyOubouaziz <soubouaziz@scaleway.com>
1 parent c4ae266 commit 1569a64

File tree

4 files changed

+170
-2
lines changed

4 files changed

+170
-2
lines changed

menu/navigation.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4397,6 +4397,10 @@
43974397
},
43984398
{
43994399
"items": [
4400+
{
4401+
"label": "Serverless overview",
4402+
"slug": "serverless-overview"
4403+
},
44004404
{
44014405
"label": "Containers limitations",
44024406
"slug": "containers-limitations"

pages/serverless-containers/concepts.mdx

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ The container can then process the message and perform any required actions, suc
173173

174174
The port of a containerized application refers to the network port that the application inside the container listens on for incoming requests.
175175

176-
Refer to the [dedicated documentation](/serverless-containers/reference-content/port-parameter-variable/) for more information and examples on the **Port** parameter of Serverless Containers.
176+
Refer to the [dedicated documentation](/serverless-containers/reference-content/port-parameter-variable/) for more information and examples on the **Port** parameter of Serverless Containers.
177177

178178
## Privacy policy
179179

@@ -229,6 +229,8 @@ One of the advantages of Serverless Containers is that when your container is no
229229

230230
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.
231231

232+
For more details about Serverless advantages, [read Serverless Overview](/serverless-containers/reference-content/serverless-overview/).
233+
232234
## Serverless
233235

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

pages/serverless-containers/quickstart.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ categories:
1616

1717
Scaleway Serverless Containers provides you with containerized stateless web applications deployed in the cloud. They are designed for short-lived, event-driven tasks.
1818

19+
<Message>
20+
For more details about Serverless advantages, [read Serverless Overview](/serverless-containers/reference-content/serverless-overview/).
21+
</Message>
22+
1923
Containers rely on the HTTP protocol, and must therefore include a web server to work properly. Refer to the [differences between Containers, Jobs, and Functions](/serverless-containers/reference-content/difference-jobs-functions-containers/) for more information on Scaleway's different Serverless products.
2024

2125
This page explains how to deploy a basic NGINX image in a Serverless Container using the Scaleway console.
@@ -118,4 +122,4 @@ If you have no existing Serverless Containers resources in your current Project,
118122

119123
For advanced usage, such as larger projects with dependencies, automation, multiple containers, and more, there are [several ways to deploy containers](/serverless-containers/reference-content/deploy-container/).
120124

121-
Check out our [GitHub repository](https://github.com/scaleway/serverless-examples) for real-world examples.
125+
Check out our [GitHub repository](https://github.com/scaleway/serverless-examples) for real-world examples.
Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
---
2+
meta:
3+
title: Serverless overview
4+
description: Understand the concepts and benefits of Serverless computing on Scaleway.
5+
content:
6+
h1: Serverless overview
7+
paragraph: Understand the concepts and benefits of Serverless computing on Scaleway.
8+
tags: containers serverless
9+
dates:
10+
validation: 2025-05-23
11+
posted: 2025-05-23
12+
categories:
13+
- serverless
14+
- containers
15+
---
16+
17+
## What is serverless compute?
18+
19+
Serverless computing is a cloud computing model where the cloud providers manage the infrastructure and dynamically allocate computing resources as needed.
20+
21+
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.
22+
23+
This approach enables greater scalability, flexibility, and cost-effectiveness.
24+
25+
Key features:
26+
* **Automatic scaling:** Your application can scale up or down automatically based on demand
27+
* **No server management:** No need to provision, maintain, or manage servers
28+
* **Pay as you go:** Only pay for the computing time you consume, making it cost-effective
29+
30+
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.
31+
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.
32+
33+
## Why Serverless?
34+
35+
Serverless offers numerous advantages that can significantly enhance your development and operational efficiency:
36+
37+
* **Cost savings:** You only pay for the compute time your code uses, which can lead to significant cost reductions. No idle resources
38+
* **Scalability:** Automatically scale your applications to handle varying loads without manual intervention. It is perfect for seasonal traffic and viral apps
39+
* **Faster time to market:** Focus on writing code rather than managing infrastructure, accelerating your development cycles
40+
* **Reduced operational overhead:** Let the cloud provider handle server maintenance, updates, and scaling, freeing up your team to focus on innovation
41+
* **Eco-friendly:** Optimized resource usage reduces wasted energy
42+
* **Focus on apps:** you can put all your energy into the application value instead of managing infrastructures
43+
44+
## How to control the costs of Serverless?
45+
46+
Serverless is inherently cost-transparent. Here are some tips to optimize costs:
47+
* **Cost estimator:** When deploying Serverless resources via Scaleway Console, you can try different parameters to evaluate costs
48+
* **Best practices** Use efficient code with optimized libraries, ensuring a small resource footprint
49+
* **Monitoring** Monitor usage with built-in observability and use Cost Manager: [How to use cost manager documentation](/billing/how-to/use-the-cost-manager/)
50+
* **Parameters** Define a max-scale setting according to traffic spikes
51+
52+
Remember: Serverless eliminates upfront capital expenses and reduces operational costs giving you predictable, granular billing.
53+
54+
## Ready to go Serverless?
55+
56+
By adopting Serverless, you are choosing agility, innovation, and cost savings.
57+
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.
58+
59+
You can fully deploy your API on Serverless or use it to empower and add automation to your infrastructure.
60+
Serverless is excellent at handling traffic spikes, which is useful for offloading regular servers during special events.
61+
62+
## Is my application a good fit for serverless?
63+
64+
Most applications can benefit from serverless. Check some use cases:
65+
66+
* **Event-driven workloads:** file processing, real-time notification, IoT data streams
67+
* **Microservices and APIs:** Stateless, short-lived tasks (e.g., user authentication, payment processing, etc.)
68+
* **Sporadic traffic:** Apps with variable usage (e.g., marketing campaigns, ticketing system).
69+
* **Rapid prototyping:** Test ideas quickly without upfront infrastructure investment
70+
71+
## How secure are Serverless resources?
72+
73+
Scaleway prioritizes strong security and isolation for Serverless products.
74+
75+
* **Secured isolation layers:** Each container runs in a secure, isolated environment. Our systems provide a VM-like security while maintaining container-like performance
76+
77+
## How do I debug and monitor applications in a Serverless environment?
78+
79+
Scaleway provides full observability:
80+
81+
* **Logs and metrics:** Centralized logging and real-time metrics via Cockpit
82+
* **Local debugging:** Test containers locally using the Serverless CLI and emulator
83+
* **Error Reporting:** Automatic alerts for failed invocations or resource bottlenecks via Cockpit. See [how to configure alerts for Serverless Containers](/serverless-containers/how-to/configure-alerts-containers/)
84+
85+
As our Serverless environment does not encourage vendor-locking, you can easily debug your container locally.
86+
87+
## Will Serverless lock me into the ecosystem?
88+
89+
No. Scaleway Serverless is designed to minimize vendor lock-in.
90+
We believe in empowering your freedom to choose, adapt, and evolve. Here is how we ensure flexibility:
91+
92+
### Container portability
93+
- **Docker compatibility**: Your container images (built with Docker, Helm, or other tools) are portable. You can redeploy them elsewhere—on-premises, on other clouds, or in hybrid environments.
94+
- **No proprietary formats**: We do not modify your containers. What you build works anywhere.
95+
96+
### No proprietary lock-in
97+
- **No forced dependencies**: Some providers require customers to import specific libraries to work properly. We do not.
98+
- **Open APIs**: Manage Serverless Containers via REST APIs, Terraform, CLI, and more with no proprietary control required.
99+
100+
## How to migrate to a Serverless ecosystem?
101+
102+
Serverless products at Scaleway allow you to gradually migrate to Serverless, offering different strategies:
103+
104+
### Start small
105+
106+
* **Small workloads:** Migrate non-critical workloads first, like parts of APIs, automation, and scheduled tasks
107+
* **Proof of concept:** Use our tutorial and check our [scaleway/serverless-examples repository](https://github.com/scaleway/serverless-examples) for inspiration
108+
109+
### Hybrid architecture
110+
111+
* **Coexistence:** Run serverless endpoints alongside VMs, clusters, and traditional apps
112+
113+
### Incremental refactoring
114+
115+
* **Break monoliths:** Convert microservices or stateless components to Serverless first
116+
117+
## What specific knowledge is required to deploy Serverless projects?
118+
119+
Serverless is designed to eliminate infrastructure complexity, so teams can focus on innovation:
120+
121+
### No infrastructure expertise needed
122+
123+
* **Managed services:** Scaleway handles networking, scaling, patching, and availability
124+
* **Simplified operations:** No need for DevOps engineers to manage clusters or servers
125+
126+
### Developer-centric workflow
127+
128+
* **Familiar tools:** Use Git, Docker, CI/CD pipelines, and IDEs you already know
129+
* **Language flexibility:** Support for Python, Node.js, Rust, Go, PHP, and custom runtimes via Serverless Containers
130+
131+
### Learn Serverless basics
132+
133+
* **Minimal learning curve:** Teams only need to understand event-driven architecture, container basics, and Scaleway’s serverless console/CLI
134+
* **Training resources:** Free tutorials, examples, and free-tier to experiment
135+
136+
## Is Serverless a good choice for a growing business?
137+
138+
Absolutely. Serverless is ideal for startups and scaling businesses due to its cost efficiency, elasticity, and operational simplicity:
139+
140+
### Auto-Scaling for traffic spikes
141+
142+
* **Zero manual intervention:** Automatically scale from zero to millions of requests during flash sales, marketing campaigns, or viral events
143+
* **Example:** An e-commerce app handles black friday traffic seamlessly without provisioning extra resources
144+
145+
### Pay-as-you-go cost model
146+
147+
* **No idle costs:* Growing businesses avoid overspending on underutilized infrastructure
148+
* **Predictable budgeting:** Use cost estimator to forecast costs based on expected usage
149+
150+
### Focus on core innovation
151+
152+
* **Reduce operational overhead:** Teams avoid spending time on server management, freeing resources for product development
153+
* **Faster iteration:** Deploy updates in minutes without downtime
154+
155+
### Enterprise-Ready as you scale
156+
157+
* **SLAs and security:** Check our [SLA page](https://www.scaleway.com/en/terms/sla/)
158+
* **Hybrid flexibility:** Seamlessly integrate with other Scaleway services (e.g., databases, messaging, AI/ML) to support complex workflows

0 commit comments

Comments
 (0)