Please explain Deploy Preview Links

[tpluscode]

The documentation mentions that in order to use preview links, one must

Have a continuous deployment platform that builds every commit and provides statuses to your repo

How does this work exactly? Is decap inspecting the statuses to provide the right link? Are there some requirements for these statuses?

In our setup we intend to deploy site previews to our site using subdomains. Similarly to to what netlif does but deployed in our own cluster

[martinjagodic]

I don't know the details here. One would have to dig into the codebase to see what's going on. This is ripe for an issue on the decap-website repo. For now, I assume this feature only works with Netlify.

[tpluscode]

where do I look for related code?

[martinjagodic]

The core is in deploys.ts

[tpluscode]

Thanks @martinjagodic for the pointer. Preview do indeed work 🎉

There are two details and one gotcha:

1. Decap checks for commit status and not PR status. I used myrotvorets/set-commit-status-action to set it
2. The only requirement is that the string "deploy" is included in the status context
3. The gotcha is that if multiple status would contain the word "deploy", decap only finds the first and ignores the other, which may lead to wrong results

[martinjagodic]

Thanks for the clarification. Would you mind adding that to the docs as a note?

[tpluscode]

decaporg/decap-website#131