Clarify worktree and same-path behavior for --isolated in the CLI reference

Abierto Apto para principiantes
#2,184 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github, markdown

Línea de trabajo

Lee src/frontend/src/content/docs/reference/cli/commands/aspire-run.mdx y aspire-start.mdx y luego compara sus descripciones de --isolated con la aclaración relacionada de microsoft/aspire. Explica el requisito de usar directorios distintos, el comportamiento cuando las rutas son iguales y cualquier diferencia entre run, start y run --detach; incluye un ejemplo comparativo respaldado. La tarea estará completa cuando ambas páginas de referencia traten estos puntos con claridad y una redacción coherente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

documentation

Clarify worktree and same-path behavior for --isolated in the CLI reference

Target: microsoft/aspire.dev

The --isolated descriptions on both reference pages say:

Run in isolated mode with randomized ports and isolated user secrets, allowing multiple instances of the same AppHost to run simultaneously.

Neither explains that those instances must come from different directories, such as separate worktrees/checkouts. That intended contract has now been confirmed.

In a local test, aspire start --apphost apphost.cs --isolated --no-build --non-interactive --format Json stopped the existing VS Code-debugged instance at that path before starting its replacement. This was on macOS with Aspire SDK 17.0.0. We haven't separately reproduced two concurrent foreground aspire run --isolated commands.

Update both reference pages:

  • Say that parallel isolated runs require copies of the same AppHost in different directories, typically separate worktrees/checkouts.
  • Explain what happens when the same command is repeated from the same path.
  • Distinguish run, start, and run --detach if their behavior differs.
  • Include a concrete supported side-by-side example.

Suggested wording:

Run with randomized ports and isolated user secrets, allowing copies of the same AppHost in different directories, such as separate Git worktrees, to run simultaneously. This does not enable multiple concurrent instances from the same AppHost path.

These pages contain their own checked-in descriptions in:

  • src/frontend/src/content/docs/reference/cli/commands/aspire-run.mdx
  • src/frontend/src/content/docs/reference/cli/commands/aspire-start.mdx

Updating CLI help alone won't update this prose. Keep the wording aligned with the corresponding microsoft/aspire clarification.

Related CLI-help follow-up: microsoft/aspire#22344 covers the command help wording.

Lenguaje dominante
MDX
Estrellas
202
Forks
99
Merge medio
3 d 22 h
PR fusionados (30 d)
138

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de microsoft/aspire.dev

Todos los issues de microsoft/aspire.dev

Issues similares

Más issues de CLI

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.