Skip to content

Commit 0a0876e

Browse files
docs(serverless): add Versioning and rollback section (#3803)
* docs(serverless): add section Versioning and rollback in function and container limitations * fix: review changes * docs(SRV): update --------- Co-authored-by: SamyOubouaziz <[email protected]>
1 parent 72b657e commit 0a0876e

File tree

4 files changed

+55
-1
lines changed

4 files changed

+55
-1
lines changed

serverless/containers/reference-content/containers-limitations.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,3 +86,20 @@ For example, if you build an image using an ARM CPU, such as Apple Silicon M ser
8686
You must ensure that you build your image to target `amd64` architecture, to acheive this there are multiple solutions:
8787
* You can use the following Docker command: `docker buildx build --platform linux/amd64 .`, or
8888
* You can use an Instance with `amd64` architecture to run your builds.
89+
90+
## Versioning and rollback
91+
92+
Scaleway Containers do not currently support versioning or automatic rollback mechanisms.
93+
However, in the event of a failed deployment, the previously deployed version of the container will continue to handle
94+
incoming requests for up to 24 hours. After this period, the container in error will be deleted, and requests will no
95+
longer be served until a successful deployment is made. This ensures temporary service continuity, but it is important
96+
to monitor and resolve deployment issues promptly, as the fallback is not intended to provide long-term version control
97+
or rollback capabilities.
98+
99+
Below is an example than illustrates this behavior:
100+
101+
* Time +0H: The first container is deployed and works correctly.
102+
* Time +1H: The container is redeployed, but the deployment fails, and the container ends up in an error state.
103+
* Time +2H: Despite the failed deployment, the first container is still handling incoming requests.
104+
* Time +25H: The 24-hour window expires, and both the first working container and the failed container are removed,
105+
leading to service disruption until a new successful deployment is made.

serverless/containers/troubleshooting/common-errors.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,3 +46,13 @@ This issue can happen for the following reasons:
4646
### Possible solutions
4747

4848
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).
49+
50+
## Container stopped working several hours after a redeploy
51+
52+
### Cause
53+
54+
The new deploy failed, and the [fallback mechanism has been triggered](/serverless/containers/reference-content/containers-limitations/#versioning-and-rollback).
55+
56+
### Possible solution
57+
58+
Identify the element that caused the deployment to fail, fix the error, and deploy the container again.

serverless/functions/reference-content/functions-limitations.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,3 +55,20 @@ To ensure the proper functioning of the product, we restrict the use of certain
5555
* **465**: Due to potential abuse (spam), no outbound traffic is allowed through this port, except from Scaleway Transactional Email SMTP servers.
5656
* Reserved environment variables:
5757
* `SCW_*`: Reserved for product configuration (for example: token validation).
58+
59+
## Versioning and rollback
60+
61+
Scaleway Functions do not currently support versioning or automatic rollback mechanisms.
62+
However, in the event of a failed deployment, the previously deployed version of the function will continue to handle
63+
incoming requests for up to 24 hours. After this period, the function in error will be deleted, and requests will no
64+
longer be served until a successful deployment is made. This ensures temporary service continuity, but it is important
65+
to monitor and resolve deployment issues promptly, as the fallback is not intended to provide long-term version control
66+
or rollback capabilities.
67+
68+
Below is an example than illustrates this behavior:
69+
70+
* Time +0H: The first function is deployed and works correctly.
71+
* Time +1H: The function is redeployed, but the deployment fails, and the function ends up in an error state.
72+
* Time +2H: Despite the failed deployment, the first function is still handling incoming requests.
73+
* Time +25H: The 24-hour window expires, and both the first working function and the failed function are removed,
74+
leading to service disruption until a new successful deployment is made.

serverless/functions/troubleshooting/common-errors.mdx

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,4 +97,14 @@ This issue can happen for the following reasons:
9797

9898
### Possible solutions
9999

100-
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-functions/#path-namespaces-list-all-your-namespaces).
100+
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-functions/#path-namespaces-list-all-your-namespaces).
101+
102+
## Function stopped working several hours after a redeploy
103+
104+
### Cause
105+
106+
The new deploy failed, and the [fallback mechanism has been triggered](/serverless/functions/reference-content/functions-limitations/#versioning-and-rollback).
107+
108+
### Possible solution
109+
110+
Identify the element that caused the deployment to fail, fix the error, and deploy the function again.

0 commit comments

Comments
 (0)