109 lines
5.6 KiB
Markdown
109 lines
5.6 KiB
Markdown
|
|
<p align="center">
|
|
<img src="./logo/logo-small.png" height="256" width="256" alt="cert-manager project logo" />
|
|
</p>
|
|
<!-- note that the cert-manager logo in this repo is referred to in other README files in the cert-manager org
|
|
as well as in Helm charts, etc.
|
|
if you change its location or name, you'll need to update several other repos too! -->
|
|
|
|
<p align="center"><a href="https://prow.build-infra.jetstack.net/?job=ci-cert-manager-bazel">
|
|
<!-- prow build badge, godoc, and go report card-->
|
|
<img alt="Build Status" src="https://prow.build-infra.jetstack.net/badge.svg?jobs=ci-cert-manager-bazel">
|
|
</a>
|
|
<a href="https://godoc.org/github.com/cert-manager/cert-manager"><img src="https://godoc.org/github.com/cert-manager/cert-manager?status.svg"></a>
|
|
<a href="https://goreportcard.com/report/github.com/cert-manager/cert-manager"><img alt="Go Report Card" src="https://goreportcard.com/badge/github.com/cert-manager/cert-manager" /></a>
|
|
<br />
|
|
<a href="https://artifacthub.io/packages/search?repo=cert-manager"><img alt="Artifact Hub" src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/cert-manager" /></a>
|
|
</p>
|
|
|
|
# cert-manager
|
|
|
|
cert-manager adds certificates and certificate issuers as resource types in Kubernetes clusters, and simplifies the process of obtaining, renewing and using those certificates.
|
|
|
|
It can issue certificates from a variety of supported sources, including Let's Encrypt, HashiCorp Vault, and Venafi as well as private PKI, and it ensures certificates remain
|
|
valid and up to date, attempting to renew certificates at an appropriate time before expiry.
|
|
|
|
It is loosely based upon the work of [kube-lego](https://github.com/jetstack/kube-lego)
|
|
and has borrowed some wisdom from other similar projects such as
|
|
[kube-cert-manager](https://github.com/PalmStoneGames/kube-cert-manager).
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
Documentation for cert-manager can be found at [cert-manager.io](https://cert-manager.io/docs/).
|
|
|
|
Issues and PRs for documentation should be filed in the [website repo](https://github.com/cert-manager/website/).
|
|
|
|
For the common use-case of automatically issuing TLS certificates for
|
|
Ingress resources, see the [cert-manager nginx-ingress quick start guide](https://cert-manager.io/docs/tutorials/acme/nginx-ingress/).
|
|
|
|
### Installation
|
|
|
|
We document [installation](https://cert-manager.io/docs/installation/) on the website.
|
|
|
|
## Troubleshooting
|
|
|
|
If you encounter any issues whilst using cert-manager, we have a number of ways to get help:
|
|
|
|
- A [troubleshooting guide](https://cert-manager.io/docs/faq/troubleshooting/) on our website.
|
|
- Our official [Kubernetes Slack channel](https://cert-manager.io/docs/contributing/#slack) - the quickest way to ask!
|
|
- [Searching for an existing issue](https://github.com/cert-manager/cert-manager/issues).
|
|
|
|
If you believe you've found a bug, and cannot find an existing issue, feel free to [open a new issue](https://github.com/cert-manager/cert-manager/issues)!
|
|
Be sure to include as much information as you can about your environment.
|
|
|
|
## Community
|
|
|
|
The `cert-manager-dev` Google Group is used for project wide announcements and development coordination.
|
|
Anybody can join the group by visiting [here](https://groups.google.com/forum/#!forum/cert-manager-dev)
|
|
and clicking "Join Group". A Google account is required to join the group.
|
|
|
|
### Meetings
|
|
|
|
We have several public meetings which any member of our Google Group is more than welcome to join!
|
|
|
|
Check out the details on [our website](https://cert-manager.io/docs/contributing/#meetings). Feel
|
|
free to drop in and ask questions, chat with us or just to say hi!
|
|
|
|
## Contributing
|
|
|
|
We welcome pull requests with open arms! There's a lot of work to do here, and
|
|
we're especially concerned with ensuring the longevity and reliability of the
|
|
project. The [contributing guide](https://cert-manager.io/docs/contributing/)
|
|
will help you get started.
|
|
|
|
## Coding Conventions
|
|
|
|
Code style guidelines are documented on the [coding conventions](https://cert-manager.io/docs/contributing/coding-conventions/) page
|
|
of the cert-manager website. Please try to follow those guidelines if you're submitting a pull request for cert-manager.
|
|
|
|
## Importing cert-manager as a Module
|
|
|
|
⚠️ Please note that cert-manager **does not** currently provide a Go module compatibility guarantee. That means that
|
|
**most code under `pkg/` is subject to change in a breaking way**, even between minor or patch releases and even if
|
|
the code is currently publicly exported.
|
|
|
|
The lack of a Go module compatibility guarantee does not affect API version guarantees
|
|
under the [Kubernetes Deprecation Policy](https://kubernetes.io/docs/reference/using-api/deprecation-policy/).
|
|
|
|
For more details see [Importing cert-manager in Go](https://cert-manager.io/docs/contributing/importing/) on the
|
|
cert-manager website.
|
|
|
|
The import path for cert-manager versions 1.8 and later is `github.com/cert-manager/cert-manager`.
|
|
|
|
For all versions of cert-manager before 1.8, including minor and patch releases, the import path is `github.com/jetstack/cert-manager`.
|
|
|
|
## Security Reporting
|
|
|
|
Security is the number one priority for cert-manager. If you think you've found a security vulnerability, we'd love to hear from you.
|
|
|
|
Follow the instructions in [SECURITY.md](./SECURITY.md) to make a report.
|
|
|
|
## Changelog
|
|
|
|
[Every release](https://github.com/cert-manager/cert-manager/releases) on GitHub has a changelog,
|
|
and we also publish release notes on [the website](https://cert-manager.io/docs/release-notes/).
|
|
|
|
<sub><sup>Logo design by [Zoe Paterson](https://zoepatersonmedia.com)</sup></sub>
|