docs(srv): add migration guide for serverless containers MTA-6412

Author: SamyOubouaziz

pages/serverless-containers/reference-content/migrate-to-serverless-containers.mdx

@@ -0,0 +1,86 @@
+---
+title: How to migrate your workloads to Scaleway Serverless Containers
+description: This page gives recommendations and steps to migrate your workloads from Kubernetes or conventional virtual machines to Scaleway Serverless Containers
+tags: migration switch change adopt serverless containers go serverless try k8s vm
+dates:
+  validation: 2025-08-25
+  posted: 2025-08-25
+---
+
+This guide is designed for developers and operators who are currently running workloads on Kubernetes or traditional virtual machines and are considering a migration to [Serverless Containers](/serverless-containers/concepts/#serverless-containers). This guide covers the [core concepts](#why-migrating-to-serverless-containers) of Serverless Containers, the [operational benefits](#key-features) of this model, and a [practical path](#quick-deployment-guide) for migration.
+
+## Why migrating to Serverless Containers
+
+Moving to a Serverless Containers model involves a shift in operational responsibility from you to the cloud provider. This change brings several key advantages for development teams.
+
+- **Reduced operational overhead**: The primary benefit is the abstraction of the underlying infrastructure. You do not need to provision, manage, scale, or patch servers, operating systems, or container orchestration platforms like Kubernetes. This allows your team to focus on application logic rather than infrastructure management.
+
+- **Container-based workflow**: You can continue to use the standard container-based development workflow. Packaging your application and its dependencies into a container image ensures a consistent and reproducible environment, from local development to production.
+
+- **Stateless architecture**: Serverless Containers are designed for stateless services. This architectural pattern promotes building applications that are horizontally scalable and resilient, as any instance can handle any request without relying on local state.
+
+- **Efficient resource consumption**: The platform automatically scales the number of running container instances based on request volume, CPU consumption or RAM usage. This removes the need to manually configure and tune autoscaling rules, ensuring your application has the resources it needs to meet demand. For services with variable or infrequent traffic, this model is highly efficient, as resources can scale down to zero when there are no requests, eliminating the cost of idle capacity.
+
+Refer to our [dedicated overview page](/serverless-containers/reference-content/serverless-overview/) for general information on Scaleway's Serverless products.
+
+## Key features
+
+Serverless Containers come packed with features designed for modern application development:
+
+Private Network compatibility: Securely connect your services to other resources within your private cloud network. Read more about private networks integration (https://www.scaleway.com/en/docs/serverless-containers/reference-content/containers-private-networks/)
+
+Custom domains: Easily map your own domain names to your services. Check on how to add custom domains to Serverless Containers (https://www.scaleway.com/en/docs/serverless-containers/how-to/add-a-custom-domain-to-a-container/)
+
+Healthchecks: Configure readiness and liveness probes to ensure your application instances are healthy and ready to serve traffic. Get more info about healtchecks (https://www.scaleway.com/en/docs/serverless-containers/concepts/#health-check)
+
+Built-in monitoring: Gain immediate insights into your application's performance with integrated logging and metrics, without needing to set up complex monitoring agents. Check how to monitor your Serverless Container (https://www.scaleway.com/en/docs/serverless-containers/how-to/monitor-container/)
+
+Enhanced security: Because the platform is managed by the cloud provider, it benefits from continuous security patching and best practices, reducing your operational security burden. Check how to secure a Serverless Container (https://www.scaleway.com/en/docs/serverless-containers/how-to/secure-a-container/)
+
+For additional features related to Serverless Containers, check for all Concepts (https://www.scaleway.com/en/docs/serverless-containers/concepts/)
+
+## Quick deployment guide
+
+Deploying your first service to Serverless Containers is straightforward. Here’s a high-level overview of the steps:
+
+Containerize your Application: If you haven't already, package your application into a container image using a Dockerfile. Read Container Registry quickstart(https://www.scaleway.com/en/docs/container-registry/quickstart/)
+
+Push to a Registry: Push your container image to Scaleway Container Registry.
+
+Deploy a container: Read How to deploy a Container](https://www.scaleway.com/en/docs/serverless-containers/how-to/deploy-container/)
+
+Deploy: Click "Deploy" and the platform will pull your container image and run it. Within minutes, you'll have a publicly accessible HTTPS endpoint for your new service.
+
+Best practices for migration
+
+Migrating existing applications from Kubernetes or Instances to Serverless Containers is an opportunity to modernize your architecture.
+
+General best practices
+
+Containerize everything: Your application must be packaged as a container image. This is the fundamental deployment unit for Serverless Containers
+
+Embrace statelessness: Since Serverless Containers are stateless, you cannot rely on the local filesystem for storing data that needs to persist between requests
+
+Use external storage: For file storage, use an object storage service like Scaleway Object Storage (https://www.scaleway.com/en/docs/object-storage/quickstart/)
+
+Externalize state: For application state, use a managed database, cache like Redis(https://www.scaleway.com/en/docs/managed-databases-for-redis/how-to/create-a-database-for-redis/) or a message queues(https://www.scaleway.com/en/docs/queues/quickstart/)
+
+Manage your infrastructure as code: While you can manage your services through the console, we highly recommend using developer tools for a repeatable and version-controlled setup.
+
+CLI: Use the command-line interface provided by your cloud provider for scripting and automation. Read more(https://www.scaleway.com/en/docs/scaleway-cli/quickstart/)
+
+Terraform/IaC: Define your Serverless Containers services using tools like Terraform for a fully automated and declarative infrastructure. Read more (https://www.scaleway.com/en/docs/terraform/quickstart/)
+
+Migration Strategies
+
+Progressive migration: You don't need to migrate your entire application at once. Serverless Containers are perfect for microservices. You can start by migrating a single, smaller service to get a feel for the platform. This approach minimizes risk and allows your team to learn as you go.
+
+API Migration: When migrating an API, you can create a new version of your API on Serverless Containers. For example, you can create a new /v2/ endpoint for your API that is served by Serverless Containers, while the existing /v1/ remains on your current infrastructure. This allows for a gradual rollout to your users.
+
+Start small with Serverless Jobs
+
+If you're looking for an even simpler way to start your Serverless journey, consider using Serverless Jobs. This is a companion product designed for running batch jobs, scripts, or automated tasks that run to completion.
+
+Instead of migrating a full web service, you can start by offloading a small automation task (like a nightly data processing script) to a Serverless Job. This is a low-risk way to familiarize your team with the serverless container ecosystem before committing to migrating larger, more critical services.
+
+Quickstart of Serverless Jobs product (https://www.scaleway.com/en/docs/serverless-jobs/quickstart/)