Skip to content

Commit 5a3ebf4

Browse files
committed
docs(srv): update
1 parent 985f5c1 commit 5a3ebf4

File tree

7 files changed

+172
-87
lines changed

7 files changed

+172
-87
lines changed

menu/navigation.json

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3888,8 +3888,24 @@
38883888
{
38893889
"items": [
38903890
{
3891-
"label": "Common errors",
3892-
"slug": "common-errors"
3891+
"label": "I cannot create a namespace",
3892+
"slug": "cannot-create-namespace"
3893+
},
3894+
{
3895+
"label": "I cannot deploy my image",
3896+
"slug": "cannot-deploy-image"
3897+
},
3898+
{
3899+
"label": "I cannot inject secrets or variables in my job",
3900+
"slug": "cannot-inject-secret-variable"
3901+
},
3902+
{
3903+
"label": "I cannot retrieve external images",
3904+
"slug": "cannot-retrieve-external-images"
3905+
},
3906+
{
3907+
"label": "My container stopped working after a redeploy",
3908+
"slug": "container-stopped-after-redeploy"
38933909
}
38943910
],
38953911
"label": "Troubleshooting",
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
meta:
3+
title: I am unable to create a Serverless Containers namespace
4+
description: Troubleshoot problems encountered while creating namespaces for Scaleway Serverless Containers.
5+
content:
6+
h1: My function fails after trying too many times
7+
paragraph: Troubleshoot problems encountered while creating namespaces for Scaleway Serverless Containers.
8+
tags: serverless Containers troubleshooting issue error namespace creation unable
9+
dates:
10+
validation: 2024-11-06
11+
posted: 2024-11-06
12+
categories:
13+
- serverless
14+
---
15+
16+
## Problem
17+
18+
I cannot create a Serverless Containers namespace.
19+
20+
### Cause
21+
22+
This issue can happen for the following reasons:
23+
24+
- You created too many namespaces and reached [your account's quota](/identity-and-access-management/organizations-and-projects/additional-content/organization-quotas/#serverless-containers).
25+
26+
- You created too many Registry namespaces and reached [your account's quota](/identity-and-access-management/organizations-and-projects/additional-content/organization-quotas/#container-registry).
27+
28+
### Possible solutions
29+
30+
Make sure that you did not exceed the maximum number of allowed namespaces with the [Scaleway console](https://console.scaleway.com/) or with the [API](https://www.scaleway.com/en/developers/api/serverless-containers/#path-namespaces-list-all-your-namespaces).
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
meta:
3+
title: I am unable to deploy my image
4+
description: Troubleshoot errors encountered while deploying images with Scaleway Serverless Containers.
5+
content:
6+
h1: I am unable to deploy my image
7+
paragraph: Troubleshoot errors encountered while deploying images with Scaleway Serverless Containers.
8+
tags: serverless containers troubleshooting issue error message deploy image failed
9+
dates:
10+
validation: 2024-11-07
11+
posted: 2024-11-07
12+
categories:
13+
- serveless
14+
---
15+
16+
## Problem
17+
18+
I am unable to deploy my image using Serverless Containers.
19+
20+
## Possible solutions
21+
22+
- Make sure the container is listening on the specified PORT for HTTP requests (or use variable `$PORT`).
23+
24+
- Make sure the container is bound to `0.0.0.0`.
25+
26+
- Containers cannot start due to insufficient provisioned resources. Update your container's resources by provisioning more memory and more vCPU.
27+
28+
- Make sure you built your image for an `amd64` architecture, as `arm64` is not supported. See [Architecture](/serverless/containers/reference-content/containers-limitations/#Architecture) documentation.
29+
30+
- Make sure your deployment does not exceed the limitations of [Serverless Containers](/serverless/containers/reference-content/containers-limitations/).
31+
32+
<Message type="tip">
33+
Run the [`docker inspect`](https://docs.docker.com/engine/reference/commandline/inspect/) command to get detailed information on your image:
34+
```
35+
docker inspect myimage
36+
```
37+
</Message>
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
meta:
3+
title: My secrets and variables are not injected properly in my container
4+
description: Troubleshoot issues with secrets and environment variables while using Scaleway Serverless Containers.
5+
content:
6+
h1: My secrets and variables are not injected properly in my container
7+
paragraph: Troubleshoot issues with secrets and environment variables while using Scaleway Serverless Containers.
8+
tags: serverless containers troubleshooting issue error image env var environment variables secrets secret manager
9+
dates:
10+
validation: 2024-11-06
11+
posted: 2024-11-06
12+
categories:
13+
- serverless
14+
---
15+
16+
## Problem
17+
18+
My environment variables and secrets are not properly injected in my Serverless Container.
19+
20+
## Cause
21+
22+
Environment variables or secrets that are too large, contain carriage returns and spread over several lines, as shown below, will not be injected properly.
23+
24+
```
25+
"hello
26+
world
27+
.
28+
"
29+
```
30+
31+
### Solution
32+
33+
To avoid issues while injecting environment variables and secrets, we recommend encoding them to `base64`.
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
meta:
3+
title: I am unable to retrieve an external image for my container
4+
description: Troubleshoot errors while retrieving external images while using Scaleway Serverless Containers.
5+
content:
6+
h1: I am unable to retrieve an external image for my container
7+
paragraph: Troubleshoot errors while retrieving external images while using Scaleway Serverless Containers.
8+
tags: serverless containers troubleshooting issue error image retrieve external public registry
9+
dates:
10+
validation: 2024-11-06
11+
posted: 2024-11-06
12+
categories:
13+
- serverless
14+
---
15+
16+
## Problem
17+
18+
I am experiencing issues when retrieving an image stored in an external container registry.
19+
20+
## Cause
21+
22+
Serverless products support external public registries (such as [Docker Hub](https://hub.docker.com/)), 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.
23+
24+
## Solution
25+
26+
We recommend using the [Scaleway Container Registry](/containers/container-registry/) instead, as it allows for a seamless integration with Serverless Containers and Containers at a [competitive price](/faq/containerregistry/#how-am-i-billed-for-scaleway-container-registry).
27+
28+
Refer to the [dedicated documentation](/serverless/containers/api-cli/migrate-external-image-to-scaleway-registry/) for more information on how to migrate images to the Scaleway Container Registry.

serverless/containers/troubleshooting/common-errors.mdx

Lines changed: 0 additions & 85 deletions
This file was deleted.
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
meta:
3+
title: My container stopped working after a redeploy
4+
description: Troubleshoot issues with Scaleway Serverless Containers not working properly following a redeploy.
5+
content:
6+
h1: My container stopped working after a redeploy
7+
paragraph: Troubleshoot issues with Scaleway Serverless Containers not working properly following a redeploy.
8+
tags: serverless containers troubleshooting issue error state failed fail redeploy
9+
dates:
10+
validation: 2024-11-06
11+
posted: 2024-11-06
12+
categories:
13+
- serverless
14+
---
15+
16+
## Problem
17+
18+
My Serverless Container stopped working (up to several hours) after a redeploy.
19+
20+
## Cause
21+
22+
The new deploy failed, and the [fallback mechanism has been triggered](/serverless/containers/reference-content/containers-limitations/#versioning-and-rollback).
23+
24+
## Possible solution
25+
26+
Identify the element that caused the deployment to fail, fix the error, and deploy the container again.

0 commit comments

Comments
 (0)