Skip to content

docs: Troubleshooting proxy build errors#1011

Open
christopher-hakkaart wants to merge 2 commits intomasterfrom
docs-wave-troubleshooting
Open

docs: Troubleshooting proxy build errors#1011
christopher-hakkaart wants to merge 2 commits intomasterfrom
docs-wave-troubleshooting

Conversation

@christopher-hakkaart
Copy link
Copy Markdown
Member

@christopher-hakkaart christopher-hakkaart commented Apr 1, 2026

  • Explain how to interpret and troubleshoot Wave build errors when builds fail due to errors container registries behind reverse proxies, specifically Cloudflare EDU-1108

Copy link
Copy Markdown
Contributor

@gavinelder gavinelder left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am unsure about the appropriateness of this documentation.

From the EDU Ticket

The Wave documentation does not explain how to interpret or troubleshoot Wave build errors, particularly when builds fail due to errors propagating from customer container registries behind reverse proxies like Cloudflare. The WAVE build page currently displays only a single-line error message, which obscures the root cause (e.g., whether the error originates from the customer's ACR, Cloudflare, or buildkit).

In this specific instance the customers infrastructure was returning an error which was conveyed in the build logs.

This PR documents the troubleshooting steps taken to confirm the customers infrastructure provider due to not being aware of the internal repository configuration which is outside of our support boundary.

I would personally limit the documentation to if you see the following in the build logs

#9 1267.4 error: failed to copy: unexpected status from PUT request to https:/xxxx: 520 <none>

This indicates an error sending file contents to the upstream repository, please contact the upstream repository owner for support and guidance.

@christopher-hakkaart
Copy link
Copy Markdown
Member Author

I would personally limit the documentation to if you see the following in the build logs

All good, I'll strip this back to something that describes the error and to contact the repository owner for support and guidance

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants