Releases & Deployments
Manage versioned releases, components, and deployment zones.
Releases & Deployments
Kaiten tracks your product's versioning and deployment lifecycle through Components, Releases, and Deployment Zones.
Components
A Component is a versioned service or module in your product (e.g. "API Server", "Worker", "Frontend").
| Field | Description |
|---|---|
name | Component name (unique per org) |
slug | URL-safe identifier |
version | Version string |
description | Free-form description (optional) |
previous_component_id | Optional link to previous version |
Releases
A Release is a versioned bundle that groups one or more components:
| Field | Description |
|---|---|
version | Release version (unique per org) |
slug | URL-safe identifier |
description | Free-form description (optional) |
component_ids | List of component IDs to include in this release |
Components are linked to releases via component_release (many-to-many).
Deployment Zones
A Deployment Zone is a logical execution environment:
| Field | Description |
|---|---|
name | Zone name (e.g. "US East Production") |
slug | URL-safe identifier |
type | Zone type: production, staging, or development |
description | Free-form description (optional) |
features | Optional JSON capabilities metadata |
release_id | Currently deployed release (optional) |
Instances optionally reference a deployment zone via deployment_zone_id.
Deployments
A Deployment links a Release to a Deployment Zone:
Release: "v2.1.0" → Deployment Zone: "US East Production"This represents: "Release v2.1.0 has been deployed to the US East Production zone."
Flow
Component: "api-server" v2.1.0
Component: "worker" v1.3.0
↓
Release: "v2.1.0" (bundles both components)
↓
Deployment → Deployment Zone: "US East Production"
↓
Instances in this zone are now on Release v2.1.0Events
| Event | Type |
|---|---|
RELEASE_CREATION | com.kaiten.release.v1.created |
RELEASE_DELETION | com.kaiten.release.v1.deleted |
DEPLOYMENT_ZONE_CREATION | com.kaiten.deploymentZone.v1.created |
RELEASE_DEPLOYMENT | com.kaiten.deploymentZone.v1.releaseDeployed |
See It in the Console
Manage your full release pipeline from the Console — create components and releases, set up deployment zones, and deploy releases to your environments.