Pages
Internal Errors
The team has improved the messaging on a lot (big props to Jacob!) of these causes so hopefully you should see these less but they will still happen.
Initializing
Some possible causes:
- Not enough permissions
- Either at the install, org or user level
- GitLab requires users to be "maintainer'
Cloning
Hopefully cloning should now be internal error free, please let the team know if you see any!
Building
Hopefully building should now be internal error free, please let the team know if you see any!
Deploying
Some possible causes:
- Functions code
- We've seen this most commonly with people trying to use
processandglobal
- We've seen this most commonly with people trying to use
- Intermittent issue
- Retrying will likely succeed
Error creating project
If a user gets an error like "An unknown error occurred" during the project creation this is likely caused by:
- The same repo being added on another account
Error updating submodules
If a user gets an error like: "Failed: error occurred while updating repo submodules." there are a few likely causes for this:
- Private submodule
- No
urlset in.gitmodules- Please refer to this for more info: https://community.cloudflare.com/t/pages-build-error-failed-error-occurred-while-updating-repo-submodules/356890/5
Env Variables not working
Sometimes someone will use an environment variable and it will look perfectly fine. The name is valid and the value valid. However, it will not work. When this happens, it's very likely there's a space or special character somewhere in the name or value. Often caused by copying or just adding a space after.
We will work to make sure this doesn't happen and if it does the UI shows it. For now though, if it happens recommend someone types it manually and makes sure there's no space at the start/end.