topology-generator

README

Topology Generator

The generator creates a topology based on different instances of the same application called Mimik.

Basically what Mimik does is to imitate a service that listens to certain paths and methods, and connects these with upstream connections (that usually are Mimik instances too) forming a service mesh.

The topology is generated based on some parameters like:

• Number of namespaces
• Number of services per namespace
• Number of connections between services in the same namespace
• Number of random connections between services in different namespaces

Commands

topogen (topology-generator) is a powerful tool for building complex topology 💪, 
        you can choose to create specific topology with commands or in the UI 🌈.

Usage:
  topogen [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  doc         Generate the latest commmands docs
  generate    Generate topology config with commands
  help        Help about any command
  instance    The instance running in topology
  server      The web server for UI of Topology Generator

Flags:
  -h, --help   help for topogen

Use "topogen [command] --help" for more information about a command.

Build and Use Binary

Build topogen binary:

make build-binary

Add built binary called topogen to your PATH,

Run topogen -v to see if it works.

Build and Use Docker Image

Build Docker locally:

make build-image
# build image in specific image name and version
make build-image image=xxx version=xxx

Use Instance:

docker run xxxxxx instance

Use Web Server:

docker run xxxxxx server
# Start server in specific port and expose it
docker run -p [port]:[port] xxxxxx server -p [port]

You can refer to docs to learn how to use topology-generator.

Platform Install

This demo has been tested using Minikube and Istio 1.12.

Install into Cluster

Create the application resources:

kubectl create ns topology-generator
kubectl apply -n topology-generator -f https://raw.githubusercontent.com/kiali/demos/master/topology-generator/deploy/generator.yaml 

Web Application

This demo exposes a web application where with some parameters, a command is produced to be executed in the terminal against any cluster:

Visit the application through a proxy:

kubectl port-forward svc/topology-generator 8080:8080 -n topology-generator

Configure the parameters, click on "Generate", copy the command and execute it in a terminal.

As a result, the topology will be created to be observed and managed by Kiali:

Cleanup

Delete all namespaces generated by the application:

kubectl delete ns --selector=generated-by=mimik

Delete the topology generator:

kubectl delete ns topology-generator