Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ The following options are available:

- **`--isolated`**

Run in isolated mode with randomized ports and isolated user secrets, allowing multiple instances of the same AppHost to run simultaneously. This is useful for parallel testing or comparing different configurations side-by-side.
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 is useful for parallel testing or comparing different configurations side-by-side.

This doesn't enable multiple concurrent instances from the same AppHost path. If an instance of the AppHost is already running from that path, `aspire run` stops it before starting the new one, with or without `--isolated`. `aspire run`, `aspire run --detach`, and `aspire start` all behave this way. When it stops an instance this way, `aspire run --isolated` without `--detach` also prints a warning that suggests running from a different directory.

- **`--no-build`**

Expand Down Expand Up @@ -159,9 +161,17 @@ The following options are available:
aspire run --detach --format Json
```

- Run in isolated mode for parallel testing:
- Run two copies of the same AppHost side by side, the second one from a Git worktree. A worktree contains only committed files, so commit your changes before you create it. In the repository's main checkout:

```bash title="Aspire CLI"
git worktree add ../my-app-feature
aspire run --isolated
```

Then, in a second terminal opened in the main checkout:

```bash title="Aspire CLI"
cd ../my-app-feature
aspire run --isolated
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,9 @@ The following options are available:

- **`--isolated`**

Run in isolated mode with randomized ports and isolated user secrets, allowing multiple instances of the same AppHost to run simultaneously.
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 doesn't enable multiple concurrent instances from the same AppHost path. If an instance of the AppHost is already running from that path, `aspire start` stops it before starting the new one, with or without `--isolated`. `aspire run`, `aspire run --detach`, and `aspire start` all behave this way.

- <Include relativePath="reference/cli/includes/option-help.md" />

Expand Down Expand Up @@ -139,10 +141,13 @@ The following options are available:
aspire start --format Json
```

- Start the AppHost in isolated mode:
- Start two copies of the same AppHost side by side, the second one from a Git worktree. A worktree contains only committed files, so commit your changes before you create it. From the repository's main checkout:

```bash title="Aspire CLI"
aspire start --isolated
git worktree add ../my-app-feature
cd ../my-app-feature
aspire start --isolated
```

- Start the AppHost with a specific environment:
Expand Down
Loading