From ca34aa7e43134c19aec6dfb72b9545212470dda5 Mon Sep 17 00:00:00 2001
From: Daryl White <53910321+djwfyi@users.noreply.github.com>
Date: Tue, 1 Oct 2024 16:06:37 -0400
Subject: [PATCH] Add cert-manager documentation (#1317)
Adds cert-manager docs for Kubernetes outputs.
Closes #1245
Partially addresses #1273
---
source/images/k8s/cert-manager-cluster.svg | 373 ++++++++++++
source/images/k8s/cert-manager-graph.png | Bin 0 -> 54513 bytes
source/images/k8s/cert-manager-graph.svg | 1 +
source/images/k8s/cert-manager-namespaces.svg | 530 ++++++++++++++++++
source/includes/k8s/deploy-operator.rst | 6 +
.../k8s/file-transfer-protocol-k8s.rst | 2 +-
source/index.rst | 1 +
source/operations/cert-manager.rst | 113 ++++
.../cert-manager/cert-manager-operator.rst | 255 +++++++++
.../cert-manager/cert-manager-tenants.rst | 272 +++++++++
.../monitoring/healthcheck-probe.rst | 2 +
source/operations/network-encryption.rst | 6 +
12 files changed, 1560 insertions(+), 1 deletion(-)
create mode 100644 source/images/k8s/cert-manager-cluster.svg
create mode 100644 source/images/k8s/cert-manager-graph.png
create mode 100644 source/images/k8s/cert-manager-graph.svg
create mode 100644 source/images/k8s/cert-manager-namespaces.svg
create mode 100644 source/operations/cert-manager.rst
create mode 100644 source/operations/cert-manager/cert-manager-operator.rst
create mode 100644 source/operations/cert-manager/cert-manager-tenants.rst
diff --git a/source/images/k8s/cert-manager-cluster.svg b/source/images/k8s/cert-manager-cluster.svg
new file mode 100644
index 00000000..6c58eb1d
--- /dev/null
+++ b/source/images/k8s/cert-manager-cluster.svg
@@ -0,0 +1,373 @@
+
+
\ No newline at end of file
diff --git a/source/images/k8s/cert-manager-graph.png b/source/images/k8s/cert-manager-graph.png
new file mode 100644
index 0000000000000000000000000000000000000000..1730e57d1aee6e45a0a409ad8935e834aa2a7470
GIT binary patch
literal 54513
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