API monolítica base para microservicios en .NET

Curso de Introducción a los Microservicios

Contenido del curso

Fundamentos de Microservicios

Arquitectura Basada en Microservicios

Automatización y Preparación del Entorno

Comunicación Asíncrona entre Servicios

Despliegue

Observabilidad

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:005:19

API monolítica base para microservicios en .NET

Curso de Introducción a los Microservicios

Clase 3 de 24

Clase 3 / 24

Comentarios (12)12 comentarios

Carlos Andrés Moreno Jimenez

Hace un año

También sentí que esta clase es de las más difíciles porque no explican paso a paso cada cosa. Pero logré hacerla funcionar y te comparto cómo lo hice por si te sirve:

✅ 1. Instalé .NET SDK 8.0 Desde la página oficial: Verifiqué con dotnet --version en la terminal.

✅ 2. En Azure creé una base de datos SQL

Nombre: microservicios
Servidor: micro8.database.windows.net
Usuario y clave propia
En “Redes”, activé “Redes seleccionadas” y agregué mi IP pública.

✅ 3. En el portal (Editor de consultas) ejecuté esto:

sqlCopiarEditarCREATE TABLE Adults ( Id INT PRIMARY KEY IDENTITY(1,1), Name NVARCHAR(100), Lastname NVARCHAR(100), BirthYear INT, ImageUrl NVARCHAR(MAX) );

INSERT INTO Adults (Name, Lastname, BirthYear, ImageUrl) VALUES ('Amin', 'Espinosa', 1985, 'amin.jpg'), ('Carlos', 'Moreno', 1994, 'carlos.jpg'), ('Sandra', 'Martínez', 1980, 'sandra.jpg');

✅ 4. Cambié el archivo appsettings.json en mi proyecto:

jsonCopiarEditar"ConnectionStrings": { "DefaultConnection": "Server=tcp:micro8.database.windows.net,1433;Initial Catalog=microservicios;Persist Security Info=False;User ID=thomk;Password=clavesegura!123;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;" }

✅ 5. Ejecuté la API con dotnet run Abrí Swagger en el navegador y probé GET /Adults → ¡y me mostró los registros!

💬 Si alguien necesita ayuda, con gusto puedo compartir más detalles. ¡Ánimo! Esta parte cuesta, pero una vez conectas todo, entiendes cómo funcionan los microservicios con bases de datos reales.

Hector Martin Herrera Cusihuallpa

Hace un año

Gracias Carlos

Sergio Brandon De Lucio Chavero

Hace un año

Wow

Definitivamente este curso necesitaba esa informacion en esta clase

Francisco Ponce

Hace un año

Agradézcanle a Gemini jaja se los dejo por si alguien no lo encontraba.

Sergio Brandon De Lucio Chavero

Hace un año

Ya tambien se encuentra en la seccion de recursos hasta abajo :3

Francisco Ponce

Hace un año

Muchas gracias team!

Luis Fernando Forero Guzmán

Hace un año

Children Table and data

CREATE TABLE Children (
	Id INT PRIMARY KEY IDENTITY(1, 1)
	,Name NVARCHAR(100)
	,Lastname NVARCHAR(100)
	,BirthYear INT
	,ImageUrl NVARCHAR(MAX)
	)

INSERT INTO Children (Name,Lastname,BirthYear,ImageUrl)
VALUES ('Pepe','Levu',2000,'Pepe.jpg')
,('Bugs','Forero',2010,'Bugs.jpg')
,('Speedy','Gonzalez',2020,'Speedy.jpg');

Irving Juárez

Hace un año

Esta es una de las clases más dificiles que he tenido ultimamente porque no te explican casi nada.

Aarón Bernabé Cuarto Rojas Vera

Hace un año

Es confuso si no vas intuyendo lo que hace, mucho menos si solo hace las cosas sin decir el porqué. Hace unos años trabajé con .NET y lo que se encuentra haciendo es configurar su entorno de trabajo para la clase, pero no lo comenta, solo lo hace de un momento a otro

Hilel Salomón

Hace 2 meses

Dado un caso de una red social con SGBD PostgreSQL donde tienen la base de datos principal con tablas de usuarios, grupos y publicaciones. Sean 2 APIs, una de usuarios y otra de posteos, es la SGBD su propio micro servicio???

