🚀 FluxCD Viewer

FluxCD Viewer is a lightweight web interface for visualizing and monitoring FluxCD resources in your Kubernetes cluster.

🎯 Features

• Overview of FluxCD Kustomizations
• Overview of FluxCD HelmReleases
• Real-time deployment status
• Grouping by categories (based on the first path)
• Detailed conditions and error messages

🛠️ Prerequisites

• Kubernetes cluster with FluxCD installed
• Configured kubectl access (kubeconfig file)

📦 Installation

Option 1: Docker

# Run container with mounted kubeconfig
docker run -p 8080:8080 \
 -v ~/.kube/config:/root/.kube/config \
 didlawowo/fluxcd-viewer:latest

Option 2 : Helm

cd helm
helm install fluxcd-viewer

📝 Configuration

The application uses the following environment variables:

Variable	Description	Default
PORT	listening port	8080

🔍 Usage

Access the web interface: http://localhost:8080 The interface automatically displays your Kustomizations and HelmReleases Click on an item to see its details

Using Task

➜  fluxcd-viewer git:(main) task       

task: Available tasks for this project:
* bootstrap:       Initialize the project and install dependencies
* build:           Stop docker compose services
* default:         list all tasks
* deploy:          deploy helm chart
* down:            Stop docker compose services
* logs:            View docker compose logs
* ps:              List docker compose services
* run-dev:         Run the go project with air
* start:           Start docker compose services

🏗️ Local Development

Clone the repo

git clone https://github.com/didlawowo/fluxcd-viewer.git
cd fluxcd-viewer

Install dependencies

go mod download

Run locally

go run main.go
# or
air # for hot-reload

🔐 Security

The application requires read-only access to FluxCD resources. The chart creates a service account with minimal required permissions. The ingress is configured to expose the service.

📝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

📝 Credits

This project was inspired by the need for a simple and lightweight web interface to view FluxCD Kustomizations.

📄 Licence

see LiCENSE file