Merge pull request #27930 from rh-max/srvls-kafka-setup-updates

Updated instructions on configuring KnativeKafka

Author: bergerhoffer

modules/serverless-install-kafka-odc.adoc

@@ -3,7 +3,7 @@
 // serverless/serverless-kafka.adoc
 
 [id="serverless-install-kafka-odc_{context}"]
-= Installing Apache Kafka components using the web console
+= Installing Apache Kafka components by using the web console
 
 Cluster administrators can enable the use of Apache Kafka functionality in an {ServerlessProductName} deployment by instantiating the `KnativeKafka` custom resource definition provided by the *Knative Kafka* {ServerlessOperatorName} API.
 
@@ -18,9 +18,13 @@ Cluster administrators can enable the use of Apache Kafka functionality in an {S
 
 . In the *Administrator* perspective, navigate to *Operators* -> *Installed Operators*.
 . Check that the *Project* dropdown at the top of the page is set to *Project: knative-eventing*.
-. Click *Knative Kafka* in the list of *Provided APIs* for the {ServerlessOperatorName} to go to the *Knative Kafka* tab.
-. Click *Create Knative Kafka*.
-. Optional: Configure the *KnativeKafka* object in the *Create Knative Kafka* page. To do so, use either the default form provided or edit the YAML.
+. In the list of *Provided APIs* for the {ServerlessOperatorName}, find the *Knative Kafka* box and click *Create Instance*.
+. Configure the *KnativeKafka* object in the *Create Knative Kafka* page.
++
+[IMPORTANT]
+====
+To use the Kafka channel or Kafka source on your cluster, you must toggle the *Enable* switch for the options you want to use to *true*. These switches are set to *false* by default. Additionally, to use the Kafka channel, you must specify the Boostrap Servers.
+====
 .. Using the form is recommended for simpler configurations that do not require full control of *KnativeKafka* object creation.
 .. Editing the YAML is recommended for more complex configurations that require full control of *KnativeKafka* object creation. You can access the YAML by clicking the *Edit YAML* link in the top right of the *Create Knative Kafka* page.
 . Click *Create* after you have completed any of the optional configurations for Kafka. You are automatically directed to the *Knative Kafka* tab where *knative-kafka* is in the list of resources.
@@ -43,7 +47,9 @@ $ oc get pods -n knative-eventing
 .Example output
 [source,terminal]
 ----
-NAME                                                       READY   STATUS      RESTARTS   AGE
-kafka-ch-controller-5d85f5f779-kqvs4                       1/1     Running     0          126m
-kafka-webhook-66bd8688d6-2grvf                             1/1     Running     0          126m
+NAME                                            READY   STATUS    RESTARTS   AGE
+kafka-ch-controller-85f879d577-xcbjh            1/1     Running   0          44s
+kafka-ch-dispatcher-55d76d7db8-ggqjl            1/1     Running   0          44s
+kafka-controller-manager-bc994c465-pt7qd        1/1     Running   0          40s
+kafka-webhook-54646f474f-wr7bb                  1/1     Running   0          42s
 ----

modules/serverless-kafka-source-yaml.adoc

@@ -59,3 +59,19 @@ spec:
 ----
 $ oc apply -f <filename>
 ----
+
+.Verification
+
+* Verify that the Kafka event source was created:
++
+[source, terminal]
+----
+$ oc get pods
+----
++
+.Example output
+[source, terminal]
+---
+NAME                                    READY     STATUS    RESTARTS   AGE
+kafkasource-kafka-source-5ca0248f-...   1/1       Running   0          13m
+---