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