rework docs

Author: andifalk

introduction/README.md

@@ -118,6 +118,8 @@ There are many [Reactive Streams](https://www.reactive-streams.org/) implementat
 * [RxJS](https://rxjs.dev/)
 * [Project Reactor](https://projectreactor.io/)
 
+#### Project Reactor & Spring Webflux 
+
 [Spring WebFlux](https://docs.spring.io/spring-framework/docs/current/reference/html/web-reactive.html#spring-web-reactive) builds upon [Project Reactor](https://projectreactor.io/).
 
 Reactor fully implements [Reactive Streams](https://www.reactive-streams.org/) and extends it by offering two reactive and composable APIs:
@@ -148,6 +150,7 @@ public class BooksApi {
 }
 ```
 
+To get a really fast introduction into reactive streams with project reactor look into the _reactive-playground_ project as part of this workshop or look for the [Reactive Spring Security 5 Workshop](https://github.com/andifalk/reactive-spring-security-5-workshop).
 
 
 

lab5/solution/api-gateway/src/main/java/com/example/apigateway/filter/CustomGlobalFilter.java

@@ -15,6 +15,7 @@ public class CustomGlobalFilter implements GlobalFilter, Ordered {
     public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
         return chain.filter(exchange)
                 .then(Mono.just(exchange))
+                .log()
                 .map(serverWebExchange -> {
                     //adds header to response
                     serverWebExchange.getResponse().getHeaders().set("CUSTOM-RESPONSE-HEADER",

prerequisites/README.md

@@ -8,7 +8,11 @@
 
 ## System Requirements
 
-* LTS version 17 of the [Java SDK](https://adoptopenjdk.net/), other versions later than 17 might also work but are not tested
-* A Java IDE (like [Eclipse](https://www.eclipse.org/downloads/), [SpringToolSuite](https://spring.io/tools), [IntelliJ](https://www.jetbrains.com/idea/download), [Visual Studio Code](https://code.visualstudio.com/))
-* [Postman](https://www.getpostman.com/downloads/) or any alternative tool like [curl](https://curl.se/) or [httpie](https://httpie.io/) to test requests to the REST Api
-* For the Redis Rate Limiter in Lab 2 you need to have installed [docker](https://docs.docker.com/get-docker/) and [docker compose](https://docs.docker.com/compose/install/).
+* Mandatory for all hands-on labs
+  * LTS version 17 of the [Java SDK](https://adoptopenjdk.net/), other versions later than 17 might also work but are not tested
+  * A Java IDE (like [Eclipse](https://www.eclipse.org/downloads/), [SpringToolSuite](https://spring.io/tools), [IntelliJ](https://www.jetbrains.com/idea/download), [Visual Studio Code](https://code.visualstudio.com/))
+  * [Postman](https://www.getpostman.com/downloads/) or any alternative tool like [curl](https://curl.se/) or [httpie](https://httpie.io/) to test requests to the REST Api
+* Only required for lab 2 (request rate limiter)  
+  * [Docker](https://docs.docker.com/get-docker/) or another container runtime plus [docker compose](https://docs.docker.com/compose/install/)
+* Only required for lab 4 (TLS/SSL)
+  * [mkcert](https://github.com/FiloSottile/mkcert) to create a local CA and issue certificate to configure TLS/SSL.

reactive-playground/README.md

@@ -9,6 +9,7 @@ The following resources might be helpful for first steps into the reactive world
 
 * [Which operator do I need?](https://projectreactor.io/docs/core/release/reference/#which-operator)
 
-This playground contains a starting point to play around with the reactive stuff.
+This playground contains a starting point to play around with the reactive stuff.  
+Just execute tests in the class `BasicReactivePlaygroundTests` to learn more about the reactive streams api.
 
-Just execute tests in the class `BasicReactivePlaygroundTests` to learn the reactive streams api.
+If you want to learn more about the project reactor and reactive streams you may also want to check another GitHub repository for a [Reactive Spring Security 5 Workshop](https://github.com/andifalk/reactive-spring-security-5-workshop).

setup/README.md

@@ -43,3 +43,17 @@ You can use the following users to log into the custom Spring Authorization Serv
 | pparker / parker  | USER, ADMIN |
 | ckent / kent      | USER        |
 
+## Docker and docker compose
+
+If you want to follow configuring a rate limiter as part of hands-on lab 2 you will need to run a container image with a redis database.  
+Therefore a container runtime is required.  
+
+If you don't have already _docker_ installed on your machine please open the corresponding [docker installation](https://docs.docker.com/get-docker/) location and follow instructions there.  
+With Docker Desktop you already have docker compose installed.  Other installations like standalone engine on Linux require an additional [installation of docker compose](https://docs.docker.com/get-started/08_using_compose/).
+
+> In case you have installed another container runtime like [Rancher Desktop](https://rancherdesktop.io/) this should also work, as long as docker compose is supported by that solution.
+
+## mkcert - Create a local Certificate Authority (CA)
+
+[mkcert](https://github.com/FiloSottile/mkcert) is a helpful tool to create a local CA for Lab 4 to configure TLS/SSL for the api gateway.
+Please follow the [mkcert installation](https://github.com/FiloSottile/mkcert#installation) section on how to install this on your local machine.