Skip to main content

CI/CD Integration

Appliku supports automatic deployments on every Git push by default. For teams that want to run tests or other checks before deploying, you can integrate Appliku with your CI/CD pipeline using deploy webhooks.

Default Behavior: Auto-Deploy on Push​

When you connect a Git repository to your Appliku application, every push to the configured branch triggers an automatic deployment. This is the simplest setup and works well for projects with fast, reliable builds.

Using Webhooks for CI/CD​

For more control, you can disable auto-deploy and instead trigger deployments from your CI/CD pipeline after tests pass.

Step 1: Get Your Deploy Webhook URL​

  1. Go to your application in the Appliku dashboard
  2. Navigate to the Webhooks tab
  3. Copy the deploy webhook URL

The webhook URL looks like:

https://api.appliku.com/api/webhook/deploy/<your-webhook-token>/

Step 2: Disable Auto-Deploy (Optional)​

If you want deployments to happen only when triggered by your CI pipeline, disable automatic deployments in your application's build settings.

GitHub Actions Example​

Add a deploy step to your GitHub Actions workflow that calls the Appliku webhook after tests pass:

name: CI/CD

on:
  push:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run tests
        run: |
          pip install -r requirements.txt
          python manage.py test

  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
      - name: Trigger Appliku Deploy
        run: |
          curl -X POST "${{ secrets.APPLIKU_WEBHOOK_URL }}"
tip

Store your webhook URL as a repository secret (APPLIKU_WEBHOOK_URL) in GitHub. Never commit webhook URLs to your source code.

GitLab CI Example​

Add a deploy stage to your .gitlab-ci.yml:

stages:
  - test
  - deploy

test:
  stage: test
  image: python:3.12
  script:
    - pip install -r requirements.txt
    - python manage.py test

deploy:
  stage: deploy
  image: alpine/curl
  only:
    - main
  script:
    - curl -X POST "$APPLIKU_WEBHOOK_URL"

Add APPLIKU_WEBHOOK_URL as a CI/CD variable in your GitLab project settings.

Other CI/CD Providers​

The webhook approach works with any CI/CD provider that can make HTTP requests. The pattern is always the same:

  1. Run your tests
  2. On success, make a POST request to the Appliku deploy webhook URL
note

The webhook triggers a new deployment using the latest commit on the configured branch. Make sure your CI pipeline and Appliku application are configured to use the same branch.