Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Add "Troubleshooting Tips" page for Fermyon Cloud that includes CLI error response codes #1269

Open
macolso opened this issue May 2, 2024 · 1 comment
Labels
documentation Improvements or additions to documentation

Comments

@macolso
Copy link
Contributor

macolso commented May 2, 2024

In the case that a user's deployment or upgrade fails, it would be helpful to be able to direct that user to official developer.fermyon.com documentation that includes step-by-step instructions on how to resolve that issue, as well as a table reference of common CLI error codes from the spin cloud plugin.

See Cloudflare for example

@macolso macolso added the documentation Improvements or additions to documentation label May 2, 2024
@flynnduism
Copy link
Member

Thanks @macolso. Some examples of errors that are sometimes surfaced in failed spin deployments.

As a user who runs into these problems from time to time, there is no place in our docs that lists/explains these responses, so there's no guidance to the user. Given how these deploys bring together many pieces, having a "broad strokes" explanation or direction of the root of the issue would be amazing (i.e. the error is likely a Spin issue, user error, cloud-plugin, nimbus, an SDK etc)

Example CLI responses we see today

Application deployed, but Spin could not establish readiness
Caused by:
    0: failed to read input file
    1: No such file or directory (os error 2)
Error: exit status: 1
Error: cannot push Spin application

Caused by:
    Server error: url https://registry.cloud.fermyon.com/v2/cloud-config/blobs/uploads/, code: 500, message:
Deploying...
Error: Unable to create app

Caused by:
    response status code: 500 Internal Server Error

Learn more at https://developer.fermyon.com/cloud/faq
Error: cannot push Spin application

Caused by:
    Server error: url https://registry.cloud.fermyon.com/v2/fermyon-www/manifests/0.3.0-rf2403829, code: 405, message: {"errors":[{"code":"UNSUPPORTED","message":"Invalid parameter at 'ImageManifest' failed to satisfy constraint: 'Limit on number of layers per image exceeded'"}]}


Learn more at https://developer.fermyon.com/cloud/faq
Error: cannot push Spin application

Caused by:
  Server error: url https://registry.cloud.fermyon.com/v2/fermyon-www-pr-809/blobs/uploads/, code: 401, 

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants