feat: enhance Azure PaaS documentation with improved structure, clarity, and additional steps

Author: 0GiS0

04-cloud/azure/paas/01-sql-database/README.md

@@ -1,10 +1,16 @@
-# Azure SQL Database
+# 🗄️ Azure SQL Database
 
-Se trata de un servicio PaaS de Azure que nos permite crear bases de datos relacionales en la nube sin necesidad de tener que administrar la infraestructura subyacente.
+## ¿Qué es Azure SQL Database?
 
-Para este ejemplo, vamos a crear una base de datos en Azure SQL Database y vamos a conectarla con la API de Tour of heroes.
+Es un servicio **PaaS (Platform as a Service)** de Azure que te permite crear bases de datos relacionales en la nube sin preocuparte por la infraestructura subyacente. ¡No más administración de servidores! 🎯
 
-Lo primero que necesitas es cargar algunas variables de entorno:
+En este ejemplo, vamos a:
+- ✅ Crear una base de datos en Azure SQL Database
+- ✅ Conectarla con la API de Tour of Heroes
+
+## 📝 Paso 1: Configurar variables de entorno
+
+Carga estas variables en tu terminal:
 
 ```bash
 # Database variables
@@ -15,8 +21,7 @@ startIp="0.0.0.0"
 endIp="0.0.0.0"
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
 # Database variables
 $SQL_SERVER_NAME="heroes-sql-server-$RANDOM"
@@ -26,9 +31,9 @@ $startIp="0.0.0.0"
 $endIp="0.0.0.0"
 ```
 
-## Creando la base de datos
+## 🚀 Paso 2: Crear el servidor de base de datos
 
-Para crear una base de datos en Azure SQL Database, lo primero que tienes que hacer es crear un servidor de base de datos. Para ello, ejecuta el siguiente comando:
+Ejecuta este comando para crear un servidor SQL en Azure:
 
 ```bash
 echo "Creating $SQL_SERVER_NAME in $LOCATION..."
@@ -40,8 +45,7 @@ az sql server create --name $SQL_SERVER_NAME \
 --admin-password $SQL_PASSWORD
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
 echo "Creating $SQL_SERVER_NAME in $LOCATION..."
 
@@ -52,9 +56,11 @@ az sql server create --name $SQL_SERVER_NAME `
 --admin-password $SQL_PASSWORD
 ```
 
-En este ejemplo no necesitamos crear la base de datos, ya que nuestra API, que hace uso de Entity Framework Core, se encargará de crearla por nosotros.
+## 🔥 Paso 3: Configurar el firewall
 
-Lo que si es necesario es que permitamos el acceso a la base de datos desde otros recursos de Azure. Para ello, ejecuta el siguiente comando:
+Entity Framework Core se encargará de crear automáticamente la base de datos cuando la uses. Sin embargo, necesitas permitir el acceso desde otros recursos de Azure.
+
+Ejecuta este comando para configurar las reglas de firewall:
 
 ```bash
 echo "Configuring firewall..."