No, el SGBD es solo infraestructura —el motor que almacena los datos—, no un microservicio.

Si ambas APIs consultan la misma base de datos con todas las tablas mezcladas, sigues teniendo un monolito con múltiples puertas de entrada. En microservicios reales, la API de usuarios debe ser dueña exclusiva de su propia base de datos, y la de posteos de la suya.

Cristian Camilo Castro Veloza

Hace 3 meses

"DefaultConnection": "Server=tcp:amines.database.windows.net,1433;Initial Catalog=microservicios;Persist Security Info=False;User ID=aminespinoza;Password=Kv7TJM6GsBmiKrj;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"

Cristian, la cadena parece correcta, pero Azure SQL suele bloquear conexiones externas por defecto. Si el usuario y la contraseña son válidos, el problema casi siempre es que tu IP actual no está autorizada en el firewall del servidor de Azure.

¿Has verificado en el portal de Azure que tu dirección IP esté añadida a las reglas de firewall de ese servidor SQL?

Geisemberg Marcos Zamora Yuave

Hace 5 meses

Bueno creo que la he tenido un poco mas complicada, porque hago el curso desde un equipo corporativo sin permisos de administrador, así que toco hacerlo con docker ya que no puedo instalar nada, y solo tengo rancher desktop... pero si la verdad es la parte más difícil.... pero animo compañeros si se puede y de esta manera es que se aprende

Cesar Ruiz

Hace 9 meses

Mi pequeño aporte para los que quieran seguir el hilo del curso en NodeJS:

la rama v1 siempre tendrá el template inicial de donde inicia este curso (este video), en main si iré avanzando con el mismo curso.

Espero les sirva.

Moisés Barrera

Hace 10 meses

buen vídeo

Luis Fernando Forero Guzmán

Hace un año

Hay un PR con el codigo y una cadena de conexion para conectarse a una instancia de SQL Server local

Leonardo Beroes

Hace un año

Valoro un poco la gentileza pero porque dejar las credenciales de azure expuestas en el repositorio. Es una pesima practica, no se si hay algun matiz que no veo, si hay un script que crea una BD local o algo. Pero por lo que pude ejecutar mi repo se conecta a Azure del profesor, no es esto peligroso?

Leonardo Beroes

Hace un año

Mejor dicho, no de azure. De SQL Server

Carlos Andrés Moreno Jimenez

Hace un año

Download .NET 8.0 (Linux, macOS, and Windows) | .NET

Recursos

Antes de fragmentar cualquier servicio, necesitas una API monolítica funcional que sirva como punto de partida para migrar hacia una arquitectura de microservicios cloud native. Esa es la base que vamos a preparar usando .NET, SQL Server en Azure y un repositorio clonado desde Platzi.

¿Por qué los microservicios requieren servicios en la nube?

Cuando diseñas microservicios, estás pensando en una solución que debe soportar gran demanda, y eso solo es viable con infraestructura cloud native.

Usar una instancia local de SQL Server puede funcionar al inicio, pero al desplegar los servicios aparecen problemas de comunicación entre componentes. Por eso, durante el recorrido vas a integrar herramientas que viven naturalmente en la nube:

SQL Server alojado en Azure para la base de datos.
Kafka para la mensajería entre servicios.
Redis para caché y manejo de estado distribuido.

¿Qué significa cloud native? Es un enfoque donde las aplicaciones se diseñan desde cero para ejecutarse en la nube, aprovechando servicios gestionados, escalabilidad horizontal y despliegues distribuidos.

No importa qué proveedor elijas, AWS, Azure o Google Cloud, toda arquitectura de microservicios va a depender de servicios gestionados para desplegarse correctamente.

¿Cómo clono el repositorio base del curso de microservicios?

El punto de partida está en el repositorio oficial de Platzi, dentro de la carpeta SRC.

La recomendación es hacer un fork del repositorio para mantener tu copia sincronizada con los cambios futuros. Si vas a manipularlo de forma constante, puedes clonarlo directamente con tus llaves SSH y abrirlo en Visual Studio Code.

Dentro del proyecto encontrarás SRC/API global, que es la minimal API construida con .NET que vamos a usar como base.

