Terraform Module for KubeGreen

Terraform module to deploy KubeGreen (automated resource cleanup and pod hibernation) on Kubernetes using Helm.

Why This Matters

Cloud infrastructure running 24/7 wastes both money and energy, especially for non-production workloads. Development and testing environments often sit idle outside business hours, yet continue consuming electricity and generating carbon emissions.

KubeGreen addresses this by automatically sleeping workloads during off-hours, enabling:

• 💰 Cost savings of 60-80% on non-production infrastructure
• 🌍 Reduced carbon footprint by stopping unnecessary compute
• ⚡ Lower energy waste without manual intervention
• 📅 Automated scheduling that matches actual usage patterns

By implementing intelligent hibernation, organisations can significantly reduce their environmental impact while cutting cloud costs—a win for both sustainability and the bottom line.

Overview

KubeGreen provides automated resource cleanup and pod hibernation for cost optimisation. It automatically sleeps and wakes workloads on schedules, reducing costs during off-hours.

• Pod Hibernation: Automatically sleep and wake pods on schedule
• Cost Reduction: Reduce costs by turning off non-production workloads
• Scheduled Operations: Define sleep schedules per namespace or workload
• SleepInfo Resources: Manage hibernation via Kubernetes custom resources
• Multi-environment Support: Configure different schedules for dev, test, prod

Quick Start

module "kubegreen" {
  source = "fabiocicerchia/kubegreen/helm"

  release_name    = "kube-green"
  namespace       = "kube-green"
}

Inputs

Name	Description	Type	Default	Required
release_name	Helm release name for KubeGreen	string	"kube-green"	no
namespace	Kubernetes namespace for KubeGreen	string	"kube-green"	no
chart_version	Helm chart version (empty string for latest)	string	""	no
values	Helm values for KubeGreen deployment	any	{}	no

Outputs

Name	Description
namespace	Kubernetes namespace where KubeGreen is deployed
release_name	Helm release name of KubeGreen
chart_version	Chart version of KubeGreen deployment

Requirements

• Terraform >= 1.0 or OpenTofu >= 1.6
• Helm >= 2.0
• Kubernetes v1.24+
• kubectl configured to access your cluster

Usage

Basic Deployment

module "kubegreen" {
  source = "fabiocicerchia/kubegreen/helm"
}

With Custom Configuration

module "kubegreen" {
  source = "fabiocicerchia/kubegreen/helm"

  values = {
    kubeGreen = {
      timezone = "UTC"
    }
  }
}

Pin Chart Version

module "kubegreen" {
  source = "fabiocicerchia/kubegreen/helm"

  chart_version   = "0.8.0"
}

Configure Hibernation

Create SleepInfo resources to define hibernation schedules:

kubectl apply -f - <<EOF
apiVersion: kube-green.com/v1alpha1
kind: SleepInfo
metadata:
  name: dev-sleep
  namespace: development
spec:
  schedule: "0 22 * * *"  # 10 PM daily
  wakeup: "0 8 * * *"     # 8 AM daily
  weekdays:
    - MON
    - TUE
    - WED
    - THU
    - FRI
EOF

Verify Deployment

# Check KubeGreen pod
kubectl get pods -n kube-green

# View SleepInfos
kubectl get sleepinfos -A

# Check KubeGreen logs
kubectl logs -n kube-green -l app.kubernetes.io/name=kube-green

Resources

• KubeGreen GitHub
• KubeGreen Documentation
• KubeGreen CRD Reference

License

MIT