Deployment

xTrakt services deploy to Google Cloud Run through GitHub Actions workflows.

Branch Model

Branch	Environment
main	Development deployment
release/*	Production deployment

Backend Deployment

• Backend services use a root multi-stage Dockerfile.
• Each service receives configuration from environment variables and GCP Secret Manager.
• Internal NuGet packages are restored from GitHub Packages during CI.

Frontend Deployment

• Frontend builds use node:20-alpine.
• Runtime uses nginx:alpine on port 8080.
• The nginx SPA fallback uses try_files $uri $uri/ /index.html.

Release Checklist

1. Confirm the target branch.
2. Confirm secrets exist for the target environment.
3. Confirm package restore can access GitHub Packages.
4. Build and test the changed service.
5. Monitor Cloud Run startup and logs after deployment.

Related Docs

• Configuration And Secrets
• Observability
• Local Setup