2020-10-16 23:38:43 +00:00
# Kyverno [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Kubernetes%20Native%20Policy%20Management.%20No%20new%20language%20required%21&url=https://github.com/kyverno/kyverno/&hashtags=kubernetes,devops)
2019-02-04 16:30:38 +00:00
2021-05-08 02:26:57 +00:00
**Kubernetes Native Policy Management 🎉**
2019-05-03 12:10:54 +00:00
2021-11-06 15:08:42 +00:00
![build ](https://github.com/kyverno/kyverno/workflows/build/badge.svg )
2023-01-06 22:42:31 +00:00
![releaser ](https://github.com/kyverno/kyverno/workflows/releaser/badge.svg )
2021-11-06 15:08:42 +00:00
[![Go Report Card ](https://goreportcard.com/badge/github.com/kyverno/kyverno )](https://goreportcard.com/report/github.com/kyverno/kyverno)
2020-10-18 05:41:31 +00:00
![License: Apache-2.0 ](https://img.shields.io/github/license/kyverno/kyverno?color=blue )
[![GitHub Repo stars ](https://img.shields.io/github/stars/kyverno/kyverno )](https://github.com/kyverno/kyverno/stargazers)
2022-02-18 01:47:14 +00:00
[![CII Best Practices ](https://bestpractices.coreinfrastructure.org/projects/5327/badge )](https://bestpractices.coreinfrastructure.org/projects/5327)
2022-10-19 07:27:45 +00:00
[![OpenSSF Scorecard ](https://api.securityscorecards.dev/projects/github.com/kyverno/kyverno/badge )](https://api.securityscorecards.dev/projects/github.com/kyverno/kyverno)
2022-03-14 08:21:27 +00:00
[![codecov ](https://codecov.io/gh/kyverno/kyverno/branch/main/graph/badge.svg )](https://app.codecov.io/gh/kyverno/kyverno/branch/main)
2023-03-05 02:16:26 +00:00
[![Artifact HUB ](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/kyverno )](https://artifacthub.io/packages/search?repo=kyverno)
2022-02-18 01:47:14 +00:00
2020-10-18 05:41:31 +00:00
2021-01-08 02:57:33 +00:00
< a href = "https://kyverno.io" rel = "kyverno.io" > ![logo](img/Kyverno_Horizontal.png)< / a >
2020-09-24 17:52:31 +00:00
2021-05-08 02:26:57 +00:00
< p class = "callout info" style = "font-size: 100%;" >
2020-10-21 08:10:51 +00:00
Kyverno is a policy engine designed for Kubernetes. It can validate, mutate, and generate configurations using admission controls and background scans. Kyverno policies are Kubernetes resources and do not require learning a new language. Kyverno is designed to work nicely with tools you already use like kubectl, kustomize, and Git.
2020-10-16 23:38:43 +00:00
< / p >
2019-05-21 07:10:50 +00:00
2021-11-06 15:08:42 +00:00
## 📙 Documentation
2020-10-21 08:02:56 +00:00
2021-11-06 15:08:42 +00:00
Kyverno installation and reference documents are available at kyverno.io.
2020-07-03 15:40:24 +00:00
2021-11-06 15:08:42 +00:00
👉 ** [Quick Start ](https://kyverno.io/docs/introduction/#quick-start )**
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
👉 ** [Installation ](https://kyverno.io/docs/installation/ )**
2020-07-03 15:40:24 +00:00
2021-11-06 15:08:42 +00:00
👉 ** [Sample Policies ](https://kyverno.io/policies/ )**
2020-07-03 15:40:24 +00:00
2021-05-08 02:26:57 +00:00
## 🙋♂️ Getting Help
2020-07-03 15:40:24 +00:00
2021-11-06 15:08:42 +00:00
We are here to help!
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
👉 For feature requests and bugs, file an [issue ](https://github.com/kyverno/kyverno/issues ).
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
👉 For discussions or questions, join the [Kyverno Slack channel ](https://slack.k8s.io/#kyverno ).
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
👉 For community meeting access, join the [mailing list ](https://groups.google.com/g/kyverno ).
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
👉 To get updates ⭐️ [star this repository ](https://github.com/kyverno/kyverno/stargazers ).
2021-05-27 19:29:53 +00:00
## ➕ Contributing
Thanks for your interest in contributing to Kyverno! Here are some steps to help get you started:
2021-11-06 15:08:42 +00:00
✔ Read and agree to the [Contribution Guidelines ](/CONTRIBUTING.md ).
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
✔ Browse through the [GitHub discussions ](https://github.com/kyverno/kyverno/discussions ).
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
✔ Read Kyverno design and development details on the [GitHub Wiki ](https://github.com/kyverno/kyverno/wiki ).
2021-05-27 19:29:53 +00:00
2021-11-06 15:08:42 +00:00
✔ Check out the [good first issues ](https://github.com/kyverno/kyverno/labels/good%20first%20issue ) list. Add a comment with `/assign` to request assignment of the issue.
2020-05-28 18:22:47 +00:00
2021-12-18 20:03:16 +00:00
✔ Check out the Kyverno [Community page ](https://kyverno.io/community/ ) for other ways to get involved.
2021-03-11 06:49:12 +00:00
2023-03-05 02:46:48 +00:00
## Software Bill of Materials
All Kyverno images include a Software Bill of Materials (SBOM) in [CycloneDX ](https://cyclonedx.org/ ) JSON format. SBOMs for Kyverno images are stored in a separate repository at `ghcr.io/kyverno/sbom` . More information on this is available at [Fetching the SBOM for Kyverno ](https://kyverno.io/docs/security/#fetching-the-sbom-for-kyverno ).
2021-10-10 21:03:04 +00:00
## Contributors
Kyverno is built and maintained by our growing community of contributors!
< a href = "https://github.com/kyverno/kyverno/graphs/contributors" >
< img src = "https://contrib.rocks/image?repo=kyverno/kyverno" / >
< / a >
Made with [contributors-img ](https://contrib.rocks ).