¿Puedo usar otro lenguaje en lugar de .NET? Sí. Puedes replicar la misma API con Python, Go, PHP o el lenguaje que prefieras. Una de las ventajas reales de los microservicios es que cada servicio puede escribirse en un lenguaje distinto.

¿Cómo ejecuto la minimal API en .NET por primera vez?

Una vez clonado el repositorio, abre tu terminal y entra a la carpeta del proyecto con cd SRC/API global. Desde ahí puedes compilar y correr la aplicación.

Estos son los pasos concretos:

Ejecuta dotnet build para validar que no haya errores de compilación. Es normal ver advertencias por validaciones de cadenas, pero deben aparecer cero errores.
Ejecuta dotnet run para levantar la API. El servicio queda disponible en localhost:5092.
Agrega /swagger en la URL del navegador para ver todos los métodos documentados.

Desde Swagger puedes probar cada endpoint. Si al ejecutar el método Adultos ves un mensaje de que la base de datos no se ha inicializado, significa que falta configurar la cadena de conexión.

¿Dónde configuro la cadena de conexión a SQL Server?

La configuración vive en el archivo appsettings.json, específicamente en la línea 9, dentro de la propiedad DefaultConnection.

Reemplaza el valor por tu cadena de conexión real, ya sea apuntando a SQL en Azure o a tu motor preferido. Después puedes refrescar la página o detener y volver a ejecutar la aplicación con dotnet run. Cualquiera de las dos opciones funciona.

Cuando la conexión queda lista y vuelves a probar el endpoint Adultos, deberías ver un registro existente, por ejemplo Amin Espinosa, que confirma que la API está leyendo correctamente la base.

¿Qué estructura tiene la base de datos del proyecto?

La base de datos contiene dos tablas que servirán para fragmentar la lógica más adelante:

Adultos: ya viene con registros precargados para validar la lectura.
Niños: tiene exactamente los mismos campos que Adultos, pero está vacía.

Esta simetría no es casualidad. Tener dos tablas con la misma estructura te permite practicar cómo separar dominios y responsabilidades cuando empieces a dividir la API en servicios independientes.

En la documentación del repositorio vas a encontrar el esquema completo de la base de datos, para que puedas replicarlo sin importar el motor SQL que uses.

¿Qué métodos expone la API y por qué importan?

La API global incluye entre cinco y seis métodos ya implementados que cubren operaciones básicas sobre las tablas Adultos y Niños. Sobre esos métodos vas a trabajar el resto del recorrido.

La idea es tomar este monolito funcional y empezar a fragmentarlo en piezas independientes, cada una con su propia responsabilidad, su propio despliegue y, eventualmente, su propia base de datos. Ese es el salto real hacia microservicios.

¿Ya tienes tu cadena de conexión funcionando y la API respondiendo en Swagger? Cuéntame en los comentarios qué motor de base de datos elegiste y si decidiste replicar la API en otro lenguaje distinto a .NET.

CREATE TABLE Children (
	Id INT PRIMARY KEY IDENTITY(1, 1)
	,Name NVARCHAR(100)
	,Lastname NVARCHAR(100)
	,BirthYear INT
	,ImageUrl NVARCHAR(MAX)
	)

INSERT INTO Children (Name,Lastname,BirthYear,ImageUrl)
VALUES ('Pepe','Levu',2000,'Pepe.jpg')
,('Bugs','Forero',2010,'Bugs.jpg')
,('Speedy','Gonzalez',2020,'Speedy.jpg');

Resumen

¿Por qué los microservicios requieren servicios en la nube?

Cuando diseñas microservicios, estás pensando en una solución que debe soportar gran demanda, y eso solo es viable con infraestructura cloud native.

SQL Server alojado en Azure para la base de datos.
Kafka para la mensajería entre servicios.
Redis para caché y manejo de estado distribuido.

¿Qué significa cloud native? Es un enfoque donde las aplicaciones se diseñan desde cero para ejecutarse en la nube, aprovechando servicios gestionados, escalabilidad horizontal y despliegues distribuidos.

No importa qué proveedor elijas, AWS, Azure o Google Cloud, toda arquitectura de microservicios va a depender de servicios gestionados para desplegarse correctamente.

¿Cómo clono el repositorio base del curso de microservicios?

El punto de partida está en el repositorio oficial de Platzi, dentro de la carpeta SRC.

Dentro del proyecto encontrarás SRC/API global, que es la minimal API construida con .NET que vamos a usar como base.

¿Puedo usar otro lenguaje en lugar de .NET? Sí. Puedes replicar la misma API con Python, Go, PHP o el lenguaje que prefieras. Una de las ventajas reales de los microservicios es que cada servicio puede escribirse en un lenguaje distinto.

¿Cómo ejecuto la minimal API en .NET por primera vez?

Una vez clonado el repositorio, abre tu terminal y entra a la carpeta del proyecto con cd SRC/API global. Desde ahí puedes compilar y correr la aplicación.

Estos son los pasos concretos:

Ejecuta dotnet build para validar que no haya errores de compilación. Es normal ver advertencias por validaciones de cadenas, pero deben aparecer cero errores.
Ejecuta dotnet run para levantar la API. El servicio queda disponible en localhost:5092.
Agrega /swagger en la URL del navegador para ver todos los métodos documentados.

Desde Swagger puedes probar cada endpoint. Si al ejecutar el método Adultos ves un mensaje de que la base de datos no se ha inicializado, significa que falta configurar la cadena de conexión.

¿Dónde configuro la cadena de conexión a SQL Server?

La configuración vive en el archivo appsettings.json, específicamente en la línea 9, dentro de la propiedad DefaultConnection.

Cuando la conexión queda lista y vuelves a probar el endpoint Adultos, deberías ver un registro existente, por ejemplo Amin Espinosa, que confirma que la API está leyendo correctamente la base.

¿Qué estructura tiene la base de datos del proyecto?

La base de datos contiene dos tablas que servirán para fragmentar la lógica más adelante:

Adultos: ya viene con registros precargados para validar la lectura.
Niños: tiene exactamente los mismos campos que Adultos, pero está vacía.

Esta simetría no es casualidad. Tener dos tablas con la misma estructura te permite practicar cómo separar dominios y responsabilidades cuando empieces a dividir la API en servicios independientes.

En la documentación del repositorio vas a encontrar el esquema completo de la base de datos, para que puedas replicarlo sin importar el motor SQL que uses.

¿Qué métodos expone la API y por qué importan?

La API global incluye entre cinco y seis métodos ya implementados que cubren operaciones básicas sobre las tablas Adultos y Niños. Sobre esos métodos vas a trabajar el resto del recorrido.

Fundamentos de Microservicios

Arquitectura de microservicios vs sistemas monolíticos

Imagen, contenedor y microservicio: no son lo mismo

API monolítica base para microservicios en .NET

Arquitectura Basada en Microservicios

Dividir una API en microservicios escalables

Kafka para comunicar microservicios por eventos

Flujo de trabajo con Kafka para enrutar microservicios automáticamente

Bases de datos fuera de contenedores Docker

Automatización y Preparación del Entorno

Automatiza microservicios ASP.NET con Bash

Automatizar microservicios con Bash y Dockerfile

Azure Service Bus para comunicación entre microservicios

Rest Client como alternativa a Swagger en VS Code

Comunicación Asíncrona entre Servicios

Envía mensajes a Azure Service Bus desde .NET

Microservicio receptor con worker en .NET

Topics de Azure Service Bus con patrón Pub/Sub

Conectar Add Adult a Service Bus y SQL

Despliegue

Tres microservicios .NET corriendo sin Docker

Creación de servicios de consulta con .NET y SQL

Docker Compose con cinco microservicios .NET

Monorepo vs multirepo en microservicios

Configuración de secretos de GitHub para desplegar en Azure

Observabilidad

Despliegue de aplicaciones con Azure Container Apps desde Docker Hub

Despliegue automático de microservicios con GitHub Actions

Desplegando microservicios con GitHub Actions

Próximos pasos de mejora en arquitectura de microservicios

API monolítica base para microservicios en .NET

Progreso del curso

Fundamentos de Microservicios

Arquitectura Basada en Microservicios

Automatización y Preparación del Entorno

Comunicación Asíncrona entre Servicios

Despliegue

Observabilidad

Recursos

Recursos