KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

version-checker

★ 777 Open GitHub ↗

Kubernetes utility for exposing image versions in use, compared to latest available upstream, as metrics.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# version-checker

![GitHub Release](https://img.shields.io/github/v/release/jetstack/version-checker)
[![Go Report Card](https://goreportcard.com/badge/github.com/jetstack/version-checker)](https://goreportcard.com/report/github.com/jetstack/version-checker)
[![Tests](https://github.com/jetstack/version-checker/actions/workflows/build-test.yaml/badge.svg)](https://github.com/jetstack/version-checker/actions/workflows/build-test.yaml?query=branch%3Amain)
![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/jetstack/version-checker)

version-checker is a Kubernetes utility for observing the current versions of
images running in the cluster, as well as the latest available upstream. Additionally,
it monitors the Kubernetes cluster version against the latest available releases
using official Kubernetes release channels. These checks get exposed as Prometheus
metrics to be viewed on a dashboard, or _soft_ alert cluster operators.

## Features

- **Container Image Version Checking**: Monitor and compare container image versions running in the cluster against their latest upstream versions
- **Kubernetes Version Monitoring**: Track your cluster's Kubernetes version against the latest available releases from official Kubernetes channels
- **Prometheus Metrics Integration**: Export all version information as Prometheus metrics for monitoring and alerting
- **Flexible Channel Selection**: Configure which Kubernetes release channel to track (stable, latest, etc.)

---

## Why Use version-checker?

- **Improved Security**: Ensures images and Kubernetes clusters are up-to-date, reducing the risk of using vulnerable or compromised versions.
- **Enhanced Visibility**: Provides a clear overview of all running container versions and cluster versions across clusters.
- **Operational Efficiency**: Automates image and Kubernetes version tracking and reduces manual intervention in version management.
- **Compliance and Policy Enforcement**: Helps maintain version consistency and adherence to organizational policies for both applications and infrastructure.
- **Incremental Upgrades**: Facilitates frequent, incremental updates to reduce the risk of large, disruptive upgrades.
- **Add-On Compatibility**: Ensures compatibility with the latest versions of Kubernetes add-ons and dependencies.
- **Proactive Cluster Management**: Stay informed about Kubernetes security updates and new features through automated version monitoring.

---

## Registries Supported

version-checker supports the following registries:

- [ACR](https://azure.microsoft.com/en-us/services/container-registry/)
- [Docker Hub](https://hub.docker.com/)
- [ECR](https://aws.amazon.com/ecr/)
- [GCR](https://cloud.google.com/container-registry/) (inc gcr facades such as k8s.gcr.io)
- [Quay](https://quay.io/)
- Self Hosted (Docker V2 API compliant registries, e.g.
  [registry](https://hub.docker.com/_/registry),
  [artifactory](https://jfrog.com/artifactory/) etc.). Multiple self hosted
  registries can be configured at once.

These registries support authentication.

---

## Documentation

- [Installation Guide](docs/installation.md)
- [Metrics](docs/metrics.md)
- [New Features](docs/new_features.md)

---

### Grafana Dashboard

A [grafana dashboard](https://grafana.com/grafana/dashboards/12833) is also
available to view the image versions as a table.

![](https://raw.githubusercontent.com/jetstack/version-checker/main/img/grafana.jpg)
<center></center>

 Grafana Dashboard

## Known configurations

From time to time, version-checker may need some of the above options applied to determine the latest version,
depending on how the maintainers publish their images. We are making a conscious effort to collate some of these configurations.

See [known-configurations.md](./known-configurations.md) for more details.

version-checker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README