CloudPloy

CI/CD Documentation

CloudPloy handles the deployment side: it deploys every push to your app's branch. Run your tests in your own CI, then let the push deploy.

πŸ™

GitHub Actions

Run tests in GitHub Actions, then push or merge to the branch CloudPloy deploys.

Learn more β†’
🦊

GitLab CI/CD

Run your GitLab pipeline first; CloudPloy deploys when code lands on your branch.

Learn more β†’
☁️

CloudPloy Deploys

Auto-deploy on push, manual deploys, redeploys and rollbacks.

Learn more β†’

CI/CD Pipeline Overview

1

Code Commit

Developer pushes code to a GitHub, GitLab or Bitbucket repository.

2

Continuous Integration

Your CI service (GitHub Actions, GitLab CI or similar) runs tests and linting. CloudPloy does not run your test suite.

3

Continuous Deployment

When code reaches the app's branch, the webhook tells CloudPloy to build and deploy it. Use a separate CloudPloy app per branch if you want a staging copy.

4

Logs & Rollback

Check the deployment status and logs in CloudPloy, and roll back to a previous deployment if something is wrong.

Example CI Jobs

These jobs run in your CI service. Once they pass, merging to the deploy branch triggers the CloudPloy deployment.

Laravel CI/CD

# .gitlab-ci.yml (Laravel)
test:
  image: php:8.3
  script:
    - composer install
    - php artisan test

Node.js/React CI/CD

# .gitlab-ci.yml (Node.js)
test:
  image: node:22
  script:
    - npm ci
    - npm test
    - npm run build

What CloudPloy Handles

CloudPloy is the deployment step. It builds and runs your app on your own server; testing stays in your CI.

✨ Deployments

  • βœ“ Auto-deploy on push via webhook
  • βœ“ Manual deploy and redeploy
  • βœ“ Rollback to a previous deployment
  • βœ“ Deployment history and logs

βš™οΈ Configuration

  • βœ“ Framework detection for Node.js, Next.js, Nuxt, Astro, Laravel, Symfony, Rails, WordPress, PHP, Python and static sites
  • βœ“ Environment variables
  • βœ“ Deploy from the branch you choose
  • βœ“ REST API and MCP server to trigger deploys
# Trigger a deploy from any CI job
curl -X POST https://brain.cloudploy.com/v1/apps/APP_UUID/deploy \
  -H "Authorization: Bearer $CLOUDPLOY_TOKEN"

CI/CD Best Practices

βœ… Do's

  • β€’ Write comprehensive tests
  • β€’ Use feature branches
  • β€’ Automate security scans
  • β€’ Monitor deployment metrics
  • β€’ Implement gradual rollouts
  • β€’ Use environment parity
  • β€’ Cache dependencies
  • β€’ Set up proper alerting

❌ Don'ts

  • β€’ Skip testing stages
  • β€’ Deploy directly to production
  • β€’ Ignore failed tests
  • β€’ Hardcode secrets
  • β€’ Deploy without monitoring
  • β€’ Skip security scanning
  • β€’ Use long-lived branches
  • β€’ Ignore performance regression