NavigationContentFooter
Jump toSuggest an edit

Containers - Quickstart

Reviewed on 13 August 2024Published on 26 May 2021

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

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 for more information on Scaleway’s different Serverless products.

This page explains how to deploy a basic NGINX image in a Serverless Container using the Scaleway console.

Before you start

To complete the actions presented below, you must have:

  • A Scaleway account logged into the console
  • Owner status or IAM permissions allowing you to perform actions in the intended Organization

How to deploy a Serverless Container

You can deploy a container from the Scaleway Container Registry or any other public container registry, such as Docker Hub, AWS Container registries, GitLab container registry, etc.

Deploy from the Scaleway Container Registry

If you have no existing Serverless Containers resources in your current Project, the creation process will guide you through the creation of a namespace, and then a container.

Note

Make sure that you have created a Container Registry namespace and pushed the latest NGINX Docker image (or any other image with a web server) to it.

  1. Click Containers in the Serverless section of the side menu. The containers page displays.

  2. Click Deploy container. The containers namespace creation wizard displays.

  3. Complete the following steps in the wizard:

    • Enter a name or use the automatically generated one. The name can only contain lowercase alphanumeric characters and dashes.
    • Enter a description (optional).
    • Choose a region, which is the geographical location in which your namespace will be deployed.
  4. Click Create namespace and add container. The container creation wizard displays.

    Note

    Refer to the How to create, manage and delete a Containers namespace documentation page for more information on the different parameters.

  5. Complete the following steps in the wizard:

    • Select the Scaleway Container Registry.
    • Select the appropriate Registry namespace from the drop-down list, and then select the nginx container and latest tag.
    • Set the port to 80.
    • Enter a name or use the automatically generated one. The name can only contain lowercase alphanumeric characters and dashes.
    • Enter a description (optional).
    • Choose the smallest resources available to allocate to your container.
    • Leave the default scaling values.
    • In the Advanced options, set the Container privacy policy to public.
    • Verify the estimated cost.
    Note

    Refer to How to deploy a Container from the Scaleway Registry for more information on the different parameters.

  6. Click Deploy container to finish.

  7. Copy the container’s endpoint URL from the Overview tab, and paste it in the address bar of your browser.

The web server’s home page displays.

Deploy from an external registry

If you have no existing Serverless Containers resources in your current Project, the creation process will guide you through the creation of a namespace, and then a container.

Important

Scaleway's Container Registry allows for a seamless integration with Serverless Containers and Jobs at a competitive price. Serverless products support external public registries (such as Docker Hub), but we do not recommend using them due to uncontrolled rate limiting, which can lead to failures when starting resources, unexpected usage conditions, and pricing changes.

  1. Click Containers in the Serverless section of the side menu. The containers page displays.

  2. Click Deploy container. The containers namespace creation wizard displays.

  3. Complete the following steps in the wizard:

    • Enter a name or use the automatically generated one. The name can only contain lowercase alphanumeric characters and dashes.
    • Enter a description (optional).
    • Choose a region, which is the geographical location in which your namespace will be deployed.
  4. Click Create namespace and add container. The container creation wizard displays.

    Note

    Refer to the How to create, manage and delete a Containers namespace documentation page for more information on the different parameters.

  5. Complete the following steps in the wizard:

    • Select the External container registry.
    • Enter docker.io/library/nginx:latest in the image URL field.
    • Set the port to 80.
    • Enter a name or use the automatically generated one. The name can only contain lowercase alphanumeric characters and dashes.
    • Enter a description (optional).
    • Choose the smallest resources available to allocate to your container.
    • Leave the default scaling values.
    • In the Advanced options, set the Container privacy policy to public.
    • Verify the estimated cost.
    Note

    Refer to How to deploy a Container from an external container registry for more information on the different parameters.

  6. Click Deploy container. The deployment takes several minutes to complete. Check the Overview tab to see the container’s status.

  7. Copy the container’s endpoint URL from the Overview tab, and paste it in the address bar of your browser.

The web server’s home page displays.

How to delete a container

  1. Click Containers in the Serverless section of the side menu. The containers page displays.
  2. Click the relevant container’s namespace.
  3. Click the «See more Icon» icon next to the container you want to delete, and select Delete from the drop-down menu.
  4. Type DELETE in the pop-up, then click Delete container.

Going further

For advanced usage, such as larger projects with dependencies, automation, multiple containers, and more, there are several ways to deploy containers.

Check out our GitHub repository for real-world examples.

API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2024 – Scaleway