FluxCD Reconcile - GitHub Action

Key Features

Fast, reliable FluxCD reconciliation in your CI/CD pipeline

🔄

Instant Reconciliation

Trigger FluxCD to immediately reconcile HelmChart sources and HelmReleases

⚡

Fast Deployments

Deploy updates instantly without waiting for FluxCD's polling interval

🎯

Simple Mode

Quick setup with smart defaults for common use cases

Quick Start

Add to your workflow in seconds

Simple Mode (Recommended)

- uses: starburst997/flux-reconcile@v1
  with:
    kube-config: ${{ secrets.KUBE_CONFIG }}
    name: my-app
    namespace: my-app

This automatically reconciles HelmChart my-app-my-app in flux-registry and HelmRelease my-app in my-app namespace.

Advanced Mode

- uses: starburst997/flux-reconcile@v1
  with:
    kube-config: ${{ secrets.KUBE_CONFIG }}
    chart-name: custom-chart-name
    registry-namespace: custom-registry
    release-name: custom-release
    release-namespace: custom-namespace

Complete Example

name: Deploy to Production

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Build and push chart
        run: |
          helm package .
          helm push *.tgz oci://registry.example.com/charts

      - uses: starburst997/flux-reconcile@v1
        with:
          kube-config: ${{ secrets.KUBE_CONFIG }}
          name: my-app
          namespace: my-app

Documentation

Inputs

Input	Description	Required	Default
`kube-config`	Kubernetes configuration (base64 encoded or plain text)	Yes	-
`name`	Simple mode: Application name (generates `name-name` for chart)	No	-
`namespace`	Simple mode: Application namespace	No	-
`chart-name`	Advanced: Name of the HelmChart (ignored if `name` is provided)	No	-
`registry-namespace`	Namespace where the HelmChart source is located	No	flux-registry
`release-name`	Advanced: HelmRelease name (ignored if `name` is provided)	No	-
`release-namespace`	Advanced: HelmRelease namespace (ignored if `namespace` is provided)	No	-
`chart-timeout`	Timeout for HelmChart reconciliation	No	2m
`release-timeout`	Timeout for HelmRelease reconciliation	No	5m
`version`	Expected chart version to verify after reconciliation	No	-
`clean-version`	Clean version string by removing 'v' prefix and '-XXXXXX' suffix	No	true
`git-push`	Push commits and tags to remote repository	No	false