Published August 12, 2026 | Version v1

Custom Self-Adapter

Authors/Creators

Description

Custom Self-Adapter (CSA) is a framework for implementing Kubernetes adaptation policies with user-provided logic. A CSA observes a workload and its metrics, evaluates the current state, selects an adaptation strategy, and runs that strategy inside the cluster. The metric, evaluation, and adaptation logic can be written in any language available in the CSA image.

Unlike the Horizontal Pod Autoscaler, a CSA is not limited to the standard replica calculation. Unlike a Custom Pod Autoscaler, it is not limited to changing the replica count. An adaptation script can perform horizontal or vertical scaling, change an image or configuration, or update any other Kubernetes resource allowed by its ServiceAccount.

The project is split into three repositories:

  • custom-self-adapter (this repository) contains the Go runtime and the base container images used to run user logic.
  • custom-self-adapter-operator installs the CustomSelfAdapter API and manages CSA Pods and their RBAC resources.
  • k8s-autoscaling-lab provides a reproducible environment for comparing CSA with HPA, VPA, and other autoscaling approaches.

Files

custom-self-adapter-1.0.0.zip

Files (250.9 MB)

Name Size
md5:d4f80674370c964f2a8fbb71d9cd1b53
52.9 kB Preview Download
md5:e4130460bcd4c24e5641b3b5cb4bf8b5
326.4 kB Preview Download
md5:85f24fd3cf4f636722068304d7bfcef4
250.5 MB Preview Download