From 8f2da9065cb80e85e66140f4fab32647bc56d9b4 Mon Sep 17 00:00:00 2001 From: efiacor Date: Sat, 5 Mar 2022 13:16:22 +0000 Subject: [STRIMZI] Add strimzi docs entry Signed-off-by: efiacor Issue-ID: DMAAP-1706 Change-Id: I24a1110e6b30851051f440f7a4af84531caa9a20 --- docs/userguides/installation.rst | 84 +++++++++++++++++++++++++++++++++------- 1 file changed, 70 insertions(+), 14 deletions(-) diff --git a/docs/userguides/installation.rst b/docs/userguides/installation.rst index a45292f6f..bf76dd9d6 100644 --- a/docs/userguides/installation.rst +++ b/docs/userguides/installation.rst @@ -9,22 +9,14 @@ Installation Guide Installation ------------ -ONAP is meant to be deployed within a Kubernetes environment. Hence, the de-facto way to deploy CDS is through Kubernetes. +ONAP is meant to be deployed within a Kubernetes environment. +Hence, the de-facto way to deploy CDS is through Kubernetes. +ONAP also packages Kubernetes manifest as Charts, using Helm. -ONAP also package Kubernetes manifest as Chart, using Helm. - -Prerequisite ------------- - -https://docs.onap.org/en/latest/guides/onap-developer/settingup/index.html - -Setup local Helm ----------------- - -helm repo +Prerequisites +------------- -* helm serve & -* helm repo add local http://127.0.0.1:8879 +https://docs.onap.org/en/latest/guides/onap-operator/settingup/index.html#installation Get the chart ------------- @@ -33,6 +25,70 @@ Make sure to checkout the release to use, by replacing $release-tag in bellow co git clone https://gerrit.onap.org/r/oom git checkout tags/$release-tag + + +Customize blueprint-processor kafka messaging config (Optional) +--------------------------------------------------------------- +Optionally, cds can use kafka native messaging to execute a blueprint use case. +The blueprint-processor self-service api is the main api for interacting with CDS at runtime. +The self-service-api topics carry actual request and response payloads, +whereas blueprint-processor self-service-api.audit topics will carry redacted payloads +(without sensitive data) for audit purposes. + +By default, cds will target the strimzi kafka cluster in ONAP. +The strimzi kafka config is as follows: + +# strimzi kafka config + +useStrimziKafka: + +If useStrimziKafka is true, the following also applies: + +1. Strimzi will create an associated kafka user and the topics + defined for Request and Audit elements below. + +2. The type must be kafka-scram-plain-text-auth. + +3. The bootstrapServers will target the strimzi kafka cluster by default. + +The following fields are configurable via the charts values.yaml +(oom/kubernetes/cds/components/cds-blueprints-processor/values.yaml) + +.. code-block:: bash + + kafkaRequestConsumer: + enabled: false + type: kafka-basic-auth + groupId: cds-consumer + topic: cds.blueprint-processor.self-service-api.request + clientId: request-receiver-client-id + pollMillSec: 1000 + kafkaRequestProducer: + type: kafka-basic-auth + clientId: request-producer-client-id + topic: cds.blueprint-processor.self-service-api.response + enableIdempotence: false + kafkaAuditRequest: + enabled: false + type: kafka-basic-auth + clientId: audit-request-producer-client-id + topic: cds.blueprint-processor.self-service-api.audit.request + enableIdempotence: false + kafkaAuditResponse: + type: kafka-basic-auth + clientId: audit-response-producer-client-id + topic: cds.blueprint-processor.self-service-api.audit.response + enableIdempotence: false + +Note: +If more fine grained customization is required, this can be done manually +in the application.properties file before making the helm chart. +(oom/kubernetes/cds/components/cds-blueprints-processor/resources/config/application.properties) + + +Make the chart +-------------- + cd oom/kubernetes make cds -- cgit 1.2.3-korg