← maurobernal.com.ar

Novedades en .NET Aspire 13.2: CLI poderosa, TypeScript AppHost y más

El equipo de .NET acaba de lanzar .NET Aspire 13.2, y viene cargado de novedades. Esta versión se centra en tres pilares: una CLI muchísimo más potente, una extensión de VS Code renovada, y soporte multi-lenguaje que incluye TypeScript como lenguaje de AppHost. Veamos qué hay de nuevo.

🚀 CLI: el gran salto

Si usás Aspire desde la terminal, esta actualización es para vos. El equipo agregó una cantidad enorme de comandos nuevos que exponen información que antes solo estaba disponible en el dashboard.

Modo detached — feature más pedida

Por fin podés correr tu apphost en segundo plano sin bloquear la terminal:

# Correr en background
aspire run --detach

# Shorthand
aspire start

# Ver todos los apphosts corriendo
aspire ps

# Detener
aspire stop --all

aspire describe — el dashboard en la terminal

Inspeccioná estado de recursos, variables de entorno, health status y más, todo desde la CLI. Incluye un modo --follow para streaming en tiempo real de cambios de estado:

aspire describe
aspire describe --follow

aspire doctor

Un nuevo comando de diagnóstico que verifica tu entorno completo: certificados HTTPS, Docker/Podman, .NET SDK, WSL2 y configuración de agentes de AI. Ideal para onboarding de equipos o troubleshooting.

Nuevos comandos operacionales

# Esperar hasta que un recurso esté healthy (útil en CI/CD)
aspire wait api --status healthy --timeout 120

# Exportar telemetría y datos de una sesión
aspire export --output .\artifacts\aspire-export.zip

# Gestión de secrets sin necesitar dotnet user-secrets
aspire secret set ApiKey mi-valor-secreto
aspire secret list --format json

# Limpiar y confiar certificados de desarrollo
aspire certs clean
aspire certs trust

aspire docs — documentación en la terminal

Buscá y leé la documentación oficial sin salir del flujo de trabajo:

aspire docs search "redis"
aspire docs get redis-integration --section "Add Redis resource"

aspire agent (ex aspire mcp)

El comando aspire mcp fue renombrado a aspire agent para reflejar mejor su propósito. Ahora también inyecta archivos SKILL.md específicos de Aspire en tu repo para mejorar la integración con agentes de IA:

aspire agent init
aspire agent mcp

Configuración unificada con aspire.config.json

Aspire 13.2 consolida toda la configuración en un único archivo aspire.config.json, reemplazando el split entre .aspire/settings.json y apphost.run.json. La migración es automática.

🖥️ VS Code Extension — renovación mayor

Más de 20 PRs entraron en la extensión de VS Code, convirtiéndola en un entorno de primera clase para Aspire:

  • Panel dedicado en la Activity Bar con árbol de recursos en tiempo real (usa aspire describe --follow por debajo, sin polling).
  • CodeLens inline sobre cada definición de recurso en tu apphost, mostrando estado vivo y botones de acción (Start, Stop, Restart, View Logs).
  • Decoraciones de gutter con íconos de color según el estado de salud del recurso.
  • Debug mejorado para Azure Functions y TypeScript apphosts.
  • Auto-registro del servidor MCP de Aspire para workflows de AI agents.

📜 TypeScript AppHost (Preview)

Podés escribir tu apphost en TypeScript usando el mismo app model que C#:

import { createBuilder } from './.modules/aspire.js';

const builder = await createBuilder();

const cache = await builder.addRedis("cache");

const api = await builder.addProject("api", "../api")
  .withReference(cache)
  .waitFor(cache);

await builder.build().run();

El soporte multi-lenguaje se extiende además a scaffolding para Python, y el generador de código ahora cubre targets de test en Go, Java y Rust.

📊 Dashboard — export/import y API de telemetría

El dashboard recibe mejoras importantes:

  • Export/import de telemetría: exportá logs, spans y trazas como JSON en un zip para compartir con el equipo o adjuntar a bug reports.
  • API HTTP de telemetría bajo /api/telemetry con endpoints para recursos, spans, logs y trazas — con soporte de streaming vía ?follow=true.
  • Parámetros editables directamente desde el dashboard.
  • Mejor visualizador GenAI, layout de grafo con force-directed adaptativo, y configuración de formato horario 12h/24h.

🏗️ Novedades en el App Model

  • WithMcpServer: declarás en el app model que un recurso expone un servidor MCP, y las herramientas de Aspire lo descubren automáticamente.
  • Rebuild command: reconstruí un solo proyecto sin bajar todo el apphost (aspire resource api rebuild).
  • Docker Compose como publishing target: Aspire genera un docker-compose.yaml completo desde tu app model.
  • Contextual endpoint resolution: resolvé la URL de un recurso según desde dónde se accede (localhost, container network, internet público).
  • WithBuildSecret: API más clara para secrets en builds de contenedores.
  • Microsoft Foundry integration: reemplaza Aspire.Hosting.Azure.AIFoundry; ahora es Aspire.Hosting.Foundry con soporte para model deployments, hosted agents y más.
  • Azure Virtual Network: nuevo paquete Aspire.Hosting.Azure.Network para definir VNets, subnets, NSGs y private endpoints desde el apphost.

⬆️ Cómo actualizar

# Actualizar la CLI
aspire update --self

# Actualizar el apphost del proyecto
aspire update

O instalar desde cero:

curl -sSL https://aspire.dev/install.sh | bash

📝 Conclusión

Aspire 13.2 es una versión de madurez. La CLI deja de ser un simple lanzador para convertirse en una herramienta completa de gestión del ciclo de vida de tu aplicación. La extensión de VS Code cierra la brecha con Visual Studio. El soporte multi-lenguaje abre la puerta a equipos que trabajan con TypeScript o Python. Y la integración con AI agents (MCP) posiciona a Aspire como una plataforma de desarrollo lista para workflows modernos con IA.

Para ver todas las novedades en detalle, la documentación oficial está en aspire.dev/whats-new/aspire-13-2.

, , , , , , ,