You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/frontend/src/content/docs/deployment/environments.mdx
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ The Aspire environment is a single named value — like `Development`, `Staging`
14
14
15
15
The environment name flows through the system in three stages:
16
16
17
-
1.**Input**: You pass the environment name to the AppHost. Deployment commands such as `aspire deploy`, `aspire publish`, and `aspire do` expose `--environment` directly, and `aspire start`can forward it to the AppHost with `-- --environment <name>`.
17
+
1.**Input**: You pass the environment name to the AppHost. Deployment commands such as `aspire deploy`, `aspire publish`, and `aspire do` expose `--environment` directly, and `aspire start`also accepts `--environment <name>`.
18
18
2.**AppHost evaluation**: Your AppHost code reads the environment to branch logic, resolve parameters, or configure resources.
19
19
3.**Downstream configuration**: Your AppHost explicitly sets framework-specific environment variables (like `DOTNET_ENVIRONMENT` or `NODE_ENV`) on child resources as needed.
20
20
@@ -30,10 +30,10 @@ The environment name flows through the system in three stages:
30
30
31
31
### During local development
32
32
33
-
`aspire run` is a development-oriented command, so the AppHost runs in development mode by default. If you want to evaluate a different AppHost environment locally, start the AppHost explicitly and pass the environment through:
33
+
`aspire run` is a development-oriented command, so the AppHost runs in development mode by default. If you want to evaluate a different AppHost environment locally, start the AppHost explicitly and specify the environment:
34
34
35
35
```bash title="Start locally with a staging environment"
36
-
aspire start -- --environment Staging
36
+
aspire start --environment Staging
37
37
```
38
38
39
39
### During deployment
@@ -59,7 +59,7 @@ The environment name and the execution context are independent concepts:
59
59
| Environment |_Where_ is the app targeting? |`Development`|`Production`|
60
60
| Execution context |_How_ was the AppHost invoked? | Run mode | Publish mode |
61
61
62
-
You can start an AppHost locally with `aspire start -- --environment Staging` for validation, or publish to a `Development` cloud environment if your workflow needs that. The two axes are independent — environment names are arbitrary strings, not tied to run vs publish.
62
+
You can start an AppHost locally with `aspire start --environment Staging` for validation, or publish to a `Development` cloud environment if your workflow needs that. The two axes are independent — environment names are arbitrary strings, not tied to run vs publish.
0 commit comments