Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/replicatedhq/outdated
Kubectl plugin to find and report outdated images running in a Kubernetes cluster
https://github.com/replicatedhq/outdated
kubectl kubectl-plugins kubernetes
Last synced: 3 days ago
JSON representation
Kubectl plugin to find and report outdated images running in a Kubernetes cluster
- Host: GitHub
- URL: https://github.com/replicatedhq/outdated
- Owner: replicatedhq
- License: apache-2.0
- Created: 2019-08-02T15:24:10.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-07-31T14:07:14.000Z (over 1 year ago)
- Last Synced: 2024-04-13T22:20:33.525Z (7 months ago)
- Topics: kubectl, kubectl-plugins, kubernetes
- Language: Go
- Homepage: https://outdated.sh
- Size: 200 KB
- Stars: 418
- Watchers: 10
- Forks: 23
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-kubectl-plugins - outdated
- awesome-repositories - replicatedhq/outdated - Kubectl plugin to find and report outdated images running in a Kubernetes cluster (Go)
README
# `kubectl outdated`
`kubectl` `outdated` is a `kubectl` plugin that displays all out-of-date images running in a Kubernetes cluster.
## How it Works
The plugin will iterate through readable namespaces, and look for pods. For every pod it can read, the plugin will read the `podspec` for the container images, and any `init` container images. Additionally, it collects the content sha of the image, so that it can be used to disambiguate between different versions pushed with the same tag.
After collecting a list of images running and deduplicating this list, the plugin will anonymously connect to all required image repositories and request a list of tags. For tags and images that follow strict [semver](https://semver.org/) naming, the list is simply sorted and the plugin reports how out of date the running image is.
For images that aren't [semver](https://semver.org/) named, the plugin starts to collect tags dates from the manifest and sorts to find any tag that was pushed after the tag that is running.
## Quickstart
### Prerequisites
Note: You will need [git](https://git-scm.com/downloads) to install the `krew` plugin.
the `outdated` plugin is installed using the `krew` plugin manager for Kubernetes CLI. Installation instructions for `krew` can be found [here](https://krew.sigs.k8s.io/docs/user-guide/setup/install/).
### Installation
After installing & configuring the k8s `krew` plugin, install `outdated` using the following command:
````
$ kubectl krew install outdated
````
### Usage
[](https://asciinema.org/a/ESRC5ubIylWMSQgyi015j04oa)
The plugin will scan for all pods in all namespaces that you have at least read access to. It will then connect to the registry that hosts the image, and (if there's permission), it will analyze your tag to the list of current tags.
Scan all available images in your current `kubecontext` with the command:
````
kubectl outdated
````
The output is a list of all images, with the most out-of-date images in red, slightly outdated in yellow, and up-to-date in green.
### Contributing to `outdated`
Find a bug? Want to add a new feature? Want to write docs? Send a [pull request](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests) & we'll review it!