Deploy Transient

Deploy transient Helm environments with ease. Inherit values from existing HelmReleases and create isolated preview environments that match your dev/staging configuration.

Get Started Documentation

Simplified Transient Deployments

Perfect for PR previews, feature branches, and temporary environments

⎈

Inherit Values

Fetch configuration from existing HelmReleases in your cluster automatically.

🔄

Smart Overrides

Override specific values like ingress host and environment variables.

🌿

Namespace Logic

Automatic namespace detection based on environment with customizable suffixes.

⚡

Atomic Deploys

Atomic rollback on failure ensures your cluster stays in a consistent state.

Quick Start

Deploy a PR preview environment in minutes 

name: Deploy PR Preview
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  preview:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Deploy Preview
        uses: starburst997/deploy-transient@v1
        with:
          kube-config: ${{ secrets.KUBE_CONFIG }}
          helm-name: my-app
          namespace: my-app
          chart-version: 1.2.3
          ingress-host: pr-${{ github.event.pull_request.number }}.myapp.com

Reference

Complete action inputs documentation

Required Inputs

kube-configREQUIRED
Kubernetes configuration (base64 or plain)
helm-nameREQUIRED
Base name for the Helm release
namespaceREQUIRED
Base namespace (without suffixes)
chart-versionREQUIRED
Chart version to deploy

Namespace Configuration

suffix-pr
Suffix for target namespace
Default: -pr
suffix-dev
Suffix for source namespace (non-staging)
Default: -dev
source-namespace
Override source namespace detection
Default: auto-detected
environment
Environment name (affects source detection)
Default: dev

Chart Configuration

registry
OCI registry URL
Default: ghcr.io
repository-owner
Repository owner/organization
Default: ${{ github.repository_owner }}
chart-name
Chart name (repository name)
Default: ${{ github.event.repository.name }}
chart-prefix
Chart prefix path in OCI registry
Default: charts/

Deployment Options

ingress-host
Ingress host override
Default: none
future-version
Future version environment variable
Default: none
additional-set-values
Extra --set values for helm (one per line)
Default: none
create-namespace
Create namespace if missing
Default: false
helm-timeout
Helm timeout duration
Default: 5m