From 4f4027c4c0ee4cc1edf4c01b51ef5d46a1c8f92a Mon Sep 17 00:00:00 2001 From: Dinar Valeev Date: Tue, 23 Dec 2025 23:01:45 +0100 Subject: [PATCH] venafi: Issuer custom fields documentation Document Venafi "global" custom fields feature implemented in https://github.com/cert-manager/cert-manager/pull/8301 Signed-off-by: Dinar Valeev Co-authored-by: Peter Fiddes --- content/docs/configuration/venafi.md | 42 ++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/content/docs/configuration/venafi.md b/content/docs/configuration/venafi.md index 50bb7a9efeb..7f683418902 100644 --- a/content/docs/configuration/venafi.md +++ b/content/docs/configuration/venafi.md @@ -304,3 +304,45 @@ metadata: ] ... ``` + +### Issuer Custom Fields + +Starting `v1.20`, you can use `venafi.cert-manager.io/custom-fields` annotation on an `Issuer` or `ClusterIssuer` resource. +This configuration would be applied to all Certificate requests created from `Issuer`. + +It is possible to override or append custom configuration to `Certificate` resources via the `Issuer` assigned to it. +For example with an `Issuer` such as: + +```yaml +apiVersion: cert-manager.io/v1 +kind: Issuer +metadata: + name: corp-issuer + annotations: + venafi.cert-manager.io/custom-fields: |- + [ + {"name": "Environemnt", "value": "Dev"}, + ] +``` + +and a `Certificate` resource: + +```yaml +apiVersion: cert-manager.io/v1 +kind: Certificate +metadata: + name: example-com-certificate + annotations: + venafi.cert-manager.io/custom-fields: |- + [ + {"name": "Team", "value": "amber"}, + ] +... +``` + +Final configuration will be: + +```json +{"name": "Environemnt", "value": "Dev"}, +{"name": "Team", "value": "amber"} +```