Cert-manager: No matches for kind ClusterIssuer in version cert-manager.io/v1alpha3

[yvanavermaet]

Describe the bug:
ClusterIssuer is not found in version cert-manager.io/v1alpha3.

I've installed cert-manager via Helm: https://hub.helm.sh/charts/jetstack/cert-manager

I'm able to create a ClusterIssuer with version "v1alpha2", but when I update it to "v1alpha3" I get the error that it's not found in that version.

On the Installation page on cert-manager itself, it says to apply https://github.com/jetstack/cert-manager/releases/download/v0.13.1/cert-manager.yaml , but I don't see any reference to v1alpha3 in there either. I have not applied this file.

Expected behaviour:
According to the docs, since cert-manager v0.13 v1alpha3 is available, so I expect to be able to create a ClusterIssuer with that apiVersion (cert-manager.io/v1alpha3)

Steps to reproduce the bug:

• Install cert-manager v0.13.1 (with Helm, if that makes a difference)
• Create a ClusterIssuer with apiVersion cert-manager.io/v1alpha3

Anything else we need to know?: /

Environment details::

• Kubernetes version (e.g. v1.10.2): v1.15.9-gke.8
• Cloud-provider/provisioner (e.g. GKE, kops AWS, etc): GKE
• cert-manager version (e.g. v0.4.0): v0.13.1
• Install method (e.g. helm or static manifests): helm

/kind bug

[munnerz]

According to the docs, since cert-manager v0.13 v1alpha3 is available, so I expect to be able to create a ClusterIssuer with that apiVersion (cert-manager.io/v1alpha3)

v1alpha3 is NOT available in v0.13, hence the problem you're seeing. It will be available from v0.14 onwards 😄

[yvanavermaet]

@munnerz Oh... is it safe to assume that the api docs are incorrect then? https://cert-manager.io/docs/reference/api-docs/ clearly mentions v1alpha3 at the top.

[munnerz]

Oh... is it safe to assume that the api docs are incorrect then?

Yeah it seems like our docs generation has got a bit over eager and generated docs for _all the things_ - the API version is not made available in your cluster however, and the CRDs are not configured for it.

We need to find a way to exclude certain apiversions with gen-crd-api-reference-docs somehow.. https://github.com/cert-manager/website/blob/691865544d276745155734bafac59e09f290c1d2/scripts/gendocs/generate#L64-L69

[munnerz]

The v0.14 alphas are now available which _do_ include v1alpha3 - if you can give that a go (as it also makes use of the new conversion webhook) that'd be great 😄 the 'final' release will be available later today 🎉