Skip to content
New issue

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

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

Already on GitHub? Sign in 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, 

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

No branches or pull requests

2 participants