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

Aperta Adatta ai principianti
#2,184 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
github, markdown
Ambito
cli, documentation

Direzione di ricerca

Leggi src/frontend/src/content/docs/reference/cli/commands/aspire-run.mdx e aspire-start.mdx, quindi confronta le descrizioni di --isolated con il chiarimento correlato di microsoft/aspire. Spiega il requisito di usare directory diverse, il comportamento quando i percorsi coincidono e le eventuali differenze tra run, start e run --detach; includi un esempio comparativo supportato. Il lavoro è concluso quando entrambe le pagine di riferimento trattano chiaramente questi punti con una formulazione coerente.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
MDX
Stelle
202
Fork
99
Merge medio
3g 22h
PR unite (30g)
138

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di microsoft/aspire.dev

Tutte le issue di microsoft/aspire.dev

Issue simili

Altre issue su CLI

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.