CI/CD & Edge Deployments
Resolve orchestration breakdowns during the deployment lifecycle, from GitHub workflow dispatch errors to OpenNext compilation crashes.
“The GN-Apex Control Plane handles orchestration, but the actual compilation occurs on GitHub Actions. Diagnostics require checking the runner logs.”
GitHub Action Fails to Trigger
When you click Deploy in GN-Apex, the system dispatches a workflow to your connected GitHub repository. If the deployment remains stuck on PENDING:
Missing App Installation
Ensure the GN-Apex GitHub App is installed on the target repository with Actions Read/Write permissions.
Missing nexus-deploy.yml
The system requires the deployment YAML file in .github/workflows. Run 'npx nexus init' locally and push to main.
Build Failures (Next.js & OpenNext)
If the status updates to FAILED, open the GitHub Actions tab in your repository to read the terminal output:
- Type Checking Errors (tsc):If you modified the schema but didn't run
npx nexus types, your Next.js build will fail due to TypeScript interface mismatches. - Wrangler Asset Limit: Cloudflare Workers have a 25MB script size limit. Ensure heavy images/videos are uploaded to the
/mediastorage vault, not committed directly to the/publicGit repository.
| 1 | Failed to compile. |
| 2 | ./app/page.tsx:14:23 |
| 3 | Type error: Property 'featured_image' does not exist on type 'HomePage'. |
| 4 | |
| 5 | > Fix: Run 'npx nexus pull && npx nexus types' locally and commit the result. |