update READMEs

Author: malhussan

README.md

@@ -15,13 +15,10 @@ Tenant wide admin consent must be granted for a succesful meshPlatform setup. Th
 
 ## How to use this module
 
-Prerequisites:
-
-- [Azure CLI installed](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli)
-- [Terraform installed](https://learn.hashicorp.com/tutorials/terraform/install-cli)
-
 ### Using Azure Portal
 
+Prerequisites: [Terraform installed](https://learn.hashicorp.com/tutorials/terraform/install-cli)
+
 1. Login into [Azure Portal](https://portal.azure.com/) with your Admin user.
 
 2. Open a cloud shell.
@@ -61,6 +58,11 @@ Prerequisites:
     ```
 
 ### Using CLI
+
+Prerequisites:
+
+- [Azure CLI installed](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli)
+- [Terraform installed](https://learn.hashicorp.com/tutorials/terraform/install-cli)
   
 1. Login with az CLI
    ```sh
@@ -88,35 +90,9 @@ Prerequisites:
     # The JSON output contains sensitive values that must not be transmitted to meshcloud in plain text.
     terraform output -json
     ```
-## Advanced Usage
-
-The default case creates kraken, replicator and idplookup service principals.
-
-```hcl
-module "meshplatform" {
-  source = "git@github.com:meshcloud/terraform-azure-meshplatform.git"
-
-  spp_name_suffix = "UNIQUE_NAME"
-  mgmt_group_name = "MANAGEMENT_GROUP_NAME|MANAGEMENT_GROUP_UUID"
-}
-```
-
-If UAMI blueprint user principal is needed, you also need to pass a list of subscriptions this user will be assigned to.
-
-```hcl
-module "meshplatform" {
-  source = "git@github.com:meshcloud/terraform-azure-meshplatform.git"
-
-  spp_name_suffix = "UNIQUE_NAME"
-  mgmt_group_name = "MANAGEMENT_GROUP_NAME|MANAGEMENT_GROUP_UUID"
+## Example Usages
 
-  subscriptions = [
-    "abcdefgh-abcd-efgh-abcd-abcdefgh1234"
-  , "abcdefgh-abcd-efgh-abcd-abcdefgh5678"
-  , ...
-  ]
-}
-```
+Check [examples](./examples/) for different use cases. As a quick start we recommend using [basic-azure-integration](./examples/basic-azure-integration) example.
 
 ## Requirements
 
@@ -125,7 +101,6 @@ module "meshplatform" {
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.0 |
 | <a name="requirement_azuread"></a> [azuread](#requirement\_azuread) | 2.18.0 |
 | <a name="requirement_azurerm"></a> [azurerm](#requirement\_azurerm) | 2.97.0 |
-| <a name="requirement_random"></a> [random](#requirement\_random) | 2.2.1 |
 
 ## Providers
 

main.tf

@@ -5,10 +5,6 @@ terraform {
       source  = "hashicorp/azurerm"
       version = "2.97.0"
     }
-    random = {
-      source  = "hashicorp/random"
-      version = "2.2.1"
-    }
     azuread = {
       source  = "hashicorp/azuread"
       version = "2.18.0"

modules/meshcloud-idp-lookup-spp/README.md

@@ -5,7 +5,6 @@
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.13 |
 | <a name="requirement_azuread"></a> [azuread](#requirement\_azuread) | 2.18.0 |
 | <a name="requirement_azurerm"></a> [azurerm](#requirement\_azurerm) | 2.97.0 |
-| <a name="requirement_random"></a> [random](#requirement\_random) | 2.2.1 |
 
 ## Providers
 

modules/meshcloud-idp-lookup-spp/module.tf

@@ -5,10 +5,6 @@ terraform {
       source  = "hashicorp/azurerm"
       version = "2.97.0"
     }
-    random = {
-      source  = "hashicorp/random"
-      version = "2.2.1"
-    }
     azuread = {
       source  = "hashicorp/azuread"
       version = "2.18.0"

modules/meshcloud-kraken-spp/README.md

@@ -5,7 +5,6 @@
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.13 |
 | <a name="requirement_azuread"></a> [azuread](#requirement\_azuread) | 2.18.0 |
 | <a name="requirement_azurerm"></a> [azurerm](#requirement\_azurerm) | 2.97.0 |
-| <a name="requirement_random"></a> [random](#requirement\_random) | 2.2.1 |
 
 ## Providers
 

modules/meshcloud-kraken-spp/module.tf

@@ -5,10 +5,6 @@ terraform {
       source  = "hashicorp/azurerm"
       version = "2.97.0"
     }
-    random = {
-      source  = "hashicorp/random"
-      version = "2.2.1"
-    }
     azuread = {
       source  = "hashicorp/azuread"
       version = "2.18.0"

modules/meshcloud-replicator-spp/README.md

@@ -5,7 +5,6 @@
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.13 |
 | <a name="requirement_azuread"></a> [azuread](#requirement\_azuread) | 2.18.0 |
 | <a name="requirement_azurerm"></a> [azurerm](#requirement\_azurerm) | 2.97.0 |
-| <a name="requirement_random"></a> [random](#requirement\_random) | 2.2.1 |
 
 ## Providers
 

modules/meshcloud-replicator-spp/module.tf

@@ -6,10 +6,6 @@ terraform {
       source  = "hashicorp/azurerm"
       version = "2.97.0"
     }
-    random = {
-      source  = "hashicorp/random"
-      version = "2.2.1"
-    }
     azuread = {
       source  = "hashicorp/azuread"
       version = "2.18.0"

modules/uami-blueprint-user-principal/README.md

@@ -5,7 +5,6 @@
 | <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.13 |
 | <a name="requirement_azuread"></a> [azuread](#requirement\_azuread) | 2.18.0 |
 | <a name="requirement_azurerm"></a> [azurerm](#requirement\_azurerm) | 2.97.0 |
-| <a name="requirement_random"></a> [random](#requirement\_random) | 2.2.1 |
 
 ## Providers
 

modules/uami-blueprint-user-principal/module.tf

@@ -5,10 +5,6 @@ terraform {
       source  = "hashicorp/azurerm"
       version = "2.97.0"
     }
-    random = {
-      source  = "hashicorp/random"
-      version = "2.2.1"
-    }
     azuread = {
       source  = "hashicorp/azuread"
       version = "2.18.0"