Skip to content

Latest commit

 

History

History
116 lines (107 loc) · 8.16 KB

manage-a-container.mdx

File metadata and controls

116 lines (107 loc) · 8.16 KB
meta content tags dates categories
title description
How to manage a container
Manage your Scaleway Serverless Containers effectively.
h1 paragraph
How to manage a container
Manage your Scaleway Serverless Containers effectively.
manage container
validation posted
2025-02-24
2021-05-26
serverless
containers

This page shows you how to manage a container, in order to verify or edit its deployment parameters after creation. 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.

How to manage a container deployment

Manage a deployment from the Scaleway Container Registry

  1. Click Containers in the Serverless section of the side menu. The Containers page displays.
  2. Click the relevant containers namespace.
  3. Click the name of the container you want to manage, then select the Settings tab.
  4. In the Container image section:
    • Select the Scaleway Container Registry.
    • Choose an image from your Container Registry. Select the required Container Registry namespace from the drop-down list, and then select the container and tag.
    • Choose the port your container is listening on. We recommend configuring your container to listen on the PORT environment variable.
  5. In the Resources section, select the vCPU and memory to allocate to your container at runtime. These values define the performance characteristics of your container.
  6. Set your autoscaling preferences, or leave them at default values. The Scaleway platform automatically scales the number of available instances of your container to match the incoming load, depending on the settings you define here.
  7. In the Advanced options section, check or edit any of the following:
    • Declare environment variables you want to inject into your container. For each environment variable, click +Add variable and enter the key/value pair.
    • Declare secrets for your container. Secrets are environment variables that are injected into your container, but the values are not retained or displayed by Scaleway after initial validation. Encode your environment variables and secrets to base64 if they are too large, and contain carriage returns.
    - Set the desired [privacy policy](/serverless-containers/concepts/#privacy-policy) for your container. This defines whether container invocation may be done anonymously (**public**) or only via an authentication mechanism provided by the [Scaleway API](https://www.scaleway.com/en/developers/api/serverless-containers/#authentication) (**private**). - Tick the box under **HTTPS connections only** to prevent your container from being called from insecure HTTP connections. - Set a custom [timeout](/serverless-containers/concepts/#request-timeout) for the duration of the requests received by your container. - Tick the box under [HTTP protocol](/serverless-containers/concepts/#protocol) to listen to HTTP/2 requests if it is required by your application. Otherwise, we recommend you use HTTP/1. - Select a [sandbox](/serverless-containers/concepts/#sandbox) version: - Sandbox v2 for shorter cold starts (recommended). - Sandbox v1 if you require full compatibility with the Linux system call interface (legacy). - Update the [health check](/serverless-containers/concepts/#health-check) behavior according to your needs: - **Probe type**: TCP, or HTTP - **Health checks intervals**: 5s - 120s (default: 30s) - **Failure threshold**: 3 - 50 (default: 10) - Modify the [ephemeral storage](/serverless-containers/concepts/#ephemeral-storage) according to your needs.
  8. Click Deploy container to save any changes you have made.

Manage a deployment from an external container registry

  1. Click Containers in the Serverless section of the side menu. The Containers page displays.
  2. Click the relevant containers namespace.
  3. Click the name of the container you want to manage, then select the Settings tab.
  4. In the Container image section:
    • Select the External container registry.
    • Enter the public container image URL provided by the external registry.
    • Choose the port your container is listening on. We recommend configuring your container to listen on the PORT environment variable.
  5. In the Resources section, select the vCPU and memory to allocate to your container at runtime. These values define the performance characteristics of your container.
  6. Set your autoscaling preferences, or leave them at default values. The Scaleway platform automatically scales the number of available instances of your container to match the incoming load, depending on the settings you define here.
  7. In the Advanced options section, check or edit any of the following:
    • Declare environment variables you want to inject into your container. For each environment variable, click +Add variable and enter the key/value pair.
    • Declare secrets for your container. Secrets are environment variables that are injected into your container, but the values are not retained or displayed by Scaleway after initial validation. Encode your environment variables and secrets to base64 if they are too large, and contain carriage returns.
    - Set the desired [privacy policy](/serverless-containers/concepts/#privacy-policy) for your container. This defines whether container invocation may be done anonymously (**public**) or only via an authentication mechanism provided by the [Scaleway API](https://www.scaleway.com/en/developers/api/serverless-containers/#authentication) (**private**). - Tick the box under **HTTPS connections only** to prevent your container from being called from insecure HTTP connections. - Set a custom [timeout](/serverless-containers/concepts/#request-timeout) for the duration of the requests received by your container. - Tick the box under [HTTP protocol](/serverless-containers/concepts/#protocol) to listen to HTTP/2 requests if it is required by your application. Otherwise, we recommend you use HTTP/1. - Select a [sandbox](/serverless-containers/concepts/#sandbox) version: - Sandbox v2 for shorter cold starts (recommended). - Sandbox v1 if you require full compatibility with the Linux system call interface (legacy). - Update the [health check](/serverless-containers/concepts/#health-check) behavior according to your needs: - **Probe type**: TCP, or HTTP - **Health checks intervals**: 5s - 120s (default: 30s) - **Failure threshold**: 3 - 50 (default: 10) - Modify the [ephemeral storage](/serverless-containers/concepts/#ephemeral-storage) according to your needs.
  8. Click Deploy container to save any changes you have made.