diff --git a/charts/enterprise/clusterissuer/docs/how-to.md b/charts/enterprise/clusterissuer/docs/how-to.md index 97e1b35111c..40c3395f9b3 100644 --- a/charts/enterprise/clusterissuer/docs/how-to.md +++ b/charts/enterprise/clusterissuer/docs/how-to.md @@ -1,6 +1,6 @@ -# Cert-Manager Setup Guide +# clusterissuer Setup Guide -This guide will walk you through setting up `cert-manager`, certificate management for Kubernetes. +This guide will walk you through setting up `clusterissuer`, certificate management for Kubernetes. ## Prerequisites @@ -8,11 +8,11 @@ Ensure you have the `enterprise` train enabled for `TrueCharts` as discussed [he Ensure you have traefik installed, required for Ingress. -Search for cert-manager in the `Apps` menu | `Available Applications` tab and click **Install**. +Search for clusterissuer in the `Apps` menu | `Available Applications` tab and click **Install**. ## Cloudflare DNS-Provider -You can setup multiple domains with a single cert-manager app, all you have to do is either add the global API key (**not recommended**) or `Add` multiple `ACME Issuer` entries for each domain and create an API token for each at [Cloudflare API Tokens](https://dash.cloudflare.com/profile/api-tokens). +You can setup multiple domains with a single `clusterissuer` app, all you have to do is either add the global API key (**not recommended**) or `Add` multiple `ACME Issuer` entries for each domain and create an API token for each at [Cloudflare API Tokens](https://dash.cloudflare.com/profile/api-tokens). - Give the certificate a name (eg domain or "maincert", etc). - Select the correct provider, for example `Cloudflare`. @@ -21,34 +21,39 @@ You can setup multiple domains with a single cert-manager app, all you have to d - Optionally set Cloudflare API key (**not recommended**) - Set the Cloudflare API Token to the one created earlier. -![cert-manager1](img/cert-manager1.png) +![clusterissuer edit dialog](img/clusterissuer1.png) -## cert-manager App +## clusterissuer App -> **Note** -> -> It is normal that the app does not run, there are no events, no logs and no shell. This is by design. +:::note -![cert-manager3](img/cert-manager3.png) +It is by design that the app does not run, there are no events, no logs and no shell. -## How to Add Ingress to Apps with cert-manager +::: -Here's an example on how to add ingress to an app with cert-manager for a single domain only. +![clusterissuer app card](img/clusterissuer2.png) + +## How to Add Ingress to Apps with clusterissuer + +Here's an example on how to add ingress to an app with clusterissuer for a single domain only. Add the name of the `ACME Issuer` into `Cert-Manager clusterIssuer` -> **Warning** -> Do **NOT** use this combined with the `TLS-Settings`. +:::warning -![cert-manager2](img/cert-manager2.png) +Do **NOT** use this combined with the `TLS-Settings`. + +::: + +![how to add ingress using clusterissuer ](img/clusterissuer3.png) If you want to support multiple domains, use the `TLS-Settings` option to create each one, basically an extra step each time. -## Verifying cert-manager is working +## Verifying clusterissuer is working -Once install using the Ingress settings above, you can see the `Application Events` for the app in question to pull the certificate and issue the challenge directly. See the example below: +Once installed using the Ingress settings above, you can see the `Application Events` for the app in question to pull the certificate and issue the challenge directly. See the example below: -![cert-manager4](img/cert-manager4.png) -![cert-manager5](img/cert-manager5.png) +![clusterissuer4](img/clusterissuer4.png) +![clusterissuer5](img/clusterissuer5.png) -All is automated by `cert-manager` +All is automated by `clusterissuer` diff --git a/charts/enterprise/clusterissuer/docs/img/cert-manager1.png b/charts/enterprise/clusterissuer/docs/img/cert-manager1.png deleted file mode 100644 index 3586e23a318..00000000000 Binary files a/charts/enterprise/clusterissuer/docs/img/cert-manager1.png and /dev/null differ diff --git a/charts/enterprise/clusterissuer/docs/img/cert-manager3.png b/charts/enterprise/clusterissuer/docs/img/cert-manager3.png deleted file mode 100644 index 13b88668195..00000000000 Binary files a/charts/enterprise/clusterissuer/docs/img/cert-manager3.png and /dev/null differ diff --git a/charts/enterprise/clusterissuer/docs/img/clusterissuer1.png b/charts/enterprise/clusterissuer/docs/img/clusterissuer1.png new file mode 100644 index 00000000000..53325370c40 Binary files /dev/null and b/charts/enterprise/clusterissuer/docs/img/clusterissuer1.png differ diff --git a/charts/enterprise/clusterissuer/docs/img/clusterissuer2.png b/charts/enterprise/clusterissuer/docs/img/clusterissuer2.png new file mode 100644 index 00000000000..d019d836218 Binary files /dev/null and b/charts/enterprise/clusterissuer/docs/img/clusterissuer2.png differ diff --git a/charts/enterprise/clusterissuer/docs/img/cert-manager2.png b/charts/enterprise/clusterissuer/docs/img/clusterissuer3.png similarity index 100% rename from charts/enterprise/clusterissuer/docs/img/cert-manager2.png rename to charts/enterprise/clusterissuer/docs/img/clusterissuer3.png diff --git a/charts/enterprise/clusterissuer/docs/img/cert-manager4.png b/charts/enterprise/clusterissuer/docs/img/clusterissuer4.png similarity index 100% rename from charts/enterprise/clusterissuer/docs/img/cert-manager4.png rename to charts/enterprise/clusterissuer/docs/img/clusterissuer4.png diff --git a/charts/enterprise/clusterissuer/docs/img/cert-manager5.png b/charts/enterprise/clusterissuer/docs/img/clusterissuer5.png similarity index 100% rename from charts/enterprise/clusterissuer/docs/img/cert-manager5.png rename to charts/enterprise/clusterissuer/docs/img/clusterissuer5.png