@@ -66,8 +72,7 @@ az sql server firewall-rule create \
 --end-ip-address $endIp
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
 echo "Configuring firewall..."
 az sql server firewall-rule create `
@@ -78,8 +83,12 @@ az sql server firewall-rule create `
 --end-ip-address $endIp
 ```
 
-Con [Azure Data Studio](https://azure.microsoft.com/es-es/products/data-studio), puedes conectarte a la base de datos (tienes que permitir entonces el acceso desde tu IP, que puedes hacerlo desde esta misma app) y comprobar que se ha creado correctamente e incluso podrías crear la base de datos desde aquí.
+## 🔗 Paso 4: Verificar la conexión (Opcional)
+
+Con [Azure Data Studio](https://azure.microsoft.com/es-es/products/data-studio) puedes conectarte a tu base de datos para verificar que se creó correctamente. Recuerda que deberás permitir el acceso desde tu IP en las reglas de firewall.
+
+## ➡️ Siguiente paso
 
-Ahora lo siguiente que necesitamos es desplegar la API que haga uso de esta base de datos. Para ello, puedes seguir los pasos que te comparto en este otro [README](/04-cloud/azure/paas/02-app-service/README.md).
+Ahora que tienes la base de datos lista, es hora de desplegar la API de Tour of Heroes. Continúa en este [README](../02-app-service/README.md) 📖
 
 

04-cloud/azure/paas/02-app-service/README.md

@@ -1,33 +1,43 @@
-# Azure App Service
+# 🌐 Azure App Service
 
-Este servicio de Azure nos permite desplegar aplicaciones web y API REST de forma rápida y sencilla. Además, nos permite escalarlas de forma automática y nos ofrece integración con otros servicios de Azure como Azure SQL Database, Azure Cosmos DB, Azure Functions, Azure Storage, Azure Key Vault, Azure Active Directory, etc.
+## ¿Qué es Azure App Service?
 
-Para este ejemplo, vamos a crear una API REST con ASP.NET Core y la vamos a desplegar en Azure App Service.
+Es un servicio **PaaS** que te permite desplegar aplicaciones web y API REST de forma rápida y sencilla. Además ofrece:
 
-Lo primero que necesitas es cargar algunas variables de entorno:
+- 📈 **Escalado automático** según la demanda
+- 🔗 **Integración** con otros servicios de Azure (SQL Database, Cosmos DB, Key Vault, etc.)
+- 🔐 **Seguridad** integrada
+- 📊 **Monitoreo y logging** automático
 
+En este ejemplo, vamos a crear una **API REST con ASP.NET Core** y desplegarla en Azure App Service.
+
+## 📝 Paso 1: Configurar variables de entorno
+
+**En Linux/macOS:**
 ```bash
 # App Service variables
 APP_SVC_PLAN_NAME="tour-of-heroes-plan"
 WEB_API_NAME="tour-of-heroes-api-$RANDOM"
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
 # App Service variables
 $APP_SVC_PLAN_NAME="tour-of-heroes-plan"
 $WEB_API_NAME="tour-of-heroes-api-$RANDOM"
 ```
 
->Importante: asegúrate de que el nombre de la web app es único en Azure.
+⚠️ **Nota importante:** Asegúrate de que el nombre de la web app es **único en Azure**.
+
+## 📦 Paso 2: Crear el plan de App Service
 
-## Creando el plan de App Service
+Todas las aplicaciones web necesitan estar dentro de un **plan de App Service**. Este plan determina el tamaño de las máquinas virtuales que alojarán tu aplicación.
 
-Las aplicaciones web alojadas en este servicio necesitan estar dentro de un plan de App Service. Para crear uno, ejecuta el siguiente comando:
+Ejecuta este comando:
 
+**En Linux/macOS:**
 ```bash
-echo -e "Create Azure App Service for the API 🚀"
+echo "Creating App Service Plan..."
 
 az appservice plan create \
 --name $APP_SVC_PLAN_NAME \
@@ -36,10 +46,9 @@ az appservice plan create \
 --sku S1
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
-echo -e "Create Azure App Service for the API 🚀"
+echo "Creating App Service Plan..."
 
 az appservice plan create `
 --name $APP_SVC_PLAN_NAME `
@@ -48,12 +57,13 @@ az appservice plan create `
 --sku S1
 ```
 
-Este es el que determina el tamaño de las máquinas virtuales que se van a utilizar para alojar las aplicaciones web. En este caso, hemos elegido el plan S1.
+En este caso, usamos el plan **S1** que ofrece un buen equilibrio entre capacidad y coste.
 
-## Crear la web app para la API
+## 🚀 Paso 3: Crear la web app para la API
 
-Una vez que tenemos el plan de App Service, lo siguiente es crear la web app para la API. Para ello, ejecuta el siguiente comando:
+Ahora que tienes el plan, crea la web app:
 
+**En Linux/macOS:**
 ```bash
 az webapp create \
 --name $WEB_API_NAME \
@@ -62,8 +72,7 @@ az webapp create \
 --plan $APP_SVC_PLAN_NAME
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
 az webapp create `
 --name $WEB_API_NAME `
@@ -72,10 +81,11 @@ az webapp create `
 --plan $APP_SVC_PLAN_NAME
 ```
 
-## Configurar la web app para la API
+## ⚙️ Paso 4: Configurar la conexión a la base de datos
 
-Una vez que tenemos la web app creada, podemos añadirle algunas configuraciones. Para ello, ejecuta el siguiente comando:
+Ahora configura la cadena de conexión a la base de datos y otras variables de entorno:
 
+**En Linux/macOS:**
 ```bash
 az webapp config connection-string set \
 --name $WEB_API_NAME \
