https://github.com/alex-karpenko/git-events-runner
K8s operator to run jobs on git repo changes.
https://github.com/alex-karpenko/git-events-runner
git job kubernetes operator trigger
Last synced: 2 months ago
JSON representation
K8s operator to run jobs on git repo changes.
- Host: GitHub
- URL: https://github.com/alex-karpenko/git-events-runner
- Owner: alex-karpenko
- License: mit
- Created: 2024-03-06T19:19:12.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-27T11:21:13.000Z (3 months ago)
- Last Synced: 2026-03-27T22:31:06.512Z (3 months ago)
- Topics: git, job, kubernetes, operator, trigger
- Language: Rust
- Homepage: https://alex-karpenko.github.io/git-events-runner/
- Size: 2.58 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# Git Events Runner
**Git Events Runner** is a Kubernetes operator to trigger `Jobs` with the Git repository content in the job's container.
In other words it provides way to run code inside a Kubernetes cluster based on content of the Git repository commit
in response to changes in the repository or triggered by a webhook.
For details, please refer to the [documentation](https://alex-karpenko.github.io/git-events-runner/).
## What's inside
`Git Events Runner` provides several custom resources (CRDs) to define such entities as:
* `Sources` - URI and auth parameters of git repositories which should be watching and using to run `Actions`.
* `Triggers` - conditions and restrictions of changes in `Sources` which triggers `Actions`: which repos, branches or
tags to watch and how often.
It includes scheduled and webhook triggers.
* `Actions` - predefined configurations of K8s `Job` to run as reaction to fired `Trigger`.
Everything is glued by dedicated Kubernetes controller inside a cluster.
## Where it applies
* Various Continues Deployment (CD) processes, where Kubernetes resources are involved.
* Running periodic tasks in Kubernetes, based on code in Git repo.
* Triggering tasks in Kubernetes by webhooks, based on code in Git repo.
* Replacement of CI/CD functionality, provided by repository vendor (GitHub actions, for example)
where direct access to Kubernetes or cloud resources is needed but with guarantied permissions restrictions.
## Current state
This is a working beta, and it's under active development now.
## License
This project is licensed under the [MIT license](LICENSE).