updated Readme file

Author: NeckerFree

.gitignore

@@ -20,3 +20,4 @@ crash.log
 *.db
 *.db-shm
 *.db-wal
+infra/terraform.tfvars

README.md

@@ -4,7 +4,7 @@ Proyecto de ejemplo para aprender Kubernetes en Azure (AKS) con una API .NET 8 +
 
 ---
 
-## Contenido
+## 🧱 Estructura del Proyecto
 
 ```
 k8s-dotnet-aks/
@@ -18,20 +18,31 @@ k8s-dotnet-aks/
 
 ---
 
-## Requisitos
+## 🔐 Requisitos
 
-- Azure Subscription con Service Principal (usar secrets ARM_*).
-- GitHub repo con estos **Secrets**:
-  - `ARM_CLIENT_ID`
-  - `ARM_CLIENT_SECRET`
-  - `ARM_SUBSCRIPTION_ID`
-  - `ARM_TENANT_ID`
-  - `VM_SSH_PUB_KEY` (clave pública para nodos AKS)
-  - (Opcional) `VM_SSH_KEY` si quieres conectarte a nodos; no requerido por los workflows.
+- Azure Subscription con Service Principal
+- GitHub repo con estos **Secrets** configurados:
+
+| Secret              | Descripción                                                     |
+|---------------------|------------------------------------------------------------------|
+| `AZURE_CREDENTIALS` | Credenciales JSON generadas con `az ad sp create-for-rbac --sdk-auth` |
+| `VM_SSH_PUB_KEY`    | Clave pública SSH para nodos AKS                                |
+| `VM_SSH_KEY`        | (Opcional) Clave privada SSH para acceso manual a nodos         |
+
+---
+
+## 🚀 Workflows de GitHub Actions
+
+| Archivo                   | Propósito                               | Cuándo se ejecuta                           |
+|---------------------------|------------------------------------------|----------------------------------------------|
+| `terraform-create.yml`    | Provisiona la infraestructura (AKS, ACR) | `push` a `main` o manual desde GitHub        |
+| `terraform-destroy.yml`   | Elimina toda la infraestructura          | Manual desde la UI de GitHub Actions         |
+| `ci.yml`                  | Compila y testea la API (.NET)           | `push` o `pull_request` hacia `main`         |
+| `cd.yml`                  | Construye imagen Docker y despliega a AKS| `push` a `main`                              |
 
 ---
 
-## Flujo de Trabajo Automatizado
+## 🌐 Flujo de Trabajo Automatizado
 
 1. **Push a `main`** → corre *Terraform Create Infra* (crea RG, ACR, AKS).
 2. Cuando finaliza, corre **CI Build & Push**:
@@ -46,14 +57,15 @@ k8s-dotnet-aks/
 
 ---
 
-## Inicialización del Backend de Terraform
+## ☁️ Backend Remoto de Terraform
+
+Los workflows crean automáticamente (idempotente) estos recursos para almacenar el estado remoto:
 
-Los workflows crean (idempotente) los recursos del backend remoto si no existen:
 - Resource Group: `tfstate-rg`
 - Storage Account: `tfstatek8sstore`
 - Container: `tfstate`
 
-Si prefieres hacerlo manualmente:
+O puedes crearlos manualmente con:
 
 ```bash
 az group create -n tfstate-rg -l eastus
@@ -63,7 +75,7 @@ az storage container create -n tfstate --account-name tfstatek8sstore
 
 ---
 
-## Ejecutar Localmente (opcional)
+## ▶️ Ejecutar API Localmente
 
 ```bash
 cd src/K8sDotnetApi
@@ -81,7 +93,7 @@ curl -X POST http://localhost:5164/movies -H "Content-Type: application/json" -d
 
 ---
 
-## Construir Imagen Docker Local
+## 🐳 Construir Imagen Docker Local
 
 ```bash
 cd src/K8sDotnetApi
@@ -91,18 +103,24 @@ docker run -p 8080:8080 holamundo-dotnet:local
 
 ---
 
-## Notas Importantes
+## ⚠️ Notas Importantes
 
-- El nombre del ACR en Terraform está configurado como `k8sdotnetacr` (global único en Azure; cámbialo si ya existe).
-- El `deployment.yaml` usa marcador `<ACR_LOGIN_SERVER>` que el workflow CD sustituye dinámicamente antes de aplicar.
-- SQLite se almacena en `/app/data/movies.db`, montado desde un PVC (Azure Disk vía StorageClass default). No escalar a múltiples réplicas sin mover a una BD externa (Azure SQL, PostgreSQL, etc.).
+- El nombre del ACR en Terraform está configurado como `k8sdotnetacr` (debe ser único globalmente).
+- El `deployment.yaml` usa el marcador `<ACR_LOGIN_SERVER>` que es sustituido por el workflow `cd.yml` automáticamente.
+- SQLite se monta en `/app/data/movies.db` mediante un PVC con Azure Disk. Para escalar horizontalmente, deberías usar una base de datos externa como Azure SQL.
 
 ---
 
-## Limpieza
+## 🧹 Limpieza
+
+Para evitar costos innecesarios, ejecuta el workflow manual:
+
+```
+Terraform Destroy Infra
+```
 
-Para destruir la infra (y evitar costos): usa el workflow **Terraform Destroy Infra** desde la pestaña *Actions* en GitHub.
+Desde la pestaña **Actions** en GitHub.
 
 ---
 
-¡Disfruta aprendiendo AKS! 💪
+¡Disfruta aprendiendo AKS! 💪