4 releases (breaking)
0.4.0 | Jan 4, 2024 |
---|---|
0.3.0 | May 9, 2022 |
0.2.0 | May 8, 2022 |
0.1.0 | May 7, 2022 |
#1684 in Command line utilities
1.5MB
3K
SLoC
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.
Screenshot
Demo
https://user-images.githubusercontent.com/98980/167365691-808bcd91-cb8b-4597-b5bd-57f544c2bc5e.mov
Installation
Binaries
Go to the release page and grab the archive or package targeting your platform.
Homebrew
brew tap chmouel/tkn-watch https://github.com/chmouel/tkn-watch
brew install tkn-watch
Crates.io
cargo install tkn-watch
Arch
With your favourite aurhelper for example yay :
yay -S tkn-watch-bin
Docker
docker run -i ghcr.io/chmouel/tkn-watch # don't forget to bind your kubeconfig
Usage
% 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, auto-selecting one if there is only one running.
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.
If you don't want a fancy output and just have it reporting quietly success or failure then you can use the -q
/--quiet
flag for this.
tkn watch
exit with the pipelinerun status, so you can do fancy things like (on macOS):
tkn watch -lq || osascript -e 'display notification "PipelineRun Has Failed :("' && osascript -e 'display notification "PipelineRun Has Succeeded, time to commit again :)"'
If you use pipelines-as-code it will detect the headers and show which event and sha this PR targets.
Copyright
Authors
Chmouel Boudjnah <@chmouel>
Dependencies
~72MB
~1M SLoC