TeaStore v2 (HTTP/1.1 | HTTP/2 | HTTP/3)

TeaStore v2 is a rework of the original TeaStore and part of my master thesis.
The original version was developed by the Descartes Research Group (University of Würzburg).
TeaStore emulates a basic web store for automatically generated, tea and tea supplies.
For more details visit the base repository.

Changes

• Registry replaced with Traefik, a HTTP reverse proxy and load balancer
• Netty HTTP servers (and client) instead of Jetty servlets
• Support for HTTP/1.1, HTTP/2 and HTTP/3
• Full JSON-API instead of JSPs
• Optimized API paths
• The database setup includes the data population
• Java 17 (LTS) as target environment

Getting Started

Launch without installation

Docker Compose

HTTP/1.1

docker-compose up -f ./examples/docker/docker-compose_http1_1.yaml up

HTTP/2

docker-compose up -f ./examples/docker/docker-compose_http2.yaml up

HTTP/3

docker-compose -f ./examples/docker/docker-compose_http3.yaml up

Docker Swarm

HTTP/1.1

docker stack deploy --compose-file ./examples/swarm/docker-swarm_http1_1.yaml teastore

HTTP/2

docker stack deploy --compose-file ./examples/swarm/docker-swarm_http2.yaml teastore

HTTP/3

docker stack deploy --compose-file ./examples/swarm/docker-swarm_http3.yaml teastore

Launch locally with installation

Prerequisites

Install dependencies (second command can be ignored for docker-compose run).

mvn clean install
docker build -t teastore-db:v2 database

Only database as Docker container

You have to start the database first.

docker run -p 3306:3306 teastore-db:v2

Run services in order:

• HttpPersistenceServer
• HttpAuthServer
• HttpWebServer

Wait until database is ready before starting the next services.

• HttpImageServer
• HttpRecommenderServer

Docker Compose

Waiting for the database is already included.

HTTP/1.1

docker-compose up -f ./docker-compose_h1.yaml --build

HTTP/2

docker-compose up -f ./docker-compose_h2.yaml up --build

HTTP/3

docker-compose up -f ./docker-compose_h3.yaml up --build

DockerHub Images

API Gateway & Services

• Traefik
• Database
• Persistence
• Auth
• Web
• Image
• Recommender

Tools

• curl-http3
• h2load-http3

Microservice Architecture

API Documentation

Available as OpenAPI v3 YAML.

Evaluation (Benchmarking)

Check out TeaStore-Benchmark for custom benchmarking tools.

More tools

curl

The popular command-line tool supports all HTTP versions (if configured).
You can use the DockerHub image if you don't want to compile it on your system.
Workload script shows some example commands.

h2load

h2load is currently (09/21) the only HTTP benchmarking tool which supports HTTP/1.1, HTTP/2 and HTTP/3.
You can use the existing benchmark script or create your own scripts.

Important

There is a bug in the HTTP/3 library of Netty, which causes freezes for some requests with h2load.
Please keep that in mind for the HTTP/3 version.

License

Distributed under the Apache-2.0 License. See LICENSE for more information.
If you use this application in a scientific context, please consider the citation rules.