mirror of
https://github.com/optim-enterprises-bv/siembol.git
synced 2025-11-02 19:37:47 +00:00
132f07d873
* added dependency install script, and clean up * kafka ui instructions * added ps scripts for install * update to support folder change and powershell scripts * removed unneccessary file * small fix * added cm and secret to cleanup script * change to reflect cleanup script Co-authored-by: Yassin Raman <yassin@gmail.co> Co-authored-by: yasram1 <yasram1@github.com>
116 lines
2.7 KiB
Markdown
116 lines
2.7 KiB
Markdown
Quickstart Guide
|
|
================
|
|
|
|
Local Install
|
|
----------------
|
|
|
|
### 1. Run minikube.sh
|
|
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/sh-scripts/minikube.sh
|
|
```
|
|
or
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/ps-scripts/minikube.ps1
|
|
```
|
|
|
|
### 2. Install dependencies
|
|
#### 1. Run dependencies.sh
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/sh-scripts/dependencies.sh
|
|
```
|
|
or
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/ps-scripts/dependencies.ps1
|
|
```
|
|
|
|
### 3. Prepare GitHub
|
|
|
|
#### 1. Prepare Siembol Config Repository
|
|
|
|
1. Go to https://github.com/G-Research/siembol-config
|
|
2. Fork into your own organization or personal account
|
|
|
|
#### 2. Create GitHub token
|
|
|
|
1. Go to https://github.com/settings/tokens
|
|
2. Click Generate new token
|
|
4. Select "repo - Full control of private repositories" scope
|
|
5. Hit "Generate token"
|
|
6. Keep this token value as you will need it for the next step.
|
|
|
|
#### 3. Run demoInstall.sh
|
|
1. This will ask for your github details related to the Siembol Config repository and the token created in previous step.
|
|
2. This will also initialise Zookeeper nodes.
|
|
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/sh-scripts/demoInstall.sh
|
|
```
|
|
or
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/ps-scripts/demoInstall.ps1
|
|
```
|
|
|
|
### 4. Siembol install
|
|
|
|
To install Siembol in the cluster
|
|
|
|
```bash
|
|
helm install siembol deployment/helm-k8s/ -f deployment/helm-k8s/values.yaml -n=siembol
|
|
```
|
|
|
|
This step might take a few minutes depending on the specs of your development machine.
|
|
|
|
### Check it out!
|
|
|
|
In a browser, go to:
|
|
|
|
* https://siembol.local/home
|
|
|
|
You should now see the Siembol UI homepage. You can also try Storm UI to see running topologies:
|
|
|
|
* https://storm.local
|
|
|
|
### Kafka UI
|
|
|
|
We are using Kafdrop UI to view topics and messages. You can send messages to parsing topics and to test siembol configs.
|
|
|
|
1. To install this and create a kafka client pod:
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/sh-scripts/kafkaExtra.sh
|
|
```
|
|
or
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/ps-scripts/kafkaExtra.ps1
|
|
```
|
|
|
|
2. Exec into the kafka client pod:
|
|
```bash
|
|
kubectl exec --tty -i kafka-client --namespace siembol -- bash
|
|
```
|
|
3. Connect to the broker:
|
|
```bash
|
|
kafka-console-producer.sh \
|
|
--broker-list kafka-0.kafka-headless.siembol.svc.cluster.local:9092 \
|
|
--topic <your-topic>
|
|
```
|
|
4. Produce your message in terminal window
|
|
|
|
|
|
## Cleaning up
|
|
If you're done poking about on a local instance, you can clean up with:
|
|
|
|
1. For cleaning up siembol resources and dependencies:
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/sh-scripts/cleanUp.sh
|
|
```
|
|
or
|
|
```bash
|
|
deployment/helm-k8s/quickstart_install/ps-scripts/cleanUp.ps1
|
|
```
|
|
2. For deleting everything; delete the siembol minikube profile:
|
|
```bash
|
|
minikube delete -p siembol
|
|
sudo rm /etc/resolver/minikube-*
|
|
```
|