From b92ea40052b5c73935bf1db9c2c1687394fc4377 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 5 Mar 2025 14:32:18 +0100 Subject: [PATCH 1/5] feat(ctr): add troubleshooting --- menu/navigation.json | 10 +++ ...g-container-registry-image-push-issues.mdx | 73 +++++++++++++++++++ 2 files changed, 83 insertions(+) create mode 100644 pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx diff --git a/menu/navigation.json b/menu/navigation.json index 113aff08b7..58eeef7dd0 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2234,6 +2234,16 @@ ], "label": "API/CLI", "slug": "api-cli" + }, + { + "items": [ + { + "label": "Troubleshooting Container Registry image push issues", + "slug": "troubleshooting-container-registry-image-push-issues" + } + ], + "label": "Troubleshooting", + "slug": "troubleshooting" } ], "label": "Container Registry", diff --git a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx b/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx new file mode 100644 index 0000000000..11b5c8581f --- /dev/null +++ b/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx @@ -0,0 +1,73 @@ +--- +meta: + title: Troubleshooting Container Registry image push issues + description: Solutions for resolving issues when pushing images to Scaleway's Container Registry. +content: + h1: Troubleshooting Container Registry image push issues + paragraph: This guide provides solutions for common issues encountered when pushing images to Scaleway's Container Registry. +tags: container-registry, troubleshooting +dates: + validation: 2025-03-05 + posted: 2025-03-05 +categories: + - container-registry +--- + +## Problem +You are unable to push images to Scaleway's Container Registry. + +### Symptoms +- The `docker push` command fails with an error message. +- Authentication or authorization errors occur. +- The image push process hangs or times out. + +## Possible causes +- Incorrect authentication or authorization settings. +- Misconfigured or outdated Docker client. +- Network connectivity issues or firewall restrictions. +- Exceeded Container Registry quotas or limits. + +## Solutions + +### Verify authentication and authorization +- Ensure you are logged in with a valid Scaleway account using `docker login`. +- Confirm that your account has the necessary permissions to push images. +- Verify that your Docker client is [correctly configured](/container-registry/how-to/connect-docker-cli/) for Scaleway's Container Registry. + +### Check Docker configuration and version +- Ensure your Docker client is up-to-date by running: + ```sh + docker --version + ``` +- Check for configuration errors in the Docker daemon and client. +- Review the [Docker documentation](https://docs.docker.com/) for known compatibility issues. + +### Investigate network connectivity issues +- Confirm that your internet connection is stable. +- Check firewall or proxy settings that may be blocking the connection. +- Try pushing the image from a different network or VPN to rule out local issues. + +### Verify Container Registry quotas and limits +- Ensure you have not exceeded your Scaleway Container Registry storage limits. +- Refer to Scaleway’s documentation for [quota information](/organizations-and-projects/additional-content/organization-quotas/#container-registry). + +### Review error messages and logs +- Run the push command with verbose output for more details: + ```sh + docker push --debug + ``` +- Check the Docker client logs for warnings or errors: + ```sh + docker logs + ``` +- Verify Scaleway’s Container Registry [status](https://status.scaleway.com/) for any ongoing incidents. + +## Additional troubleshooting steps +- Try pushing a small test image to verify general functionality: + ```sh + docker pull alpine && docker tag alpine /test-image && docker push /test-image + ``` +- Review Docker’s official [troubleshooting guides](https://docs.docker.com/tags/troubleshooting/) for further insights. +- If the issue persists, [contact our support team](https://console.scaleway.com/support) with error logs and diagnostic details. + + From 3a3f82e7c2bb1472215448108b1be17ecd231dcc Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Wed, 5 Mar 2025 15:18:54 +0100 Subject: [PATCH 2/5] feat(cr): update content --- ...g-container-registry-image-push-issues.mdx | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx b/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx index 11b5c8581f..510adc40b1 100644 --- a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx +++ b/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx @@ -34,6 +34,17 @@ You are unable to push images to Scaleway's Container Registry. - Confirm that your account has the necessary permissions to push images. - Verify that your Docker client is [correctly configured](/container-registry/how-to/connect-docker-cli/) for Scaleway's Container Registry. +### Review error messages and logs +- Run the push command with verbose output for more details: + ```sh + docker push --debug + ``` +- Check the Docker client logs for warnings or errors: + ```sh + docker logs + ``` +- Verify Scaleway’s Container Registry [status](https://status.scaleway.com/) for any ongoing incidents. + ### Check Docker configuration and version - Ensure your Docker client is up-to-date by running: ```sh @@ -51,17 +62,6 @@ You are unable to push images to Scaleway's Container Registry. - Ensure you have not exceeded your Scaleway Container Registry storage limits. - Refer to Scaleway’s documentation for [quota information](/organizations-and-projects/additional-content/organization-quotas/#container-registry). -### Review error messages and logs -- Run the push command with verbose output for more details: - ```sh - docker push --debug - ``` -- Check the Docker client logs for warnings or errors: - ```sh - docker logs - ``` -- Verify Scaleway’s Container Registry [status](https://status.scaleway.com/) for any ongoing incidents. - ## Additional troubleshooting steps - Try pushing a small test image to verify general functionality: ```sh From be07368b1ec132332da20396580a67ea3c196665 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Thu, 6 Mar 2025 10:36:37 +0100 Subject: [PATCH 3/5] Update pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- .../troubleshooting-container-registry-image-push-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx b/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx index 510adc40b1..e74cd5ef08 100644 --- a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx +++ b/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx @@ -1,6 +1,6 @@ --- meta: - title: Troubleshooting Container Registry image push issues + title: Common errors when pushing images to a container description: Solutions for resolving issues when pushing images to Scaleway's Container Registry. content: h1: Troubleshooting Container Registry image push issues From 633d81548422ff445bb724949e9e468373c06a45 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Thu, 6 Mar 2025 10:40:00 +0100 Subject: [PATCH 4/5] fix(cr): update wording --- menu/navigation.json | 2 +- ...mmon-errors-when-pushing-images-to-container-registry.mdx} | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) rename pages/container-registry/troubleshooting/{troubleshooting-container-registry-image-push-issues.mdx => common-errors-when-pushing-images-to-container-registry.mdx} (95%) diff --git a/menu/navigation.json b/menu/navigation.json index 58eeef7dd0..26a021998a 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2238,7 +2238,7 @@ { "items": [ { - "label": "Troubleshooting Container Registry image push issues", + "label": "Common errors when pushing images to Container Registry", "slug": "troubleshooting-container-registry-image-push-issues" } ], diff --git a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx b/pages/container-registry/troubleshooting/common-errors-when-pushing-images-to-container-registry.mdx similarity index 95% rename from pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx rename to pages/container-registry/troubleshooting/common-errors-when-pushing-images-to-container-registry.mdx index e74cd5ef08..b2a9a3b9fa 100644 --- a/pages/container-registry/troubleshooting/troubleshooting-container-registry-image-push-issues.mdx +++ b/pages/container-registry/troubleshooting/common-errors-when-pushing-images-to-container-registry.mdx @@ -1,9 +1,9 @@ --- meta: - title: Common errors when pushing images to a container + title: Common errors when pushing images to Container Registry description: Solutions for resolving issues when pushing images to Scaleway's Container Registry. content: - h1: Troubleshooting Container Registry image push issues + h1: Common errors when pushing images to Container Registry paragraph: This guide provides solutions for common issues encountered when pushing images to Scaleway's Container Registry. tags: container-registry, troubleshooting dates: From 1935b9a5ee67e1cb41e3575146a53bddbf8e3dea Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Thu, 6 Mar 2025 10:43:06 +0100 Subject: [PATCH 5/5] Apply suggestions from code review --- menu/navigation.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/menu/navigation.json b/menu/navigation.json index 26a021998a..017e718b3b 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2239,7 +2239,7 @@ "items": [ { "label": "Common errors when pushing images to Container Registry", - "slug": "troubleshooting-container-registry-image-push-issues" + "slug": "common-errors-when-pushing-images-to-container-registry" } ], "label": "Troubleshooting",