Skip to content

Commit aec2cd6

Browse files
authored
.NET Aspire -> Aspire (#49078)
1 parent 1cd57b3 commit aec2cd6

File tree

23 files changed

+67
-83
lines changed

23 files changed

+67
-83
lines changed

docs/ai/quickstarts/includes/ai-templates-github-models.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ To authenticate to GitHub models from your code, you'll need to [create a GitHub
9191
The **AI Chat Web App** is almost ready to go as soon as it's created. However, you need to configure the app to use the personal access token you set up for GitHub Models. By default, the app template searches for this value in the project's local .NET user secrets. You can manage user secrets using either the Visual Studio UI or the .NET CLI.
9292
9393
> [!NOTE]
94-
> If you enabled .NET Aspire for your app, skip to the [.NET Aspire configuration](#net-aspire-configuration) section.
94+
> If you enabled Aspire for your app, skip to the [Aspire configuration](#aspire-configuration) section.
9595
9696
## [Visual Studio](#tab/configure-visual-studio)
9797
@@ -117,9 +117,9 @@ The **AI Chat Web App** is almost ready to go as soon as it's created. However,
117117
118118
---
119119
120-
### .NET Aspire configuration
120+
### Aspire configuration
121121
122-
To use the **AI Chat Web App** template with .NET Aspire orchestration, add the following configurations:
122+
To use the **AI Chat Web App** template with Aspire orchestration, add the following configurations:
123123
124124
#### [Visual Studio](#tab/configure-visual-studio-aspire)
125125

docs/architecture/maui/introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Below is a high-level overview of the architecture of the sample application.
6060

6161
The sample application ships with:
6262

63-
- .NET Aspire App Hosting & Orchestration
63+
- Aspire App Hosting & Orchestration
6464
- An Blazor web application developed with ASP.NET Core.
6565
- A multi-platform app developed with .NET MAUI, which supports iOS, Android, macOS via Mac Catalyst, and Windows.
6666

@@ -71,7 +71,7 @@ The sample application includes the following backend services:
7171
- An ordering microservice, which is a domain-driven service that uses domain-driven design patterns.
7272
- A basket microservice, which is a data-driven CRUD service that uses Redis Cache.
7373

74-
These backend services are implemented as microservices using ASP.NET Core, and are deployed as unique containers with .NET Aspire. Collectively, these backend services are referred to as the eShop reference application. Client apps communicate with the backend services through a Representational State Transfer (REST) web interface. For more information about microservices and containers, see [Containerized microservices](micro-services.md).
74+
These backend services are implemented as microservices using ASP.NET Core, and are deployed as unique containers with Aspire. Collectively, these backend services are referred to as the eShop reference application. Client apps communicate with the backend services through a Representational State Transfer (REST) web interface. For more information about microservices and containers, see [Containerized microservices](micro-services.md).
7575

7676
## Multi-Platform app
7777

docs/azure/index.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,10 +74,10 @@ conceptualContent:
7474
links:
7575
- itemType: overview
7676
url: /dotnet/aspire/get-started/aspire-overview
77-
text: Build cloud native apps using .NET Aspire
77+
text: Build cloud native apps using Aspire
7878
- itemType: quickstart
7979
url: /dotnet/aspire/get-started/build-your-first-aspire-app?tabs=visual-studio
80-
text: Build your first .NET Aspire app
80+
text: Build your first Aspire app
8181
- itemType: quickstart
8282
text: Run and debug a microservice in Kubernetes
8383
url: /azure/dev-spaces/quickstart-netcore-visualstudio

docs/breadcrumb/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ items:
2525
- name: Azure
2626
tocHref: /dotnet/azure/
2727
topicHref: /dotnet/azure/index
28-
- name: .NET Aspire
28+
- name: Aspire
2929
tocHref: /dotnet/aspire/
3030
topicHref: /dotnet/aspire/index
3131
- name: Orleans

docs/core/apps.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.custom: "updateeachrelease"
1111

1212
## Cloud apps
1313

14-
* [.NET Aspire](/dotnet/aspire)
14+
* [Aspire](/dotnet/aspire)
1515
* [Serverless functions](/azure/azure-functions/functions-create-first-function-vs-code?pivots=programming-language-csharp)
1616
* [Web and microservices](/aspnet/core/introduction-to-aspnet-core#recommended-learning-path)
1717

docs/core/diagnostics/observability-otlp-example.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.custom: sfi-image-nochange
1010

1111
This is one of a series of examples to illustrate [.NET observability with OpenTelemetry](./observability-with-otel.md).
1212

13-
In addition to being a standard part of .NET Aspire, the Aspire Dashboard is available as a [standalone docker container](/dotnet/aspire/fundamentals/dashboard/standalone?tabs=powershell), which provides an OTLP endpoint telemetry can be sent to, and it will visualize the logs, metrics and traces. Using the dashboard in this way has no dependency on .NET Aspire, it will visualize telemetry from any application sending it telemetry via OTLP. It works equally well for applications written in Java, GoLang, Python etc. provided that they can send their telemetry to an OTLP endpoint.
13+
In addition to being a standard part of Aspire, the Aspire Dashboard is available as a [standalone docker container](/dotnet/aspire/fundamentals/dashboard/standalone?tabs=powershell), which provides an OTLP endpoint telemetry can be sent to, and it will visualize the logs, metrics and traces. Using the dashboard in this way has no dependency on Aspire, it will visualize telemetry from any application sending it telemetry via OTLP. It works equally well for applications written in Java, GoLang, Python etc. provided that they can send their telemetry to an OTLP endpoint.
1414

1515
Using the Aspire Dashboard has less configuration and setup steps than using Open Source solutions such as [Prometheus, Grafana and Jaeger](./observability-prgrja-example.md), but unlike those tools, the Aspire Dashboard is intended as a developer visualization tool, and not for production monitoring.
1616

docs/core/diagnostics/observability-with-otel.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -95,27 +95,27 @@ This topic is continued with a couple of example walkthroughs for using OpenTele
9595
- [Example: Use OpenTelemetry with Azure Monitor and Application Insights](./observability-applicationinsights.md)
9696
- [Example: Use OpenTelemetry with Prometheus, Grafana, and Jaeger](./observability-prgrja-example.md)
9797

98-
## OpenTelemetry in .NET Aspire
98+
## OpenTelemetry in Aspire
9999

100-
[.NET Aspire](/dotnet/aspire/get-started/aspire-overview) is a set of extensions to .NET to make it easy to create and work with distributed applications. One of the benefits of using .NET Aspire is that telemetry is built in, using the OpenTelemetry libraries for .NET. The default project templates for .NET Aspire contain a `ServiceDefaults` project, part of which is to setup and configure OTel. The Service Defaults project is referenced and initialized by each service in a .NET Aspire solution.
100+
[Aspire](/dotnet/aspire/get-started/aspire-overview) is a set of extensions to .NET to make it easy to create and work with distributed applications. One of the benefits of using Aspire is that telemetry is built in, using the OpenTelemetry libraries for .NET. The default project templates for Aspire contain a `ServiceDefaults` project, part of which is to setup and configure OTel. The Service Defaults project is referenced and initialized by each service in an Aspire solution.
101101

102-
The Service Defaults project template includes the OTel SDK, ASP.NET, HttpClient and Runtime Instrumentation packages, and those are configured in the [`Extensions.cs`](https://github.com/dotnet/aspire/blob/main/src/Aspire.ProjectTemplates/templates/aspire-servicedefaults/9.5/Extensions.cs) file. For exporting telemetry .NET Aspire includes the OTLP exporter by default so that it can provide telemetry visualization using the Aspire Dashboard.
102+
The Service Defaults project template includes the OTel SDK, ASP.NET, HttpClient and Runtime Instrumentation packages, and those are configured in the [`Extensions.cs`](https://github.com/dotnet/aspire/blob/main/src/Aspire.ProjectTemplates/templates/aspire-servicedefaults/9.5/Extensions.cs) file. For exporting telemetry, Aspire includes the OTLP exporter by default so that it can provide telemetry visualization using the Aspire Dashboard.
103103

104-
The Aspire Dashboard is designed to bring telemetry observation to the local debug cycle, which enables developers to not only ensure that the applications are producing telemetry, but also use that telemetry to diagnose those applications locally. Being able to observe the calls between services is proving to be just as useful at debug time as in production. The .NET Aspire dashboard is launched automatically when you F5 the `AppHost` Project from Visual Studio or `dotnet run` the `AppHost` project.
104+
The Aspire Dashboard is designed to bring telemetry observation to the local debug cycle, which enables developers to not only ensure that the applications are producing telemetry, but also use that telemetry to diagnose those applications locally. Being able to observe the calls between services is proving to be just as useful at debug time as in production. The Aspire dashboard is launched automatically when you <kbd>F5</kbd> the `AppHost` Project from Visual Studio or `dotnet run` the `AppHost` project.
105105

106106
[![Aspire Dashboard](./media/aspire-dashboard-thumb.png)](./media/aspire-dashboard.png#lightbox)
107107

108-
For more details on .NET Aspire see:
108+
For more details on Aspire see:
109109

110110
- [Aspire Overview](/dotnet/aspire/get-started/aspire-overview)
111111
- [Telemetry in Aspire](/dotnet/aspire/fundamentals/telemetry)
112112
- [Aspire Dashboard](/dotnet/aspire/fundamentals/dashboard/explore)
113113

114-
### Reusing Service Defaults project without .NET Aspire Orchestration
114+
### Reuse Service Defaults project without Aspire Orchestration
115115

116-
Probably the easiest way to configure OTel for ASP.NET projects is to use the Aspire Service Defaults project, even if not using the rest of .NET Aspire such as the AppHost for orchestration. The Service Defaults project is available as a project template via Visual Studio or `dotnet new`. It configures OTel and sets up the OTLP exporter. You can then use the [OTel environment variables](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/src/OpenTelemetry.Exporter.OpenTelemetryProtocol#exporter-configuration) to configure the OTLP endpoint to send telemetry to, and provide the resource properties for the application.
116+
Probably the easiest way to configure OTel for ASP.NET projects is to use the Aspire Service Defaults project, even if not using the rest of Aspire such as the AppHost for orchestration. The Service Defaults project is available as a project template via Visual Studio or `dotnet new`. It configures OTel and sets up the OTLP exporter. You can then use the [OTel environment variables](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/src/OpenTelemetry.Exporter.OpenTelemetryProtocol#exporter-configuration) to configure the OTLP endpoint to send telemetry to, and provide the resource properties for the application.
117117

118-
The steps to use *ServiceDefaults* outside .NET Aspire are:
118+
The steps to use *ServiceDefaults* outside Aspire are:
119119

120120
- Add the *ServiceDefaults* project to the solution using Add New Project in Visual Studio, or use `dotnet new aspire-servicedefaults --output ServiceDefaults`.
121121
- Reference the *ServiceDefaults* project from your ASP.NET application. In Visual Studio use **Add** > **Project Reference** and select the *ServiceDefaults* project.
@@ -132,8 +132,8 @@ app.MapGet("/", () => "Hello World!");
132132
app.Run();
133133
```
134134

135-
Service Defaults can setup the following additional functionality if required via `AddServiceDefaults()` or the specific functions:
135+
Service Defaults can set up the following additional functionality, if required, via `AddServiceDefaults()` or the specific functions:
136136

137-
- Health checks with `/health` and `/alive` endpoints
138-
- Service discovery which will be a no-op without the rest of .NET Aspire
139-
- Configuring resilience for HttpClient which will retry the request in the case of failures
137+
- Health checks with `/health` and `/alive` endpoints.
138+
- Service discovery, which will be a no-op without the rest of Aspire.
139+
- Configuring resilience for `HttpClient`, which retries requests in the case of failures.

docs/core/extensions/generic-host.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ When you call either <xref:Microsoft.Extensions.Hosting.IHostBuilder.Build?displ
131131

132132
If you're building for the web or writing a distributed application, you might need to use a different host builder. Consider the following list of additional host builders:
133133

134-
- <xref:Aspire.Hosting.DistributedApplicationBuilder>: A builder for creating distributed apps. For more information, see [.NET Aspire](/dotnet/aspire).
134+
- <xref:Aspire.Hosting.DistributedApplicationBuilder>: A builder for creating distributed apps. For more information, see [Aspire](/dotnet/aspire).
135135
- <xref:Microsoft.AspNetCore.Builder.WebApplicationBuilder>: A builder for web applications and services. For more information, see [ASP.NET Core](/aspnet/core).
136136
- <xref:Microsoft.AspNetCore.Hosting.WebHostBuilder>: A builder for `IWebHost`. For more information, see [ASP.NET Core web host](/aspnet/core/fundamentals/host/web-host).
137137

docs/core/extensions/service-discovery.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -153,4 +153,4 @@ If service discovery was added to the host using the `AddServiceDiscoveryCore` e
153153

154154
## See also
155155

156-
- [Service discovery in .NET Aspire](/dotnet/aspire/service-discovery/overview)
156+
- [Service discovery in Aspire](/dotnet/aspire/service-discovery/overview)

docs/core/project-sdk/msbuild-props.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1509,7 +1509,7 @@ For more information, see [Enable or disable extensions](../testing/unit-testing
15091509

15101510
When you use the [MSTest project SDK](../testing/unit-testing-mstest-sdk.md), you can use the `EnableAspireTesting` property to bring in all the dependencies and default `using` directives you need for testing with `Aspire` and `MSTest`. This property is available in MSTest 3.4 and later versions.
15111511

1512-
For more information, see [Test with .NET Aspire](../testing/unit-testing-mstest-sdk.md#test-with-net-aspire).
1512+
For more information, see [Test with Aspire](../testing/unit-testing-mstest-sdk.md#test-with-aspire).
15131513

15141514
### EnablePlaywright
15151515

0 commit comments

Comments
 (0)