Kaiten
Guides

CI/CD Deployments

Integrate Kaiten releases and deployments into your CI/CD pipeline.

CI/CD Deployments Guide

Integrate Kaiten's release tracking into your CI/CD pipeline to automatically record deployments.

Pipeline Integration

1. Create a Release on Build

In your CI pipeline, after building an artifact:

curl -X POST http://localhost:6000/api/releases \
  -H "Authorization: Bearer ksh_ci_token" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "'$GIT_TAG'",
    "slug": "'$GIT_TAG'"
  }'

2. Deploy to a Zone

After a successful deployment:

curl -X POST http://localhost:6000/api/deployment-zones/us-east-production/deploy \
  -H "Authorization: Bearer ksh_ci_token" \
  -H "Content-Type: application/json" \
  -d '{
    "releaseSlug": "'$GIT_TAG'"
  }'

3. Subscribe to Events

Set up a webhook for deployment events to trigger notifications:

  • RELEASE_CREATION — new version available
  • RELEASE_DEPLOYMENT — deployed to a zone

GitHub Actions Example

- name: Record Kaiten Release
  run: |
    curl -X POST $KAITEN_API_URL/releases \
      -H "Authorization: Bearer $KAITEN_TOKEN" \
      -H "Content-Type: application/json" \
      -d "{\"version\": \"${{ github.ref_name }}\"}"

- name: Record Deployment
  run: |
    curl -X POST $KAITEN_API_URL/deployment-zones/production/deploy \
      -H "Authorization: Bearer $KAITEN_TOKEN" \
      -H "Content-Type: application/json" \
      -d "{\"releaseSlug\": \"${{ github.ref_name }}\"}"

On this page