@@ -89,40 +99,40 @@ az webapp config appsettings set \
 --settings "OTEL_SERVICE_NAME=tour-of-heroes-api"
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
 az webapp config connection-string set `
 --name $WEB_API_NAME `
 --resource-group $RESOURCE_GROUP `
 --connection-string-type SQLAzure `
 --settings "DefaultConnection=Server=tcp:$SQL_SERVER_NAME.database.windows.net,1433;Initial Catalog=heroes-db;Persist Security Info=False;User ID=$SQL_USER;Password=$SQL_PASSWORD;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
-```
 
-```pwsh
 az webapp config appsettings set `
 --name $WEB_API_NAME `
 --resource-group $RESOURCE_GROUP `
 --settings "OTEL_SERVICE_NAME=tour-of-heroes-api"
 ```
 
-En este caso, hemos añadido la cadena de conexión a la base de datos y el nombre del servicio para que se pueda identificar en OpenTelemetry/Azure Monitor.
+Esto configura:
+- 🔗 La cadena de conexión a Azure SQL Database
+- 📊 El nombre del servicio para OpenTelemetry/Azure Monitor
 
-## Desplegar la API
+## 🚀 Paso 5: Desplegar la API
 
-Ahora que ya tenemos un sitio donde desplegar nuestra API lo único que nos queda es desplegarla 😃.
+Ahora toca desplegar el código. Sigue estos pasos:
 
+**En Linux/macOS:**
 ```bash
-echo "Clone the repo..."
+echo "Cloning repository..."
 git clone https://github.com/0GiS0/tour-of-heroes-dotnet-api.git
 cd tour-of-heroes-dotnet-api
 
-dotnet build
+echo "Building and publishing..."
 cd src
 dotnet publish tour-of-heroes-api.csproj -o ./publish
 
+echo "Deploying to Azure..."
 cd publish
-
 zip -r site.zip *
 
 az webapp deployment source config-zip \
@@ -131,18 +141,18 @@ az webapp deployment source config-zip \
 --name $WEB_API_NAME
 ```
 
-o si estás en Windows:
-
+**En Windows PowerShell:**
 ```pwsh
-echo "Clone the repo..."
+echo "Cloning repository..."
 git clone https://github.com/0GiS0/tour-of-heroes-dotnet-api.git
 cd tour-of-heroes-dotnet-api
 
+echo "Publishing..."
 cd src
 dotnet publish tour-of-heroes-api.csproj -o ./publish
 
+echo "Deploying to Azure..."
 cd publish
-
 Compress-Archive -Path * -DestinationPath site.zip
 
 az webapp deployment source config-zip `
@@ -151,15 +161,21 @@ az webapp deployment source config-zip `
 --name $WEB_API_NAME
 ```
 
-Todo esto que hemos hecho a través de Azure CLI también es posible gestionarlos con la extensión de Azure App Service para Visual Studio Code. 
+## 💻 Alternativa: Usar VS Code Extension
+
+También puedes gestionar todo esto con la **extensión de Azure App Service para Visual Studio Code**.
 
 <img src="../images/Extension%20de%20Azure%20App%20Service.png"/>
 
-Para comprobar que todo ha ido bien, puedes ejecutar el siguiente comando:
+## ✅ Verificar el despliegue
+
+Una vez completado, verifica que todo funcionó correctamente:
 
 ```bash
-echo "API deployed 🚀"
-echo "API URL: https://$WEB_API_NAME.azurewebsites.net"
+echo "✅ API deployed successfully!"
+echo "📍 API URL: https://$WEB_API_NAME.azurewebsites.net"
 ```
 
-Ahora lo único que nos queda por hacer es desplegar el frontal que consuma esta API. Para seguir los pasos puedes continuar en este otro [README](/04-cloud/azure/paas/03-static-web-apps/README.md).
+## ➡️ Siguiente paso
+
+Ahora toca desplegar el frontal. Continúa en este [README](../03-static-web-apps/README.md) 📖