diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index 56cf860a06..91ea140ec5 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -1,7 +1,7 @@ --- title: .NET Aspire tooling description: Learn about essential tooling concepts for .NET Aspire. -ms.date: 03/29/2024 +ms.date: 04/02/2024 --- # .NET Aspire setup and tooling @@ -134,6 +134,8 @@ There are currently four project templates available: - **.NET Aspire App Host**: A standalone **.AppHost** project that can be used to orchestrate and manage the different projects and services of your app. +- **.NET Aspire Text Project (xUnit)**: + - **.NET Aspire Service Defaults**: A standalone **.ServiceDefaults** project that can be used to manage configurations that are reused across the projects in your solution related to [resilience](/dotnet/core/resilience/http-resilience), [service discovery](../service-discovery/overview.md), and [telemetry](./telemetry.md). > [!IMPORTANT] @@ -160,12 +162,13 @@ When the .NET Aspire workload is installed, you'll see the following .NET Aspire ```Output These templates matched your input: 'aspire' -Template Name Short Name Language Tags -------------------------------- ---------------------- -------- ------------------------------------------------------- -.NET Aspire App Host aspire-apphost [C#] Common/.NET Aspire/Cloud -.NET Aspire Application aspire [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service -.NET Aspire Service Defaults aspire-servicedefaults [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service -.NET Aspire Starter Application aspire-starter [C#] Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud +Template Name Short Name Language Tags +-------------------------------- ---------------------- -------- ------------------------------------------------------- +.NET Aspire App Host aspire-apphost [C#] Common/.NET Aspire/Cloud +.NET Aspire Application aspire [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service +.NET Aspire Service Defaults aspire-servicedefaults [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service +.NET Aspire Starter Application aspire-starter [C#] Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud +.NET Aspire Test Project (xUnit) aspire-xunit [C#] Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test ``` To create a .NET Aspire project using the .NET CLI, use the `dotnet new` command and specify which template you would like to create. diff --git a/docs/media/aspire-templates.png b/docs/media/aspire-templates.png index 8ef9f79464..5c6eebbf78 100644 Binary files a/docs/media/aspire-templates.png and b/docs/media/aspire-templates.png differ diff --git a/docs/whats-new/preview-5.md b/docs/whats-new/preview-5.md index 8305ac80b3..2e4ccb9724 100644 --- a/docs/whats-new/preview-5.md +++ b/docs/whats-new/preview-5.md @@ -28,37 +28,43 @@ In preview 5. our primary focus has been on non-functional requirements around s ### Security Updates Communication has been secured across the following endpoints: - - OTLP - - Dashboard - - Resource Server -#### OTLP Endpoint Security -The OTLP endpoint can be secured with [client certificate](https://learn.microsoft.com/aspnet/core/security/authentication/certauth) or API key authentication. +- OTLP +- Dashboard +- Resource Server + +#### OTLP endpoint security + +The OTLP endpoint can be secured with [client certificate](/aspnet/core/security/authentication/certauth) or API key authentication. - `Otlp:AuthMode` specifies the authentication mode on the OTLP endpoint. Possible values are `Certificate`, `ApiKey`, `Unsecured`. This configuration is required. - `Otlp:ApiKey` specifies the API key for the OTLP endpoint when API key authentication is enabled. This configuration is required for API key authentication. - -#### Dashboard Authentication + +#### Dashboard authentication + The dashboard's web application frontend supports OpenID Connect (OIDC) for authentication. These can be applied via configurable settings, once Frontend:AuthMode is set to OpenIdConnect: - `Authentication:Schemes:OpenIdConnect:Authority` — URL to the identity provider (IdP) - `Authentication:Schemes:OpenIdConnect:ClientId` — Identity of the relying party (RP) - `Authentication:Schemes:OpenIdConnect:ClientSecret`— A secret that only the real RP would know -- Other properties of [`OpenIdConnectOptions`](https://learn.microsoft.com/dotnet/api/microsoft.aspnetcore.builder.openidconnectoptions) specified in configuration container `Authentication:Schemes:OpenIdConnect:*` +- Other properties of [`OpenIdConnectOptions`](/dotnet/api/microsoft.aspnetcore.builder.openidconnectoptions) specified in configuration container `Authentication:Schemes:OpenIdConnect:*` -#### Resource Server Endpoint Security +#### Resource server endpoint security + The resource server client supports client certificates. This can be applied via configurable settings, once ResourceServiceClient:AuthMode to Certificate + - `ResourceServiceClient:ClientCertificate:Source` (required) one of: - `File` to load the cert from a file path, configured with: - `ResourceServiceClient:ClientCertificate:FilePath` (required, string) - `ResourceServiceClient:ClientCertificate:Password` (optional, string) - `KeyStore` to load the cert from a key store, configured with: - `ResourceServiceClient:ClientCertificate:Subject` (required, string) - - `ResourceServiceClient:ClientCertificate:KeyStore:Name` (optional, [`StoreName`](https://learn.microsoft.com/dotnet/api/system.security.cryptography.x509certificates.storename), defaults to `My`) - - `ResourceServiceClient:ClientCertificate:KeyStore:Location` (optional, [`StoreLocation`](https://learn.microsoft.com/dotnet/api/system.security.cryptography.x509certificates.storelocation), defaults to `CurrentUser`) -- `ResourceServiceClient:Ssl` (optional, [`SslClientAuthenticationOptions`](https://learn.microsoft.com/dotnet/api/system.net.security.sslclientauthenticationoptions)) - -### Performance Improvements + - `ResourceServiceClient:ClientCertificate:KeyStore:Name` (optional, [`StoreName`](/dotnet/api/system.security.cryptography.x509certificates.storename), defaults to `My`) + - `ResourceServiceClient:ClientCertificate:KeyStore:Location` (optional, [`StoreLocation`](/dotnet/api/system.security.cryptography.x509certificates.storelocation), defaults to `CurrentUser`) +- `ResourceServiceClient:Ssl` (optional, [`SslClientAuthenticationOptions`](/dotnet/api/system.net.security.sslclientauthenticationoptions)) + +### Performance improvements + - LOTS of performance improvements - Console log virtualization - Load time improvements