Configuración de microservicio emisor con ServiceBus en .NET

Clase 12 de 24Curso 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 archivo appsettings.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.