feat(containers): mdbook tutorial

tutorials/deploy-mdbooks-serverless-containers/index.mdx

@@ -0,0 +1,114 @@
+---
+meta:
+  title: Fast deployment of documentation on Serverless Containers with mdbooks
+  description: Step-by-step guide to deploy mdbooks on Scaleway Serverless Containers.
+content:
+  h1: Fast deployment of documentation on Serverless Containers with mdbooks
+  paragraph: Step-by-step guide to deploy mdbooks on Scaleway Serverless Containers.
+tags: docker container deploy serverless
+hero: assets/scaleway-umami.webp
+categories:
+  - containers
+  - container-registry
+dates:
+  validation:
+  posted:
+---
+
+Publish modern online books, for product, API documentation, tutorials, course material or anything that requires a clean, easily navigable and customizable presentation.
+
+This tutorial uses `mdbooks` to publish simple documentation but the main goal of this tutorial is to show how simple it is to
+pick a project, package it inside an image and deploy it on Serverless Containers.
+
+<Macro id="requirements" />
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+- Docker installed on your local machine
+
+## Why deploying on Serverless
+
+Serverless products are perfect for cost efficiency with a pay-as-you-go model and scale very well.
+
+With zero infrastructure management and many tools to integrate in CI/CD environments, `mdbooks` can benefit a lot of Serverless Containers.
+
+## Local setup
+
+1. Follow the [installation instructions](https://rust-lang.github.io/mdBook/guide/installation.html) of mdbooks.
+
+2. Run commands:
+- `mdbook init my-first-book` in order to create a sample book.
+- `cd my-first-book` to open the directory created by init command.
+
+3. *(optional)* Now you can edit the content of the book to publish.
+
+4. It is recommended to test the book using the command: `mdbook test`.
+
+## Prepare Container Registry
+
+<Message type="note">
+  We recommend using Scaleway Container Registry instead of external registries to avoid errors of rate limiting and risks regarding evolutions of CGU and pricing.
+</Message>
+
+1. Create a file named `Dockerfile` in this folder containing the following code:
+
+```dockerfile
+FROM debian:bookworm-slim
+
+WORKDIR /app
+
+# Copy necessary files (add if you have custom files)
+COPY book.toml /app/
+COPY src/* /app/src/
+
+# Install mdbooks binary
+RUN apt-get -y update; apt-get -y install curl;
+RUN mkdir /home/mdbooks
+RUN curl -sSL https://github.com/rust-lang/mdBook/releases/download/v0.4.40/mdbook-v0.4.40-x86_64-unknown-linux-gnu.tar.gz | tar -xz --directory=/home/mdbooks
+ENV PATH="$PATH:/home/mdbooks"
+
+# Serve the book:
+# 0.0.0.0 is required to listen on public interface, otherwise mdbook will only listen for localhost
+# 8080 port is used to match the Serverless Container settings.
+ENTRYPOINT ["mdbook", "serve", "-n", "0.0.0.0", "-p", "8080" ]
+```
+
+2. Open a web browser on your computer and navigate to the [Container Registry](https://console.scaleway.com/containers/) product in the Scaleway Console.
+3. Click **Create namespace**. A namespace is used to hold the image.
+
+<Message type="note">
+  A pop-up will appear with informations to log into your Container Registry Namespace with `docker login`. This will allow to push the image later.
+</Message>
+
+4. Create the namespace and save the registry endpoint. The registry endpoint looks like `rg.<region>.scw.cloud/<namespace>`
+
+<Message type="note">
+  Refer to [How to create a namespace](/docs/containers/container-registry/how-to/create-namespace/) for detailed information about Container Registry namespace creation.
+</Message>
+## Build and push
+
+1. Run the command `docker build -t rg.<region>.scw.cloud/<namespace>/<image_name>:<tag_name> .`
+* **region**: to get this information, check the namespace settings of the namespace you created.
+* **image_name**: use the name you want to identify your image, for example `mdbook`.
+* **tag_name**: use tags to identify the version of your image, for example `v1`.
+
+2. Push the image:
+`docker push rg.<region>.scw.cloud/<namespace>/<image_name>:<tag>`
+
+## Deploy the Serverless Container
+
+1. Create a [Serverless Container Namespace](https://console.scaleway.com/containers/namespaces/create) in the Scaleway console.
+2. Configure the Serverless Containers. **Important points are:**
+* **Image**: Select the Registry namespace, Container and Tag you created before using the dropdown lists.
+* **Name**: You can change the default name to use a more meaningful one.
+
+You can keep default values of other parameters and fine-tune them later at anytime without downtime.
+
+3. Click **Deploy container** button and wait few seconds for the deployment.
+4. Congratulation you Serverless Container is deployed an ready. You can access it via it's **endpoint**.
+
+## Going further
+
+* [Monitor logs and metrics](/serverless/containers/how-to/monitor-container/) of your Container.
+* [Add a custom domain](/serverless/containers/how-to/add-a-custom-domain-to-a-container/) to your Container.
+* Explore [other methods](/serverless/containers/reference-content/deploy-container/) to deploy your Container.