Updated READMEs

paolosalvatori · paolosalvatori · commit 6a877ba40f58 · 2024-10-30T09:11:06.000+01:00
diff --git a/README.md b/README.md
@@ -1,6 +1,25 @@
 # Porting a Web Application from AWS Elastic Kubernetes Service (EKS) to Azure Kubernetes Service (AKS)
 
-In this sample, you learn how to migrate a web application from [Amazon Elastic Kubernetes Service (EKS)](https://docs.aws.amazon.com/en_us/eks/latest/userguide/what-is-eks.html) to [Azure Kubernetes Service (AKS)](https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes).
+In this sample, you learn how to migrate a web application from [Amazon Elastic Kubernetes Service (EKS)](https://docs.aws.amazon.com/en_us/eks/latest/userguide/what-is-eks.html) to [Azure Kubernetes Service (AKS)](https://learn.microsoft.com/en-us/azure/aks/what-is-aks).
+
+## Table of Contents
+
+This article:
+
+- [Porting a Web Application from AWS Elastic Kubernetes Service (EKS) to Azure Kubernetes Service (AKS)](#porting-a-web-application-from-aws-elastic-kubernetes-service-eks-to-azure-kubernetes-service-aks)
+  - [Table of Contents](#table-of-contents)
+  - [Yelb Application](#yelb-application)
+  - [Architecture on AWS](#architecture-on-aws)
+  - [Architecture on Azure](#architecture-on-azure)
+    - [Use Application Gateway WAFv2 with NGINX Ingress controller](#use-application-gateway-wafv2-with-nginx-ingress-controller)
+    - [Use NGINX Ingress Controller and ModSecurity](#use-nginx-ingress-controller-and-modsecurity)
+
+This repository:
+
+- [Tutorial: Yelb Architecture on AWS](./aws/README.md)
+- [Yelb Architecture on Azure](./azure/README.md)
+  - [Tutorial: Yelb on AKS with Azure Application Gateway and Azure WAF](./azure/nginx-with-azure-waf/README.md)
+  - [Tutorial: Yelb on AKS with NGINX Ingress Controller and ModSecurity](./azure/nginx-with-modsecurity-waf/)
 
 ## Yelb Application
 
diff --git a/aws/README.md b/aws/README.md
@@ -1,4 +1,4 @@
-# Yelb Architecture on AWS
+# Tutorial: Yelb Architecture on AWS
 
 This section contains a list of scripts that you can use to automate the deployment of the [Yelb](https://github.com/mreferre/yelb/) application on [AWS Elastic Kubernetes Service (EKS)](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html). This solution demonstrates how to implement a web application firewall  using AWS WAF to protect applications running on EKS. You will start by  creating an EKS cluster and deploying a sample workload. The sample  application that you will use for this walkthrough is a web-based  application that we’ll expose using an [Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html). You will then create a [Kubernetes ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) and associate an [AWS WAF web access control list (web ACL)](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl.html) control list (web ACL) with an ALB in front of the ingress.
 
diff --git a/azure/nginx-with-azure-waf/README.md b/azure/nginx-with-azure-waf/README.md
@@ -1,4 +1,4 @@
-# Yelb on AKS with Azure Application Gateway and Azure WAF
+# Tutorial: Yelb on AKS with Azure Application Gateway and Azure WAF
 
 In this solution, the [Yelb](https://github.com/mreferre/yelb/) application is deployed on an [Azure Kubernetes Service (AKS)](https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes) cluster and exposed through an ingress controller like the [NGINX ingress controller](https://github.com/kubernetes/ingress-nginx). The ingress controller service is accessible via an [internal (or private) load balancer](https://learn.microsoft.com/en-us/azure/load-balancer/load-balancer-overview), which is used to balance traffic within the virtual network housing the AKS cluster. This load balancer frontend can also be accessed from an on-premises network in a hybrid scenario. To learn more about utilizing an internal load balancer to restrict access to your applications in Azure Kubernetes Service (AKS), refer to the guide [Use an internal load balancer with Azure Kubernetes Service (AKS)](https://learn.microsoft.com/en-us/azure/aks/internal-lb?tabs=set-service-annotations).
 
diff --git a/azure/nginx-with-modsecurity-waf/README.md b/azure/nginx-with-modsecurity-waf/README.md
@@ -1,4 +1,4 @@
-# Yelb on AKS with NGINX Ingress Controller and ModSecurity
+# Tutorial: Yelb on AKS with NGINX Ingress Controller and ModSecurity
 
 The following solution makes use of [NGINX ingress controller](https://docs.nginx.com/nginx-ingress-controller/intro/overview/) to expose the [Yelb](https://github.com/mreferre/yelb/) application and ModSecurity to block any malicious or suspicious traffic based on predefined OWASP or custom rules. [ModSecurity](https://github.com/SpiderLabs/ModSecurity) is an open-source web application firewall (WAF) that is compatible with popular web servers such as Apache, NGINX, and ISS. It provides protection from a wide range of attacks by using a powerful rule-definition language.
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Yelb Architecture on AWS`
	`1`	`+# Tutorial: Yelb Architecture on AWS`
`2`	`2`
`3`	`3`	This section contains a list of scripts that you can use to automate the deployment of the [Yelb](https://github.com/mreferre/yelb/) application on [AWS Elastic Kubernetes Service (EKS)](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html). This solution demonstrates how to implement a web application firewall using AWS WAF to protect applications running on EKS. You will start by creating an EKS cluster and deploying a sample workload. The sample application that you will use for this walkthrough is a web-based application that we’ll expose using an [Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html). You will then create a [Kubernetes ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) and associate an [AWS WAF web access control list (web ACL)](https://docs.aws.amazon.com/waf/latest/developerguide/web-acl.html) control list (web ACL) with an ALB in front of the ingress.
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Yelb on AKS with Azure Application Gateway and Azure WAF`
	`1`	`+# Tutorial: Yelb on AKS with Azure Application Gateway and Azure WAF`
`2`	`2`
`3`	`3`	In this solution, the [Yelb](https://github.com/mreferre/yelb/) application is deployed on an [Azure Kubernetes Service (AKS)](https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes) cluster and exposed through an ingress controller like the [NGINX ingress controller](https://github.com/kubernetes/ingress-nginx). The ingress controller service is accessible via an [internal (or private) load balancer](https://learn.microsoft.com/en-us/azure/load-balancer/load-balancer-overview), which is used to balance traffic within the virtual network housing the AKS cluster. This load balancer frontend can also be accessed from an on-premises network in a hybrid scenario. To learn more about utilizing an internal load balancer to restrict access to your applications in Azure Kubernetes Service (AKS), refer to the guide [Use an internal load balancer with Azure Kubernetes Service (AKS)](https://learn.microsoft.com/en-us/azure/aks/internal-lb?tabs=set-service-annotations).
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Yelb on AKS with NGINX Ingress Controller and ModSecurity`
	`1`	`+# Tutorial: Yelb on AKS with NGINX Ingress Controller and ModSecurity`
`2`	`2`
`3`	`3`	The following solution makes use of [NGINX ingress controller](https://docs.nginx.com/nginx-ingress-controller/intro/overview/) to expose the [Yelb](https://github.com/mreferre/yelb/) application and ModSecurity to block any malicious or suspicious traffic based on predefined OWASP or custom rules. [ModSecurity](https://github.com/SpiderLabs/ModSecurity) is an open-source web application firewall (WAF) that is compatible with popular web servers such as Apache, NGINX, and ISS. It provides protection from a wide range of attacks by using a powerful rule-definition language.
`4`	`4`