Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/slok/kahoy
Simple Kubernetes raw manifests deployment tool
https://github.com/slok/kahoy
ci continuous-integration deploy deployment k8s kubectl kubernetes kubernetes-deployment manifests ship yaml
Last synced: about 2 months ago
JSON representation
Simple Kubernetes raw manifests deployment tool
- Host: GitHub
- URL: https://github.com/slok/kahoy
- Owner: slok
- License: apache-2.0
- Created: 2020-08-03T18:21:25.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T19:01:14.000Z (almost 2 years ago)
- Last Synced: 2024-06-19T01:57:17.459Z (6 months ago)
- Topics: ci, continuous-integration, deploy, deployment, k8s, kubectl, kubernetes, kubernetes-deployment, manifests, ship, yaml
- Language: Go
- Homepage: https://docs.kahoy.dev/
- Size: 4.04 MB
- Stars: 34
- Watchers: 4
- Forks: 4
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Kahoy - easy and reliable Kubernetes manifest deployments
> When [Kubectl] is too simple and available deployment solutions too complex.
- [Docs]
- [Releases]
- [Docker images][docker-images]
## Main features
- Simple, flexible, and lightweight. A **single CLI**.
- Deploy **any kind** of Kubernetes resource (core resources, CRDs...).
- Reliable **Garbage collection**.
- **Adapts** to any type of Kubernetes **manifest structure** (a single YAML, few manifests, big manifest repository...).
- Use to deploy as individual releases/services (**Helm style**) or group of manifest repository (**Flux style**).
- **Gitops** ready (apply only changed resources, diff, dry-run...).
- Multiple resource **filtering options** (file paths, resource namespace, types...).
- **Reports** of what applies and deletes (useful to combine with other apps, e.g: wait, checks, notifications…).
## Getting started
Check [concepts docs][concepts-docs] and start deploying any kind of Kubernetes resources:
```bash
# Dry run.
$ kahoy apply --dry-run --kube-provider-id "ci" -n "./manifests"
# Diff changes.
$ kahoy apply --diff --kube-provider-id "ci" -n "./manifests"
# Deploy.
$ kahoy apply --kube-provider-id "ci" -n "./manifests"
```
Get more information on the [docs] website.
## Contributing
Check [CONTRIBUTING.md](CONTRIBUTING.md) file.
[kubectl]: https://kubernetes.io/docs/reference/kubectl/overview/
[concepts-docs]: https://docs.kahoy.dev/topics/concepts/
[docs]: http://docs.kahoy.dev
[releases]: https://github.com/slok/kahoy/releases
[docker-images]: https://hub.docker.com/r/slok/kahoy