codecov Version AUR CICD pre-commit

tkn-watch - watch a PipelineRuns on its way to success or failures

tkn-watch is a simple extension to the tkn command line tool that watches a PipelineRuns and exit with the PipelineRun status.

It mimics the behaviour of GitHub cli run watch command.

Screencast

https://user-images.githubusercontent.com/98980/167255324-d1c16973-df5f-473a-9285-2b7422840dd8.mov

Installation

Binaries

* there is some issues with the binary generated for m1 macOS, your best bet is to use the cargo method *

Go to the release page and grab the archive or package targeting your platform.

Homebrew

shell brew tap chmouel/tkn-watch https://github.com/chmouel/tkn-watch brew install tkn-watch

Crates.io

shell cargo install tkn-watch

Arch

With your favourite aurhelper for example yay :

shell yay -S tkn-watch-bin

Docker

shell docker run -i ghcr.io/chmouel/tkn-watch # don't forget to bind your kubeconfig

Usage

shell % tkn watch <pipelinerun-name>

If you don't have tkn cli installed you can call the plug-in directly with tkn-watch

If you don't specify a PipelineRun it will ask you nicely for a running Pipelinerun to watch.

When you give the flag -l/--last tkn-watch will use the last PipelineRun started.

You can use the flag -n to specify another namespace than the current one.

You can adjust the time to wait between checks with the flag -r/--refresh-seconds, the default is 3 seconds.

tkn watch exit with the pipelinerun status, so you can do fancy things like (on macOS):

shell tkn watch -l || osascript -e 'display notification "PipelineRun Has Failed :("' && osascript -e 'display notification "PipelineRun Has Succeeded, time to commit again :)"'

Copyright

Apache-2.0

Authors

Chmouel Boudjnah <@chmouel>