Move to aspire as service and update in docker-compose

Author: madebygps

.devcontainer/devcontainer.json

@@ -1,12 +1,10 @@
 {
     "name": "python-agentframework-demos",
-    "build": {
-        "dockerfile": "Dockerfile",
-        "context": ".."
-    },
+    "dockerComposeFile": "docker-compose.yml",
+    "service": "app",
+    "workspaceFolder": "/workspaces/python-agentframework-demos",
     "features": {
-        "ghcr.io/azure/azure-dev/azd:latest": {},
-        "ghcr.io/devcontainers/features/docker-in-docker:latest": {}
+        "ghcr.io/azure/azure-dev/azd:latest": {}
     },
     "customizations": {
         "vscode": {

.devcontainer/docker-compose.yml

@@ -0,0 +1,17 @@
+services:
+  app:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    volumes:
+      - ..:/workspaces/python-agentframework-demos:cached
+    command: sleep infinity
+    environment:
+      - OTEL_EXPORTER_OTLP_ENDPOINT=http://aspire-dashboard:18889
+
+  aspire-dashboard:
+    image: mcr.microsoft.com/dotnet/aspire-dashboard:latest
+    ports:
+      - "18888:18888"
+    environment:
+      - DASHBOARD__FRONTEND__AUTHMODE=Unsecured

README.md

@@ -179,40 +179,52 @@ You can run the examples in this repository by executing the scripts in the `exa
 
 The [agent_otel_aspire.py](examples/agent_otel_aspire.py) example can export OpenTelemetry traces, metrics, and structured logs to a [Aspire Dashboard](https://aspire.dev/dashboard/standalone/).
 
-1. Start the Aspire Dashboard:
+### In GitHub Codespaces / Dev Containers
+
+The Aspire Dashboard runs automatically as a service alongside the dev container. No extra setup is needed.
+
+1. The `OTEL_EXPORTER_OTLP_ENDPOINT` environment variable is already set by the dev container.
+
+2. Run the example:
 
     ```sh
-    docker run --rm -it -d -p 18888:18888 -p 4317:18889 --name aspire-dashboard mcr.microsoft.com/dotnet/aspire-dashboard:latest
+    uv run agent_otel_aspire.py
     ```
 
-2. Get the login token from the container logs:
+3. Open the dashboard at <http://localhost:18888> and explore:
+
+    * **Traces**: See the full span tree — agent invocation → chat completion → tool execution
+    * **Metrics**: View token usage and operation duration histograms
+    * **Structured Logs**: Browse conversation messages (system, user, assistant, tool)
+    * **GenAI visualizer**: Select a chat completion span to see the rendered conversation
+
+### Local environment (without Dev Containers)
+
+If you're running locally without Dev Containers, you need to start the Aspire Dashboard manually:
+
+1. Start the Aspire Dashboard:
 
     ```sh
-    docker logs aspire-dashboard
+    docker run --rm -it -d -p 18888:18888 -p 4317:18889 --name aspire-dashboard \
+        -e DASHBOARD__FRONTEND__AUTHMODE=Unsecured \
+        mcr.microsoft.com/dotnet/aspire-dashboard:latest
     ```
 
-    Look for the line containing `Login to the dashboard at http://localhost:18888/login?t=<TOKEN>`. Copy the token or open the URL directly.
-
-3. Add the OTLP endpoint to your `.env` file:
+2. Add the OTLP endpoint to your `.env` file:
 
     ```sh
     OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
     ```
 
-4. Run the example:
+3. Run the example:
 
     ```sh
     uv run agent_otel_aspire.py
     ```
 
-5. Open the dashboard at <http://localhost:18888> and explore:
-
-    * **Traces**: See the full span tree — agent invocation → chat completion → tool execution
-    * **Metrics**: View token usage and operation duration histograms
-    * **Structured Logs**: Browse conversation messages (system, user, assistant, tool)
-    * **GenAI visualizer**: Select a chat completion span to see the rendered conversation
+4. Open the dashboard at <http://localhost:18888> and explore.
 
-6. When done, stop the dashboard:
+5. When done, stop the dashboard:
 
     ```shell
     docker stop aspire-dashboard

examples/agent_otel_aspire.py

@@ -29,7 +29,8 @@
     logger.info(f"OpenTelemetry export enabled — sending to {otlp_endpoint}")
 else:
     logger.info(
-        "Set OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317 in .env to export telemetry to the Aspire Dashboard"
+        "Set OTEL_EXPORTER_OTLP_ENDPOINT in .env to export telemetry to the Aspire Dashboard. "
+        "Use http://aspire-dashboard:18889 in Codespaces/Dev Containers or http://localhost:4317 locally."
     )
 
 # Configure OpenAI client based on environment

examples/spanish/README.md

@@ -180,46 +180,58 @@ Puedes ejecutar los ejemplos en este repositorio ejecutando los scripts en el di
 
 El ejemplo [agent_otel_aspire.py](agent_otel_aspire.py) puede exportar trazas, métricas y logs estructurados de OpenTelemetry a un [Aspire Dashboard](https://aspire.dev/dashboard/standalone/).
 
-1. Inicia el Aspire Dashboard:
+### En GitHub Codespaces / Dev Containers
+
+El Aspire Dashboard se ejecuta automaticamente como un servicio junto al dev container. No necesitas configuracion adicional.
+
+1. La variable de entorno `OTEL_EXPORTER_OTLP_ENDPOINT` ya esta configurada por el dev container.
+
+2. Ejecuta el ejemplo:
 
     ```sh
-    docker run --rm -it -d -p 18888:18888 -p 4317:18889 --name aspire-dashboard mcr.microsoft.com/dotnet/aspire-dashboard:latest
+    uv run agent_otel_aspire.py
     ```
 
-2. Obtén el token de inicio de sesión de los logs del contenedor:
+3. Abre el dashboard en <http://localhost:18888> y explora:
+
+    * **Traces**: Ve el arbol completo de spans — invocacion del agente → completado del chat → ejecucion de herramientas
+    * **Metrics**: Consulta histogramas de uso de tokens y duracion de operaciones
+    * **Structured Logs**: Navega los mensajes de la conversacion (sistema, usuario, asistente, herramienta)
+    * **Visualizador GenAI**: Selecciona un span de completado del chat para ver la conversacion renderizada
+
+### Entorno local (sin Dev Containers)
+
+Si ejecutas localmente sin Dev Containers, necesitas iniciar el Aspire Dashboard manualmente:
+
+1. Inicia el Aspire Dashboard:
 
     ```sh
-    docker logs aspire-dashboard
+    docker run --rm -it -d -p 18888:18888 -p 4317:18889 --name aspire-dashboard \
+        -e DASHBOARD__FRONTEND__AUTHMODE=Unsecured \
+        mcr.microsoft.com/dotnet/aspire-dashboard:latest
     ```
 
-    Busca la línea que contiene `Login to the dashboard at http://localhost:18888/login?t=<TOKEN>`. Copia el token o abre la URL directamente.
-
-3. Agrega el endpoint OTLP a tu archivo `.env`:
+2. Agrega el endpoint OTLP a tu archivo `.env`:
 
     ```sh
     OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
     ```
 
-4. Ejecuta el ejemplo:
+3. Ejecuta el ejemplo:
 
     ```sh
     uv run agent_otel_aspire.py
     ```
 
-5. Abre el dashboard en <http://localhost:18888> y explora:
-
-    * **Traces**: Ve el árbol completo de spans — invocación del agente → completado del chat → ejecución de herramientas
-    * **Metrics**: Consulta histogramas de uso de tokens y duración de operaciones
-    * **Structured Logs**: Navega los mensajes de la conversación (sistema, usuario, asistente, herramienta)
-    * **Visualizador GenAI**: Selecciona un span de completado del chat para ver la conversación renderizada
+4. Abre el dashboard en <http://localhost:18888> y explora.
 
-6. Cuando termines, detén el dashboard:
+5. Cuando termines, deten el dashboard:
 
     ```sh
     docker stop aspire-dashboard
     ```
 
-Para la guía completa de Python + Aspire, consulta [Usar el Aspire Dashboard con apps de Python](https://aspire.dev/dashboard/standalone-for-python/).
+Para la guia completa de Python + Aspire, consulta [Usar el Aspire Dashboard con apps de Python](https://aspire.dev/dashboard/standalone-for-python/).
 
 ## Recursos