Improve Verbiage and Next Steps When Workspace Process Has Trouble Using a Container Image Specified in .gitpod.yml

[jimmybrancaccio]

Is your feature request related to a problem? Please describe

When a user has specified a container image to use for their workspace within their repositories .gitpod.yml file and the image either doesn't exist, requires some sort of authentication to access, or there's some other issue that prevents it from being used we show a rather generic error message. On the page which displays this error message we also advise the customer to contact support which generally results in support telling them the issue isn't on our end.

Describe the behaviour you'd like

I believe there's an opportunity for improvements on this page when this issue occurs.

• We should see if it's possible to determine what the exact error is and display that (fall back with a generic message like we have now).
• We should show the user which image is trying to be used and advise them to check and make sure the image exists and is publicly accessible (if that's one of our requirements).
• Provide a link to our documentation on how to use other images for their workspaces.
• Advise them if they've done all of the above to contact support.

Describe alternatives you've considered

N/A

Additional context

This was brought to my attention in a recently submitted support ticket in Front (cnv_jkpb0p6).

Front conversations

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.