Pre requisites

1. Have docker installed
2. Have Kind (Kubernetes for docker) installed

Quick start (Docker Compose)

For local development without Kubernetes:

docker compose up -d                    # Postgres, Redpanda, Keycloak
docker compose --profile apps up -d --build   # + microservices (optional)
cd frontend && npm install && npm start

See BIDFLOW.md for ports and test users.

How to run (Kubernetes / Kind)

1. run (creates the cluster): kind create cluster --config "k8s/kind/config.yaml" on the project folder;
2. run: kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/kind/deploy.yaml
3. Deploy the stack:
   • Windows (PowerShell): .\scripts\deploy-all.ps1
   • Linux/macOS: ./scripts/linux-deploy/deploy-all.sh
4. Open "C:\Windows\System32\drivers\etc\hosts" as adm and add:

Host
127.0.0.1 app.local
127.0.0.1 api.local
127.0.0.1 keycloak.local
127.0.0.1 config.local
127.0.0.1 kafka-ui.local

Ports used by the services

Service	port	targetPort	namespace
api-gateway	8085	8085	bidflow
config-server	8888	8888	bidflow
Keycloak	8080	8080	bidflow
Postgress	5432	5432	bidflow
Conduktor Console	8080	8080	kafka

Usefull commands

• kubectl apply -f "k8s/keycloak/deployment.yaml"

• kubectl rollout restart deployment keycloak -n bidflow

• kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/kind/deploy.yaml

• kubectl get pods -n ingress-nginx

• kind delete cluster --name bidflow

• make the database accessible: kubectl port-forward svc/postgres 5432:5432 -n bidflow

• make the kafka-ui accessible: kubectl -n kafka port-forward svc/my-cluster-kafka-bootstrap 9092:9092

• kubectl get ns

• kubectl get nodes

• kubectl get pods -n bidflow

• kubectl get svc -n bidflow

• kubectl create token headlamp-admin -n kube-system