Merge pull request #98 from pon0marev/additional-tools/kafka

Additional tools/kafka-ui

Author: pon0marev

kafka/tb-kafka-ui.yml

@@ -0,0 +1,51 @@
+
+# Kafka manager with web UI to monitor and maintain Kafka's clusters
+
+## General Information
+The container on: [Docker Redpanda Console](https://hub.docker.com/r/redpandadata/console)
+
+You can find the documentation of the service here: [Redpanda Console repository](https://github.com/redpanda-data/console)
+
+## Deployment
+By default, the service has 50 mCPU and 100 megabytes of RAM requested resources. This is enough for the normal operation of the service. But this value can be overridden individually for each deployment.
+
+By default, our Redpanda Console deployment is configured to use Kubernetes **tb-kafka** service as a connection endpoint to Kafka. If you use an external broker, please override the `KAFKA_BROKERS` variable to list your kafka brokers, a.g.:
+
+```shell
+            - name: KAFKA_BROKERS
+              value: "kafka-broker1:9092,kafka-broker2:9092,kafka-broker3:9092"
+```
+
+### Configuring access to Kafka via SASL
+
+Uncomment the variables in the tb-kafka-ui.yml deployment file to use SASL.
+
+For the username and password, the best practice is to use Kubernetes Secrets. Please specify them *(Be sure to change **YOUR_USERNAME** and **YOUR_PASSWORD**)*:
+```shell
+export SASL_USERNAME=YOUR_USERNAME
+export SASL_PASSWORD=YOUR_PASSWORD
+
+kubectl create -n thingsboard secret generic kafka-sasl-credentials \
+--from-literal=kafka-sasl-username=$SASL_USERNAME \
+--from-literal=kafka-sasl-password=$SASL_PASSWORD
+```
+
+Apply the deployment file:
+```shell
+kubectl apply -f tb-kafka-ui.yml
+```
+
+## Connect to UI
+
+We didn't add external access to this tool because it is a system tool. So use port forwarding to the local machine to access the service:
+```shell
+kubectl port-forward sts/kafka-ui-redpanda 8085:8080
+```
+
+goto weblink: http://localhost:8085
+
+
+If Kafka UI does not need, scale it down:
+```shell
+kubectl scale --replicas=0 statefulset kafka-ui-redpanda
+```

tools /kafka/README.md

@@ -0,0 +1,66 @@
+#
+# Copyright © 2016-2021 The Thingsboard Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+apiVersion: apps/v1
+kind: StatefulSet
+metadata:
+  name: kafka-ui-redpanda
+spec:
+  serviceName: kafka-ui-redpanda
+  replicas: 1
+  selector:
+    matchLabels:
+      app: kafka-ui-redpanda
+  template:
+    metadata:
+      labels:
+        app: kafka-ui-redpanda
+    spec:
+      containers:
+        - name: server
+          imagePullPolicy: IfNotPresent
+          image: docker.redpanda.com/redpandadata/console:latest
+          resources:
+            requests:
+              cpu: 50m
+              memory: 100Mi
+            limits:
+              cpu: 200m
+              memory: 400Mi
+          ports:
+            - containerPort: 8080
+              name: http8080
+          env:
+            - name: KAFKA_BROKERS
+              value: "tb-kafka:9092" # put your broker list here. By default - tb-kafka:9092
+            # Please uncomment lines below if you need access to Kafka with SASL.
+            # - name: KAFKA_TLS_ENABLED
+            #   value: "true"
+            # - name: KAFKA_SASL_ENABLED
+            #   value: "true"
+            # - name: KAFKA_SASL_USERNAME
+            #   valueFrom:
+            #     secretKeyRef:
+            #       name: kafka-sasl-credentials
+            #       key: kafka-sasl-username
+            #       optional: false
+            # - name: KAFKA_SASL_PASSWORD
+            #   valueFrom:
+            #     secretKeyRef:
+            #       name: kafka-sasl-credentials
+            #       key: kafka-sasl-password
+            #       optional: false
+      restartPolicy: Always