Setting Up CI/CD with GitHub Actions

GitHub Actions CI/CD Pipeline

Boottify integrates with GitHub Actions to provide automated build, test, and deployment workflows. Every push to your main branch can trigger a full deployment pipeline.

Setting Up Your Workflow

1. Navigate to your app in the control center
2. Go to Settings → Deployment → CI/CD
3. Click Generate GitHub Actions Workflow
4. Copy the generated .github/workflows/deploy.yml file to your repository

Workflow Configuration

The default workflow includes these stages:

name: Deploy to Boottify
on:
  push:
    branches: [main]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build Docker image
        run: docker build -t app .
      - name: Deploy to Boottify
        uses: boottify/deploy-action@v1
        with:
          app-id: ${{ secrets.BOOTTIFY_APP_ID }}
          api-key: ${{ secrets.BOOTTIFY_API_KEY }}

Docker Image Requirements

• Image names must be lowercase (OCI specification requirement)
• Use multi-stage builds to minimize image size
• Include a health check endpoint at /api/health
• Expose the application port in your Dockerfile

Environment Variables

Store secrets in GitHub's repository settings under Settings → Secrets and variables → Actions. Required secrets:

• BOOTTIFY_APP_ID — Your application ID from the control center
• BOOTTIFY_API_KEY — API key generated in Settings → API Keys

Monitoring Deployments

Each deployment sends real-time step webhooks to the control center. You can monitor progress in Apps → Your App → Deployments tab.