pvc-autoresizer

pvc-autoresizer

Chainguard's redistribution of the pvc-autoresizer Helm chart, pre-configured with hardened Chainguard Images.

pvc-autoresizer is a Kubernetes controller that automatically resizes PersistentVolumeClaim objects based on volume usage metrics collected from Prometheus or the Kubernetes metrics API.

Prerequisites

Authentication is required to access this chart and its images. First, authenticate with Chainguard and configure your environment:

chainctl auth login
chainctl auth configure-docker --pull-token --save
helm registry login cgr.dev

Create an image pull secret in the namespace where the chart will be installed:

kubectl create namespace pvc-autoresizer

kubectl create secret docker-registry cgr-pull-secret \
  --docker-server=cgr.dev \
  --docker-username="$(echo cgr.dev | docker-credential-cgr get | jq -r '.Username')" \
  --docker-password="$(echo cgr.dev | docker-credential-cgr get | jq -r '.Secret')" \
  --namespace pvc-autoresizer

The chart's PVC mutating webhook requires a TLS certificate. Either install cert-manager in the cluster beforehand (the bundled cert-manager subchart is not included in this redistribution), or let the chart generate a self-signed certificate with --set webhook.certificate.generate=true.

Installation

helm install pvc-autoresizer oci://cgr.dev/ORGANIZATION/charts/pvc-autoresizer \
  --namespace pvc-autoresizer \
  --set image.pullSecrets[0].name=cgr-pull-secret \
  --set controller.args.prometheusURL=http://prometheus.monitoring.svc:9090

To read volume stats from the Kubernetes metrics API instead of Prometheus, set controller.args.useK8sMetricsApi=true.

About This Chart

This is a redistribution of the upstream pvc-autoresizer Helm chart. All upstream configuration options and documentation apply.

For full documentation, see: https://github.com/topolvm/pvc-autoresizer