From b233af4a0c53fbc4cb4a7e118ef055b8c2678835 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Thu, 24 Aug 2023 16:12:40 +0200 Subject: [PATCH 01/10] docs(SRV): add containers troubleshootming MTA-3603 --- menu/navigation.json | 14 ++++++++++++-- .../containers/troubleshooting/common-errors.mdx | 16 ++++++++++++++++ serverless/containers/troubleshooting/index.mdx | 8 ++++++++ 3 files changed, 36 insertions(+), 2 deletions(-) create mode 100644 serverless/containers/troubleshooting/common-errors.mdx create mode 100644 serverless/containers/troubleshooting/index.mdx diff --git a/menu/navigation.json b/menu/navigation.json index cc87636273..8dad6315ee 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -965,7 +965,7 @@ "slug": "common-errors" } ], - "label": "Troubleshoooting", + "label": "Troubleshooting", "slug": "troubleshooting" }, { @@ -1078,6 +1078,16 @@ "label": "How to", "slug": "how-to" }, + { + "items": [ + { + "label": "Common errors", + "slug": "common-errors" + } + ], + "label": "Troubleshooting", + "slug": "troubleshooting" + }, { "items": [ { @@ -2418,7 +2428,7 @@ "slug": "avoid-email-rejection-null-mx" } ], - "label": "Troubleshoooting", + "label": "Troubleshooting", "slug": "troubleshooting" } ], diff --git a/serverless/containers/troubleshooting/common-errors.mdx b/serverless/containers/troubleshooting/common-errors.mdx new file mode 100644 index 0000000000..bd21c9a9bc --- /dev/null +++ b/serverless/containers/troubleshooting/common-errors.mdx @@ -0,0 +1,16 @@ +--- +meta: + title: Common errors encountered while using Serverless Containers + description: This page suggests solutions to solve common issues with error messages while using Serverless Containers +content: + h1: Common errors encountered while using Serverless Containers + paragraph: This page suggests solutions to solve common issues with error messages while using Serverless Containers +content: +tags: serverless containers troubleshooting issue error message +dates: + validation: 2023-08-24 + posted: 2023-08-24 +categories: + - serveless +--- + diff --git a/serverless/containers/troubleshooting/index.mdx b/serverless/containers/troubleshooting/index.mdx new file mode 100644 index 0000000000..5ef15f6406 --- /dev/null +++ b/serverless/containers/troubleshooting/index.mdx @@ -0,0 +1,8 @@ +--- +meta: + title: Serverless Containers - Troubleshooting Documentation + description: Serverless Containers Troubleshooting Documentation +content: + h1: Serverless Containers Troubleshooting Documentation + paragraph: Serverless Containers Troubleshooting Documentation +--- \ No newline at end of file From d1e98c34fa44e2e869dca8361ab6a600e5aacc44 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Thu, 24 Aug 2023 16:12:40 +0200 Subject: [PATCH 02/10] docs(SRV): add containers troubleshootming MTA-3603 --- menu/navigation.json | 10 ++++++++++ .../containers/troubleshooting/common-errors.mdx | 16 ++++++++++++++++ serverless/containers/troubleshooting/index.mdx | 8 ++++++++ 3 files changed, 34 insertions(+) create mode 100644 serverless/containers/troubleshooting/common-errors.mdx create mode 100644 serverless/containers/troubleshooting/index.mdx diff --git a/menu/navigation.json b/menu/navigation.json index c096d8458e..8dad6315ee 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1078,6 +1078,16 @@ "label": "How to", "slug": "how-to" }, + { + "items": [ + { + "label": "Common errors", + "slug": "common-errors" + } + ], + "label": "Troubleshooting", + "slug": "troubleshooting" + }, { "items": [ { diff --git a/serverless/containers/troubleshooting/common-errors.mdx b/serverless/containers/troubleshooting/common-errors.mdx new file mode 100644 index 0000000000..bd21c9a9bc --- /dev/null +++ b/serverless/containers/troubleshooting/common-errors.mdx @@ -0,0 +1,16 @@ +--- +meta: + title: Common errors encountered while using Serverless Containers + description: This page suggests solutions to solve common issues with error messages while using Serverless Containers +content: + h1: Common errors encountered while using Serverless Containers + paragraph: This page suggests solutions to solve common issues with error messages while using Serverless Containers +content: +tags: serverless containers troubleshooting issue error message +dates: + validation: 2023-08-24 + posted: 2023-08-24 +categories: + - serveless +--- + diff --git a/serverless/containers/troubleshooting/index.mdx b/serverless/containers/troubleshooting/index.mdx new file mode 100644 index 0000000000..5ef15f6406 --- /dev/null +++ b/serverless/containers/troubleshooting/index.mdx @@ -0,0 +1,8 @@ +--- +meta: + title: Serverless Containers - Troubleshooting Documentation + description: Serverless Containers Troubleshooting Documentation +content: + h1: Serverless Containers Troubleshooting Documentation + paragraph: Serverless Containers Troubleshooting Documentation +--- \ No newline at end of file From 4f4dd37313066cbe475d3af9710fc660a7f9c8fc Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Thu, 24 Aug 2023 17:12:05 +0200 Subject: [PATCH 03/10] docs(SRV): remove duplicate content --- serverless/containers/troubleshooting/common-errors.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/serverless/containers/troubleshooting/common-errors.mdx b/serverless/containers/troubleshooting/common-errors.mdx index bd21c9a9bc..85d3d7149b 100644 --- a/serverless/containers/troubleshooting/common-errors.mdx +++ b/serverless/containers/troubleshooting/common-errors.mdx @@ -5,7 +5,6 @@ meta: content: h1: Common errors encountered while using Serverless Containers paragraph: This page suggests solutions to solve common issues with error messages while using Serverless Containers -content: tags: serverless containers troubleshooting issue error message dates: validation: 2023-08-24 From 40dd3126ac42fe441d33af1b96a0656778771649 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Fri, 25 Aug 2023 16:01:08 +0200 Subject: [PATCH 04/10] docs(SRV): add raw content --- .../troubleshooting/common-errors.mdx | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/serverless/containers/troubleshooting/common-errors.mdx b/serverless/containers/troubleshooting/common-errors.mdx index 85d3d7149b..57c46e34c0 100644 --- a/serverless/containers/troubleshooting/common-errors.mdx +++ b/serverless/containers/troubleshooting/common-errors.mdx @@ -13,3 +13,41 @@ categories: - serveless --- +## Unable to deploy the image + + Does the container listen on 0.0.0.0 on port “$PORT” or 8080 + KSVC is in RevisionMissing and pods in CrashLoopBackOff + +Inspect the image used by the customer and check the Architecture: +docker inspect rg.fr-par.scw.cloud/scrapfast/node-web-app-test@sha256:4a389d6866ea6e35b226a69bfe55f754b0678f3da3b99fd6eab62a00b64094d0 | grep Arch + "Architecture": "arm64", + +If it is arm64 , it can't work with knative, the customer must have built it on ARM machine (Apple M1 for exemple). Tell him to build it for amd64 architecture. + + +## Unable to build + +Is the namespace registry still available ? +Image is deployed but + + Can’t access to specific folder or files + + +## Unable to create a namespace + +This can happened for the following reasons : + + User created to much namespaces and hit the max quotas (see limits page) + User created to much Registry namespace and the system can't create more + + +Try to change KSVC port + +Edit the KSVC to change current listening port to see if it starts, do not forget tu delete generated revisions + + +### Check image size + +skopeo inspect --raw docker://registry.docker.com/library/alpine@sha256:e7d88de73db3d3fd9b2d63aa7f447a10fd0220b7cbf39803c803f2af9ba256b3 \ + | jq -r '[ .layers[].size ] | add' + From 58582ef8d5ecfdf0e409355d381433c3b09ed809 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 28 Aug 2023 16:11:30 +0200 Subject: [PATCH 05/10] docs(SRV): update content --- .../troubleshooting/common-errors.mdx | 44 +++++++++++-------- 1 file changed, 25 insertions(+), 19 deletions(-) diff --git a/serverless/containers/troubleshooting/common-errors.mdx b/serverless/containers/troubleshooting/common-errors.mdx index 57c46e34c0..76803eeb55 100644 --- a/serverless/containers/troubleshooting/common-errors.mdx +++ b/serverless/containers/troubleshooting/common-errors.mdx @@ -15,39 +15,45 @@ categories: ## Unable to deploy the image - Does the container listen on 0.0.0.0 on port “$PORT” or 8080 - KSVC is in RevisionMissing and pods in CrashLoopBackOff +### Possible solutions -Inspect the image used by the customer and check the Architecture: -docker inspect rg.fr-par.scw.cloud/scrapfast/node-web-app-test@sha256:4a389d6866ea6e35b226a69bfe55f754b0678f3da3b99fd6eab62a00b64094d0 | grep Arch - "Architecture": "arm64", +- Make sure the container is bound to `0.0.0.0`. -If it is arm64 , it can't work with knative, the customer must have built it on ARM machine (Apple M1 for exemple). Tell him to build it for amd64 architecture. +- Make sure the container is listening on port `$PORT` or `8080`. +- Check if KSVC is in `RevisionMissing` status. -## Unable to build +- Check if pods are in `CrashLoopBackOff` status. + +- Make sure you built your image for an `amd64` architecture, as `arm64` is not supported. -Is the namespace registry still available ? -Image is deployed but +- Make sure your deployment does not exceed the limitations of [Serverless Containers](/serverless/containers/reference-content/containers-limitations/). - Can’t access to specific folder or files + + Run the [`docker inspect`](https://docs.docker.com/engine/reference/commandline/inspect/) command to get detailed information on your image: + ``` + docker inspect myimage + ``` + +## Unable to build -## Unable to create a namespace +### Possible solutions -This can happened for the following reasons : +- Make sure that you used a public image from the [Docker Registry](https://docs.docker.com/registry/) or a correct image from the [Scaleway Container Registry](/serverless/containers/how-to/deploy-a-container-from-scaleway-container-registry/). - User created to much namespaces and hit the max quotas (see limits page) - User created to much Registry namespace and the system can't create more +- Make sure the image is still available in the [Scaleway Container Registry](/containers/container-registry/concepts/#container-registry). +## Failed to create a namespace -Try to change KSVC port +### Cause -Edit the KSVC to change current listening port to see if it starts, do not forget tu delete generated revisions +This issue can happen for the following reasons: +- You created too many namespaces and reached [your account's quota](/console/my-account/reference-content/organization-quotas/#serverless-containers) +- You created too many Registry namespaces and reached [your account's quota](/console/my-account/reference-content/organization-quotas/#container-registry) -### Check image size +### Possible solutions -skopeo inspect --raw docker://registry.docker.com/library/alpine@sha256:e7d88de73db3d3fd9b2d63aa7f447a10fd0220b7cbf39803c803f2af9ba256b3 \ - | jq -r '[ .layers[].size ] | add' +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). From 801d0e35ca72228cfcc5de6622bab6ef39c7f379 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 28 Aug 2023 16:57:31 +0200 Subject: [PATCH 06/10] docs(SRV): update index title --- serverless/functions/troubleshooting/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/serverless/functions/troubleshooting/index.mdx b/serverless/functions/troubleshooting/index.mdx index ea65dfea63..1112caf255 100644 --- a/serverless/functions/troubleshooting/index.mdx +++ b/serverless/functions/troubleshooting/index.mdx @@ -1,8 +1,8 @@ --- meta: - title: Serverless Functions - Troubleshooting Documentation + title: Containers - Troubleshooting description: Serverless Functions Troubleshooting Documentation content: - h1: Serverless Functions Troubleshooting Documentation + h1: Containers - Troubleshooting paragraph: Serverless Functions Troubleshooting Documentation --- \ No newline at end of file From b72e729a5539451ba93e4123992edeab52be68fc Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 28 Aug 2023 17:07:30 +0200 Subject: [PATCH 07/10] docs(SRV): fix index titles --- serverless/containers/troubleshooting/index.mdx | 4 ++-- serverless/functions/troubleshooting/index.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/serverless/containers/troubleshooting/index.mdx b/serverless/containers/troubleshooting/index.mdx index 5ef15f6406..6cd7827240 100644 --- a/serverless/containers/troubleshooting/index.mdx +++ b/serverless/containers/troubleshooting/index.mdx @@ -1,8 +1,8 @@ --- meta: - title: Serverless Containers - Troubleshooting Documentation + title: Containers - Troubleshooting description: Serverless Containers Troubleshooting Documentation content: - h1: Serverless Containers Troubleshooting Documentation + h1: Containers Troubleshooting paragraph: Serverless Containers Troubleshooting Documentation --- \ No newline at end of file diff --git a/serverless/functions/troubleshooting/index.mdx b/serverless/functions/troubleshooting/index.mdx index 1112caf255..1cc737514e 100644 --- a/serverless/functions/troubleshooting/index.mdx +++ b/serverless/functions/troubleshooting/index.mdx @@ -1,8 +1,8 @@ --- meta: - title: Containers - Troubleshooting + title: Functions - Troubleshooting description: Serverless Functions Troubleshooting Documentation content: - h1: Containers - Troubleshooting + h1: Functions - Troubleshooting paragraph: Serverless Functions Troubleshooting Documentation --- \ No newline at end of file From 79891907998be1b44d641cc74c0fc31ba6c64ac4 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 28 Aug 2023 17:11:59 +0200 Subject: [PATCH 08/10] docs(SRV): doc review 1 --- serverless/containers/troubleshooting/common-errors.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/serverless/containers/troubleshooting/common-errors.mdx b/serverless/containers/troubleshooting/common-errors.mdx index 76803eeb55..8ba3de1dba 100644 --- a/serverless/containers/troubleshooting/common-errors.mdx +++ b/serverless/containers/troubleshooting/common-errors.mdx @@ -21,8 +21,6 @@ categories: - Make sure the container is listening on port `$PORT` or `8080`. -- Check if KSVC is in `RevisionMissing` status. - - Check if pods are in `CrashLoopBackOff` status. - Make sure you built your image for an `amd64` architecture, as `arm64` is not supported. @@ -40,7 +38,7 @@ categories: ### Possible solutions -- Make sure that you used a public image from the [Docker Registry](https://docs.docker.com/registry/) or a correct image from the [Scaleway Container Registry](/serverless/containers/how-to/deploy-a-container-from-scaleway-container-registry/). +- Make sure that you used a public image from the [Docker Registry](https://docs.docker.com/registry/) or a compatible image from the [Scaleway Container Registry](/serverless/containers/how-to/deploy-a-container-from-scaleway-container-registry/). - Make sure the image is still available in the [Scaleway Container Registry](/containers/container-registry/concepts/#container-registry). From 83767dcc06c2541958753ba5c5c2f5288401b29b Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 28 Aug 2023 17:20:39 +0200 Subject: [PATCH 09/10] docs(SRV): typo --- serverless/containers/troubleshooting/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/serverless/containers/troubleshooting/index.mdx b/serverless/containers/troubleshooting/index.mdx index 6cd7827240..62b9764001 100644 --- a/serverless/containers/troubleshooting/index.mdx +++ b/serverless/containers/troubleshooting/index.mdx @@ -3,6 +3,6 @@ meta: title: Containers - Troubleshooting description: Serverless Containers Troubleshooting Documentation content: - h1: Containers Troubleshooting + h1: Containers - Troubleshooting paragraph: Serverless Containers Troubleshooting Documentation --- \ No newline at end of file From 9b3ba466ef320eb9e1cd61ee5b6a598c5b47f1bc Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 28 Aug 2023 17:22:49 +0200 Subject: [PATCH 10/10] docs(SRV): typo again --- serverless/containers/troubleshooting/index.mdx | 2 +- serverless/functions/troubleshooting/index.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/serverless/containers/troubleshooting/index.mdx b/serverless/containers/troubleshooting/index.mdx index 62b9764001..b37f26baef 100644 --- a/serverless/containers/troubleshooting/index.mdx +++ b/serverless/containers/troubleshooting/index.mdx @@ -3,6 +3,6 @@ meta: title: Containers - Troubleshooting description: Serverless Containers Troubleshooting Documentation content: - h1: Containers - Troubleshooting + h1: Containers - Troubleshooting paragraph: Serverless Containers Troubleshooting Documentation --- \ No newline at end of file diff --git a/serverless/functions/troubleshooting/index.mdx b/serverless/functions/troubleshooting/index.mdx index 1cc737514e..5880c643ab 100644 --- a/serverless/functions/troubleshooting/index.mdx +++ b/serverless/functions/troubleshooting/index.mdx @@ -3,6 +3,6 @@ meta: title: Functions - Troubleshooting description: Serverless Functions Troubleshooting Documentation content: - h1: Functions - Troubleshooting + h1: Functions - Troubleshooting paragraph: Serverless Functions Troubleshooting Documentation --- \ No newline at end of file