docs: add cluster requirements

docs/content/en/docs/install/k8s.md

@@ -13,20 +13,19 @@ that runs your deployment software.
 See [Requirements](reqs.md) for information about supported releases
 and advice about resources required.
 
-You can also create a local cluster using packages
-such as KinD, Minikube, K3s, and K3d
-that can be used for testing, study, and demonstration purposes.
-
 ## Create local Kubernetes cluster
 
-You can use tools such as
+You can also create a local cluster using packages such as
 [KinD](https://kind.sigs.k8s.io/),
 [k3d](https://k3d.io/),
 [k3s](https://k3s.io/),
 and [Minikube](https://minikube.sigs.k8s.io/docs/)
 to set up a local, lightweight Kubernetes cluster
 where you can install the Keptn Lifecycle Toolkit
 for personal study, demonstrations, and testing.
+For more information, see the Kubernetes
+[Install Tools](https://kubernetes.io/docs/tasks/tools/)
+documentation.
 
 The [Keptn Lifecycle Toolkit: Installation and KeptnTask Creation in Minutes](https://www.youtube.com/watch?v=Hh01bBwZ_qM)
 video  demonstrates how to create a KinD cluster.
@@ -41,6 +40,10 @@ The basic steps are:
    kind create cluster
    ```
 
+   See the
+   [KinD Quick Start Guide](https://kind.sigs.k8s.io/docs/user/quick-start/)
+   for more information
+
 1. When the cluster has been created,
    run the following to verify that the cluster is working
    and that it is running a supported version of Kubernetes
@@ -49,3 +52,45 @@ The basic steps are:
    ```shell
    kubectl version --short
    ```
+
+## Prepare your cluster for KLT
+
+The Keptn Lifecycle Toolkit installs into an existing Kubernetes cluster.
+When setting up a local Kubernetes cluster
+to study or demonstrate the Lifecycle Toolkit,
+you need to provide these components.
+
+Your cluster should include the following:
+
+* A supported version of Kubernetes.
+  See [Supported Kubernetes versions](reqs.md/#supported-kubernetes-versions)
+  for details.
+
+* [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
+
+* Metric provider such as
+  [Prometheus](https://prometheus.io/),
+  [Dynatrace](https://www.dynatrace.com/),
+  or [Datadog](https://www.datadoghq.com/).
+  This is used for the metrics used for the observability features.
+
+* Deployment tools of your choice,
+  such as
+  [Argo CD](https://argo-cd.readthedocs.io/en/stable/) or
+  [Flux](https://fluxcd.io/).
+  Alternatively, KLT also works with just `kubctl apply` for deployment.
+
+* For traces, install [Jaeger](https://jaegertracing.io)
+  or a similar tool.
+
+* If you want a dashboard for reviewing metrics and traces,
+  Install [Grafana](https://grafana.com/)
+  or the dashboard of your choice.
+
+Also note that the Keptn Lifecycle Toolkit includes
+a light-weight cert-manager that, by default, is installed
+as part of the KLT software.
+If you are using another cert-manager in the cluster,
+you can configure KLT to instead use your cert-manager.
+See [Use your own cert-manager](cert-manager.md)
+for detailed instructions.

docs/content/en/docs/install/reqs.md

@@ -1,8 +1,6 @@
 ---
 title: Requirements
 description: Supported software versions and information about resources required
-icon: concepts
-layout: quickstart
 weight: 15
 hidechildren: false # this flag hides all sub-pages in the sidebar-multicard.html
 ---
@@ -11,6 +9,21 @@ hidechildren: false # this flag hides all sub-pages in the sidebar-multicard.htm
 
 The Keptn Lifecycle Controller requires Kubernetes v1.24.0 or later.
 
+Run the following to ensure that both client and server versions
+are running Kubernetes versions greater than or equal to v1.24.
+In this example, both client and server are at v1.24.0
+so the Keptn Lifecycle Toolkit will work.
+
+```shell
+kubectl version --short
+```
+
+```shell
+Client Version: v1.24.0
+Kustomize Version: v4.5.4
+Server Version: v1.24.0
+```
+
 ## Resource requirements
 
 ## cert-manager