cert-manager

module
v1.9.2-beta.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 15, 2022 License: Apache-2.0

README

cert-manager project logo

Build Status Go Report Card
Artifact Hub

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 and has borrowed some wisdom from other similar projects such as kube-cert-manager.

cert-manager high level overview diagram

Documentation

Documentation for cert-manager can be found at cert-manager.io.

Issues and PRs for documentation should be filed in the website repo.

For the common use-case of automatically issuing TLS certificates for Ingress resources, see the cert-manager nginx-ingress quick start guide.

Installation

We document installation on the website.

Troubleshooting

If you encounter any issues whilst using cert-manager, we have a number of ways to get help:

If you believe you've found a bug, and cannot find an existing issue, feel free to open a new issue! 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 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. 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 will help you get started.

Coding Conventions

Code style guidelines are documented on the 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.

For more details see Importing cert-manager in Go 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 to make a report.

Changelog

Every release on GitHub has a changelog, and we also publish release notes on the website.

Logo design by Zoe Paterson

Directories

Path Synopsis
cmd
ctl
devel
hack
internal
apis/acme
Package acme is the internal version of the API.
Package acme is the internal version of the API.
apis/acme/install
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
apis/acme/v1
+groupName=acme.cert-manager.io
+groupName=acme.cert-manager.io
apis/acme/v1alpha2
+groupName=acme.cert-manager.io
+groupName=acme.cert-manager.io
apis/acme/v1alpha3
+groupName=acme.cert-manager.io
+groupName=acme.cert-manager.io
apis/acme/v1beta1
+groupName=acme.cert-manager.io
+groupName=acme.cert-manager.io
apis/certmanager
Package certmanager is the internal version of the API.
Package certmanager is the internal version of the API.
apis/certmanager/install
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
apis/certmanager/v1
+groupName=cert-manager.io
+groupName=cert-manager.io
apis/certmanager/v1alpha2
+groupName=cert-manager.io
+groupName=cert-manager.io
apis/certmanager/v1alpha3
+groupName=cert-manager.io
+groupName=cert-manager.io
apis/certmanager/v1beta1
+groupName=cert-manager.io
+groupName=cert-manager.io
apis/config/webhook
Package webhook is the internal version of the webhook config API.
Package webhook is the internal version of the webhook config API.
apis/config/webhook/install
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
apis/config/webhook/v1alpha1
+groupName=webhook.config.cert-manager.io
+groupName=webhook.config.cert-manager.io
apis/meta
Package meta is the internal version of the API.
Package meta is the internal version of the API.
apis/meta/install
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
Package install installs the API group, making it available as an option to all of the API encoding/decoding machinery.
apis/meta/v1
+groupName=meta.cert-manager.io
+groupName=meta.cert-manager.io
controller/certificates/policies
Package policies provides functionality to evaluate Certificate's state
Package policies provides functionality to evaluate Certificate's state
vault/fake
Package fake contains a fake Vault signer for use in tests
Package fake contains a fake Vault signer for use in tests
make
pkg
acme/webhook
Package webhook provides a library that can be used to build external ACME solver webhooks.
Package webhook provides a library that can be used to build external ACME solver webhooks.
acme/webhook/apis/acme
Package acme contains type definitions for ACME ChallengePayload resources
Package acme contains type definitions for ACME ChallengePayload resources
acme/webhook/apis/acme/v1alpha1
Package v1alpha1 is the v1alpha1 version of the API.
Package v1alpha1 is the v1alpha1 version of the API.
api
apis/acme
Package acme contains types in the acme cert-manager API group
Package acme contains types in the acme cert-manager API group
apis/acme/v1
Package v1 is the v1 version of the API.
Package v1 is the v1 version of the API.
apis/certmanager
Package certmanager is the internal version of the API.
Package certmanager is the internal version of the API.
apis/certmanager/v1
Package v1 is the v1 version of the API.
Package v1 is the v1 version of the API.
apis/config/webhook
Package webhook contains types used to configure the webhook
Package webhook contains types used to configure the webhook
apis/config/webhook/v1alpha1
Package v1alpha1 is the v1alpha1 version of the webhook config API.
Package v1alpha1 is the v1alpha1 version of the webhook config API.
apis/experimental
Package experimental contains the group containing experimental APIs.
Package experimental contains the group containing experimental APIs.
apis/meta
Package meta contains meta types for cert-manager APIs
Package meta contains meta types for cert-manager APIs
apis/meta/v1
Package v1 contains meta types for cert-manager APIs +k8s:deepcopy-gen=package +gencrdrefdocs:force +groupName=meta.cert-manager.io
Package v1 contains meta types for cert-manager APIs +k8s:deepcopy-gen=package +gencrdrefdocs:force +groupName=meta.cert-manager.io
client/clientset/versioned
This package has the automatically generated clientset.
This package has the automatically generated clientset.
client/clientset/versioned/fake
This package has the automatically generated fake clientset.
This package has the automatically generated fake clientset.
client/clientset/versioned/scheme
This package contains the scheme of the automatically generated clientset.
This package contains the scheme of the automatically generated clientset.
client/clientset/versioned/typed/acme/v1
This package has the automatically generated typed clients.
This package has the automatically generated typed clients.
client/clientset/versioned/typed/acme/v1/fake
Package fake has the automatically generated clients.
Package fake has the automatically generated clients.
client/clientset/versioned/typed/certmanager/v1
This package has the automatically generated typed clients.
This package has the automatically generated typed clients.
client/clientset/versioned/typed/certmanager/v1/fake
Package fake has the automatically generated clients.
Package fake has the automatically generated clients.
controller/test
Package test contains testing utilities used for constructing fake Contexts which can be used during tests.
Package test contains testing utilities used for constructing fake Contexts which can be used during tests.
ctl
issuer/acme/dns/acmedns
Package acmedns implements a DNS provider for solving DNS-01 challenges using Joohoi's acme-dns project.
Package acmedns implements a DNS provider for solving DNS-01 challenges using Joohoi's acme-dns project.
issuer/acme/dns/akamai
Package akamai implements a DNS provider for solving the DNS-01 challenge using Akamai Edge DNS.
Package akamai implements a DNS provider for solving the DNS-01 challenge using Akamai Edge DNS.
issuer/acme/dns/azuredns
Package azuredns implements a DNS provider for solving the DNS-01 challenge using Azure DNS.
Package azuredns implements a DNS provider for solving the DNS-01 challenge using Azure DNS.
issuer/acme/dns/clouddns
Package clouddns implements a DNS provider for solving the DNS-01 challenge using Google Cloud DNS.
Package clouddns implements a DNS provider for solving the DNS-01 challenge using Google Cloud DNS.
issuer/acme/dns/cloudflare
Package cloudflare implements a DNS provider for solving the DNS-01 challenge using cloudflare DNS.
Package cloudflare implements a DNS provider for solving the DNS-01 challenge using cloudflare DNS.
issuer/acme/dns/digitalocean
Package digitalocean implements a DNS provider for solving the DNS-01 challenge using digitalocean DNS.
Package digitalocean implements a DNS provider for solving the DNS-01 challenge using digitalocean DNS.
issuer/acme/dns/route53
Package route53 implements a DNS provider for solving the DNS-01 challenge using AWS Route 53 DNS.
Package route53 implements a DNS provider for solving the DNS-01 challenge using AWS Route 53 DNS.
metrics
Package metrics contains global structures related to metrics collection cert-manager exposes the following metrics: certificate_expiration_timestamp_seconds{name, namespace} certificate_renewal_timestamp_seconds{name, namespace} certificate_ready_status{name, namespace, condition} acme_client_request_count{"scheme", "host", "path", "method", "status"} acme_client_request_duration_seconds{"scheme", "host", "path", "method", "status"} venafi_client_request_duration_seconds{"scheme", "host", "path", "method", "status"} controller_sync_call_count{"controller"}
Package metrics contains global structures related to metrics collection cert-manager exposes the following metrics: certificate_expiration_timestamp_seconds{name, namespace} certificate_renewal_timestamp_seconds{name, namespace} certificate_ready_status{name, namespace, condition} acme_client_request_count{"scheme", "host", "path", "method", "status"} acme_client_request_duration_seconds{"scheme", "host", "path", "method", "status"} venafi_client_request_duration_seconds{"scheme", "host", "path", "method", "status"} controller_sync_call_count{"controller"}
test
e2e
e2e/framework/addon/base
Package base implements a basis for plugins that need to use the Kubernetes API to build upon.
Package base implements a basis for plugins that need to use the Kubernetes API to build upon.
e2e/framework/addon/vault
package vault contains an addon that installs Vault
package vault contains an addon that installs Vault
e2e/framework/addon/venafi
Package venafi implements an addon for the Venafi platform.
Package venafi implements an addon for the Venafi platform.
e2e/framework/util/errors
Package errors contains shared error types that tests and addons can depend upon to communicate information about why something has failed
Package errors contains shared error types that tests and addons can depend upon to communicate information about why something has failed
e2e/suite/issuers/acme/dnsproviders
Package dnsproviders contains addons that create DNS provider credentials in the target test environment.
Package dnsproviders contains addons that create DNS provider credentials in the target test environment.
e2e/suite/issuers/venafi/tpp
Package tpp implements tests for the Venafi TPP issuer
Package tpp implements tests for the Venafi TPP issuer
unit/coreclients
coreclients contains fakes for some of the types from k8s.io/client-go/kubernetes/typed/core/v1
coreclients contains fakes for some of the types from k8s.io/client-go/kubernetes/typed/core/v1
unit/gen
package gen implements helper functions to construct API resource test fixtures.
package gen implements helper functions to construct API resource test fixtures.
tools

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL