Configuración de microservicio emisor con ServiceBus en .NET
Clase 12 de 24 • Curso de Introducción a los Microservicios
Resumen
Dominar la integración con ServiceBus desde tus microservicios en .NET puede llevar tus aplicaciones al siguiente nivel en términos de eficiencia y escalabilidad. La comunicación asíncrona mediante mensajes facilita la gestión de tareas independiente, mejorando tanto la estructura como el desempeño de tus proyectos.
¿Cómo configurar nuestro proyecto para enviar mensajes a ServiceBus?
La configuración inicial implica algunos pasos clave que te asegurarán una interacción fluida y efectiva con las colas de Azure:
- Crea una nueva carpeta llamada data en tu proyecto principal.
- Dentro, crea el archivo
servicebus.cs
. - Integra el fragmento proporcionado por la documentación oficial que contiene:
- Cadena de conexión (
connection string
). - Nombre de la cola para tu ServiceBus.
Este archivo esencialmente realiza una tarea específica: establece conexión directa con ServiceBus mediante el paquete instalado previamente, definiendo las variables básicas de operación.
¿Qué función cumple el archivo 'servicebus.cs'?
El archivo prepara dos elementos básicos:
- Configuración de conexión con ServiceBus usando una connection string obtenida desde Azure.
- Identificación de la cola (
queue
) que alojará los mensajes enviados.
¿Cómo usar la cadena de conexión correcta desde Azure?
Conseguir la cadena desde Azure es muy sencillo:
- Ingresa al portal de Azure.
- Navega hasta tu namespace de ServiceBus.
- Accede a “Políticas de acceso compartido” dentro del apartado settings.
- Copia directamente la cadena que comienza con
Endpoint
.
Asegúrate de copiarla íntegra para evitar errores en la comunicación con el servicio.
¿Qué modificaciones necesitas hacer en tu archivo 'appsettings.json'?
Las modificaciones son simples y directas:
- Introduce la sección referente a
ServiceBus
dentro de tu archivoappsettings.json
. - Aquí define claramente estas dos configuraciones imprescindibles:
ConnectionString
: Cadena obtenida previamente desde Azure.QueueName
: Indica el nombre preciso de la cola con la que interactuarás.
¿Cómo ajustar tu archivo 'program.cs' para realizar envíos síncronos?
Realiza estas acciones para configurar tu aplicación correctamente:
- Elimina servicios por defecto (como el servicio climático).
- Copia y pega la configuración de la documentación dentro del archivo
program.cs
. - Define tu API como tipo POST, incluyendo parámetros requeridos (nombre, apellido y año de nacimiento) que serán enviados mediante el método
sendMessageAsync
.
¿Cómo validar que tu microservicio esté funcionando correctamente?
La verificación efectiva incluye:
- Ejecuta tu aplicación mediante terminal con
dotnet run
. - Identifica el puerto nuevo asignado y actualízalo en tu archivo HTTP para realizar la petición fácilmente.
- Envía una petición simple para comprobar la respuesta positiva de "Miembro agregado con éxito".
- Revisa en el portal Azure el incremento de número de mensajes en la cola correspondiente.
Esta validación asegura la correcta configuración y la comunicación exitosa entre tu microservicio y ServiceBus, preparando así el camino para crear futuros receptores que gestionarán estos mensajes.
Si tienes alguna duda sobre estos pasos o recomendaciones adicionales para optimizar tu proceso, ¡déjanos un comentario! Estamos aquí para ayudarte en cada etapa de tu aprendizaje.