Tutorial: CI/CD Integration

Set up continuous integration and deployment with Bootspring quality gates.

What You'll Build#

  • GitHub Actions workflow
  • Automated testing pipeline
  • Quality gate enforcement
  • Preview deployments
  • Production deployment

Prerequisites#

  • GitHub repository
  • Vercel account (for deployment)
  • Bootspring initialized

Time Required#

Approximately 25 minutes.

Step 1: Create Quality Workflow#

Create a GitHub Actions workflow that runs Bootspring quality gates:

Loading code block...

Step 2: Add E2E Testing#

Loading code block...

Step 3: Create Preview Deployment#

Loading code block...

Step 4: Production Deployment#

Loading code block...

Step 5: Add Branch Protection#

Configure branch protection rules in GitHub:

  1. Go to Settings → Branches
  2. Add rule for main:
    • Require status checks before merging
    • Require branches to be up to date
    • Select required checks:
      • Quality Checks
      • Tests
      • Playwright Tests
    • Require review from code owners

Step 6: Configure Secrets#

Add secrets in GitHub Settings → Secrets and variables → Actions:

SecretDescription
BOOTSPRING_API_KEYBootspring API key
VERCEL_TOKENVercel API token
VERCEL_ORG_IDVercel organization ID
VERCEL_PROJECT_IDVercel project ID
SLACK_WEBHOOKSlack webhook URL
CODECOV_TOKENCodecov upload token

Step 7: Create Database Migrations Workflow#

Loading code block...

Step 8: Add Dependency Updates#

Loading code block...

Step 9: Monitor Deployments#

Vercel Analytics#

Enable Vercel Analytics in your project:

Loading code block...

Error Monitoring#

Set up Sentry:

Loading code block...

Step 10: Test the Pipeline#

  1. Create a feature branch:

    Loading code block...
  2. Make a change and push:

    Loading code block...
  3. Create a pull request

  4. Verify:

    • Quality checks run
    • Tests pass
    • Preview deploys
    • PR can be merged
  5. Merge to main:

    • Production deploy triggers
    • Deployment succeeds

Verification Checklist#

  • Quality workflow runs on PRs
  • Tests run and pass
  • Preview deployments work
  • Production deployments work
  • Branch protection enabled
  • Notifications working

What You Learned#

  • GitHub Actions setup
  • Quality gate integration
  • Preview deployments
  • Production deployment pipeline
  • Branch protection

Next Steps#