diff --git a/docs/database/azure-cosmos-db-component.md b/docs/database/azure-cosmos-db-component.md index 2fc95d9e93..d44f42ca2b 100644 --- a/docs/database/azure-cosmos-db-component.md +++ b/docs/database/azure-cosmos-db-component.md @@ -2,7 +2,7 @@ title: .NET Aspire Azure Cosmos DB component description: This article describes the .NET Aspire Azure Cosmos DB component features and capabilities. ms.topic: how-to -ms.date: 06/05/2024 +ms.date: 06/28/2024 --- # .NET Aspire Azure Cosmos DB component @@ -114,7 +114,7 @@ The recommended connection approach is to use an account endpoint, which works w ```json { "ConnectionStrings": { - "cosmosConnectionName": "https://{account_name}.documents.azure.com:443/" + "cosmosConnectionName": "https://{account_name}.documents.azure.com:443/" } } ``` diff --git a/docs/database/mysql-entity-framework-component.md b/docs/database/mysql-entity-framework-component.md index d97b2b88d0..2dead6bd4b 100644 --- a/docs/database/mysql-entity-framework-component.md +++ b/docs/database/mysql-entity-framework-component.md @@ -1,7 +1,7 @@ --- title: MySQL Entity Framework Component description: MySQL Entity Framework Component -ms.date: 06/05/2024 +ms.date: 06/28/2024 --- # .NET Aspire Pomelo MySQL Entity Framework Component @@ -94,7 +94,7 @@ And then the connection string will be retrieved from the `ConnectionStrings` co The `EnrichMySqlDbContext` won't make use of the `ConnectionStrings` configuration section since it expects a `DbContext` to be registered at the point it is called. -See the [MySqlConnector documentation](https://mysqlconnector.net/connection-options/) for more information on how to format this connection string. +For more information, see the [MySqlConnector documentation](https://mysqlconnector.net/connection-options/). ### Use configuration providers diff --git a/docs/database/oracle-entity-framework-component.md b/docs/database/oracle-entity-framework-component.md index a4c449866a..fcd77e6329 100644 --- a/docs/database/oracle-entity-framework-component.md +++ b/docs/database/oracle-entity-framework-component.md @@ -1,7 +1,7 @@ --- title: Oracle Entity Framework Component description: Oracle Entity Framework Component -ms.date: 06/03/2024 +ms.date: 06/28/2024 --- # .NET Aspire Oracle Entity Framework Component @@ -126,7 +126,7 @@ And then the connection string will be retrieved from the `ConnectionStrings` co The `EnrichOracleDatabaseDbContext` won't make use of the `ConnectionStrings` configuration section since it expects a `DbContext` to be registered at the point it is called. -See the [ODP.NET documentation](https://www.oracle.com/database/technologies/appdev/dotnet/odp.html) for more information on how to format this connection string. +For more information, see the [ODP.NET documentation](https://www.oracle.com/database/technologies/appdev/dotnet/odp.html). ### Use configuration providers diff --git a/docs/database/postgresql-component.md b/docs/database/postgresql-component.md index f74653455d..a4542ee893 100644 --- a/docs/database/postgresql-component.md +++ b/docs/database/postgresql-component.md @@ -1,7 +1,7 @@ --- title: .NET Aspire PostgreSQL component description: This article describes the .NET Aspire PostgreSQL component. -ms.date: 06/05/2024 +ms.date: 06/28/2024 ms.topic: how-to --- @@ -86,6 +86,8 @@ And then the connection string will be retrieved from the `ConnectionStrings` co } ``` +For more information, see the [ConnectionString](https://www.npgsql.org/doc/connection-string-parameters.html). + ### Use configuration providers The .NET Aspire PostgreSQL component supports . It loads the from _:::no-loc text="appsettings.json":::_ or other configuration files by using the `Aspire:Npgsql` key. Example _:::no-loc text="appsettings.json":::_ that configures some of the options: diff --git a/docs/database/postgresql-entity-framework-component.md b/docs/database/postgresql-entity-framework-component.md index e8f389c3d4..c0bac5d55d 100644 --- a/docs/database/postgresql-entity-framework-component.md +++ b/docs/database/postgresql-entity-framework-component.md @@ -2,7 +2,7 @@ title: .NET Aspire PostgreSQL Entity Framework Core component description: This article describes the .NET Aspire PostgreSQL Entity Framework Core component. ms.topic: how-to -ms.date: 06/05/2024 +ms.date: 06/28/2024 --- # .NET Aspire PostgreSQL Entity Framework Core component @@ -82,6 +82,28 @@ var myService = builder.AddProject() The .NET Aspire PostgreSQL Entity Framework Core component provides multiple configuration approaches and options to meet the requirements and conventions of your project. +### Use a connection string + +When using a connection string from the `ConnectionStrings` configuration section, you provide the name of the connection string when calling `AddNpgsqlDbContext`: + +```csharp +builder.AddNpgsqlDbContext("myConnection"); +``` + +The connection string is retrieved from the `ConnectionStrings` configuration section: + +```json +{ + "ConnectionStrings": { + "myConnection": "Host=myserver;Database=test" + } +} +``` + +The `EnrichNpgsqlDbContext` won't make use of the `ConnectionStrings` configuration section since it expects a `DbContext` to be registered at the point it is called. + +For more information, see the [ConnectionString](https://www.npgsql.org/doc/connection-string-parameters.html). + ### Use configuration providers The .NET Aspire PostgreSQL Entity Framework Core component supports . It loads the from configuration files such as _:::no-loc text="appsettings.json":::_ by using the `Aspire:Npgsql:EntityFrameworkCore:PostgreSQL` key. If you have set up your configurations in the `Aspire:Npgsql:EntityFrameworkCore:PostgreSQL` section you can just call the method without passing any parameter. @@ -115,7 +137,7 @@ builder.AddNpgsqlDbContext( static settings => settings.ConnectionString = "YOUR_CONNECTIONSTRING"); ``` -### Configure multiple DBContext classes +### Configure multiple DbContext classes If you want to register more than one with different configuration, you can use `$"Aspire:Npgsql:EntityFrameworkCore:PostgreSQL:{typeof(TContext).Name}"` configuration section name. The json configuration would look like: diff --git a/docs/database/sql-server-component.md b/docs/database/sql-server-component.md index 20c02b7ecb..d38329227f 100644 --- a/docs/database/sql-server-component.md +++ b/docs/database/sql-server-component.md @@ -2,7 +2,7 @@ title: .NET Aspire SQL Server component description: This article describes the .NET Aspire SQL Server component. ms.topic: how-to -ms.date: 06/05/2024 +ms.date: 06/28/2024 --- # .NET Aspire SQL Server component @@ -91,6 +91,26 @@ For more information, see [External parameters](../fundamentals/external-paramet The .NET Aspire SQL Server component provides multiple configuration approaches and options to meet the requirements and conventions of your project. +### Use a connection string + +When using a connection string from the `ConnectionStrings` configuration section, you provide the name of the connection string when calling `AddSqlServerClient`: + +```csharp +builder.AddSqlServerClient("myConnection"); +``` + +The connection string is retrieved from the `ConnectionStrings` configuration section: + +```json +{ + "ConnectionStrings": { + "myConnection": "Data Source=myserver;Initial Catalog=master" + } +} +``` + +For more information, see the [ConnectionString](/dotnet/api/system.data.sqlclient.sqlconnection.connectionstring#remarks). + ### Use configuration providers The .NET Aspire SQL Server supports . It loads the `MicrosoftDataSqlClientSettings` from configuration files such as _:::no-loc text="appsettings.json":::_ by using the `Aspire:SqlServer:SqlClient` key. If you have set up your configurations in the `Aspire:SqlServer:SqlClient` section, you can just call the method without passing any parameter. @@ -116,7 +136,7 @@ The following example shows an _:::no-loc text="appsettings.json":::_ file that You can also pass the `Action` delegate to set up some or all the options inline, for example to turn off the `DisableMetrics`: ```csharp -builder.AddSqlServerSqlClientConfig( +builder.AddSqlServerClient( static settings => settings.DisableMetrics = true); ``` @@ -139,10 +159,10 @@ If you want to add more than one `SqlConnection` you could use named instances. } ``` -To load the named configuration section from the json config call the `AddSqlServerSqlClientConfig` method by passing the `INSTANCE_NAME`. +To load the named configuration section from the json config call the `AddSqlServerClient` method by passing the `INSTANCE_NAME`. ```csharp -builder.AddSqlServerSqlClientConfig("INSTANCE_NAME"); +builder.AddSqlServerClient("INSTANCE_NAME"); ``` ### Configuration options diff --git a/docs/database/sql-server-entity-framework-component.md b/docs/database/sql-server-entity-framework-component.md index 1bee773280..555f83a655 100644 --- a/docs/database/sql-server-entity-framework-component.md +++ b/docs/database/sql-server-entity-framework-component.md @@ -2,7 +2,7 @@ title: .NET Aspire SqlServer Entity Framework Core component description: This article describes the .NET Aspire SQL Server Entity Framework Core component. ms.topic: how-to -ms.date: 06/05/2024 +ms.date: 06/28/2024 --- # .NET Aspire SqlServer Entity Framework Core component @@ -74,6 +74,28 @@ var myService = builder.AddProject() The .NET Aspire SQL Server Entity Framework Core component provides multiple configuration approaches and options to meet the requirements and conventions of your project. +### Use connection string + +When using a connection string from the `ConnectionStrings` configuration section, you provide the name of the connection string when calling `builder.AddSqlServerDbContext()`: + +```csharp +builder.AddSqlServerDbContext("myConnection"); +``` + +The connection string is retrieved from the `ConnectionStrings` configuration section: + +```json +{ + "ConnectionStrings": { + "myConnection": "Data Source=myserver;Initial Catalog=master" + } +} +``` + +The `EnrichSqlServerDbContext` won't make use of the `ConnectionStrings` configuration section since it expects a `DbContext` to be registered at the point it's called. + +For more information, see the [ConnectionString](/dotnet/api/system.data.sqlclient.sqlconnection.connectionstring#remarks). + ### Use configuration providers The .NET Aspire SQL Server Entity Framework Core component supports . It loads the from configuration files such as _:::no-loc text="appsettings.json":::_ by using the `Aspire:Microsoft:EntityFrameworkCore:SqlServer` key. If you have set up your configurations in the `Aspire:Microsoft:EntityFrameworkCore:SqlServer` section you can just call the method without passing any parameter. diff --git a/docs/messaging/media/vscode-select-worker.png b/docs/messaging/media/vscode-select-worker.png deleted file mode 100644 index c3e2e2de20..0000000000 Binary files a/docs/messaging/media/vscode-select-worker.png and /dev/null differ diff --git a/docs/reference/aspire-faq.yml b/docs/reference/aspire-faq.yml index e56b740d04..fa7d93937d 100644 --- a/docs/reference/aspire-faq.yml +++ b/docs/reference/aspire-faq.yml @@ -3,7 +3,7 @@ metadata: title: Frequently asked questions about .NET Aspire description: Answers to some of the most common questions and scenarios for .NET Aspire. ms.topic: faq - ms.date: 05/18/2024 + ms.date: 06/28/2024 title: Frequently asked questions about .NET Aspire summary: | This article lists frequently asked questions about .NET Aspire. For a more comprehensive overview, see [.NET Aspire overview](../get-started/aspire-overview.md). @@ -36,12 +36,8 @@ sections: - question: | Why is there a need for yet another framework to do what's already being done very well by everyone else? answer: | - .NET Aspire isn't a framework. Perhaps the most controversial parts of it are the `DistributedApplication` APIs that you can use to build up the orchestration model in any .NET-based language. While everything is possible today, it's not easy. Using the Unix philosophy, the entire cloud-native ecosystem is built around tying various pieces of CNCF software together to build a stack. .NET Aspire tries to do the same thing using learnings from the cloud-native space and picks some opinions (in ways that use the same building blocks). One novel thing about how .NET Aspire builds various pieces of the stack is that it doesn't restrict the access or compatibility of other applications, frameworks, or services. As people play with it more, they realize how composable and extensible it is. + .NET Aspire isn't a framework, it's an [opinionated stack](../get-started/aspire-overview.md). Perhaps the most controversial parts of it are the `DistributedApplication` APIs that you can use to build up the orchestration model in any .NET-based language. While everything is possible today, it's not easy. Using the Unix philosophy, the entire cloud-native ecosystem is built around tying various pieces of CNCF software together to build a stack. .NET Aspire tries to do the same thing using learnings from the cloud-native space and picks some opinions (in ways that use the same building blocks). One novel thing about how .NET Aspire builds various pieces of the stack is that it doesn't restrict the access or compatibility of other applications, frameworks, or services. As people play with it more, they realize how composable and extensible it is. - - question: | - When will .NET Aspire be released? - answer: | - .NET Aspire was [officially released](https://devblogs.microsoft.com/dotnet/dotnet-aspire-general-availability/) May 21st, 2024 to general availability (GA). Stay up to day with development and new releases on [official .NET Aspire repository](https://github.com/dotnet/aspire). - question: | What's the difference between .NET Aspire and Microsoft Orleans? answer: | @@ -50,6 +46,7 @@ sections: [Orleans](/dotnet/orleans) is a distributed actor-based framework. .NET Aspire is a cloud-ready stack for building observable, production-ready, distributed applications. It includes local orchestration capabilities to simplify the developer inner loop and reusable opinionated components for integrating with commonly used application dependencies. An Orleans-based solution will still have external dependencies such as data stores and caches for which .NET Aspire can be used for orchestration purposes. For more information, see [Use Orleans with .NET Aspire](../frameworks/orleans.md) and the corresponding [Orleans voting app sample](/samples/dotnet/aspire-samples/orleans-voting-sample-app-on-aspire/). + - question: | What's the difference between .NET Aspire and Dapr? answer: | @@ -58,6 +55,7 @@ sections: Where Dapr abstracts some of the underlying cloud platform, .NET Aspire provides opinionated configuration around the underlying cloud technologies without abstracting them. A .NET-based application that uses Dapr can use .NET Aspire to orchestrate the local developer inner loop and streamline deployment. .NET Aspire includes extensions that support the launching of Dapr side-car processes during the inner loop. For more information, see [Use Dapr with .NET Aspire](../frameworks/dapr.md) and the corresponding [Dapr sample app](https://github.com/dotnet/aspire-samples/tree/main/samples/AspireWithDapr) in the .NET Aspire sample repository. + - question: | What's the difference between .NET Aspire and Project Tye? answer: | @@ -65,25 +63,27 @@ sections: deployment into orchestrators such as Kubernetes. .NET Aspire is a superset of Tye which includes the orchestration and deployment capabilities along with opinionated components for integrating common cloud-native dependencies. .NET Aspire can be considered the evolution of the Project Tye experiment. + - question: | What's the relationship between .NET Aspire and the Azure SDK for .NET? answer: | .NET Aspire provides components that rely on the [Azure SDK for .NET](/dotnet/azure/intro), to expose common functionality for storage ([Azure Blob Storage](../storage/azure-storage-blobs-component.md), [Azure Storage Queues](../storage/azure-storage-queues-component.md), and [Azure Table Storage](../storage/azure-storage-tables-component.md)), databases ([Azure Cosmos DB](../database/azure-cosmos-db-component.md) and [Azure Cosmos DB with Entity Framework Core](../database/azure-cosmos-db-entity-framework-component.md)), [messaging](../messaging/azure-service-bus-component.md), and [security](../security/azure-security-key-vault-component.md). + - question: | What's the relationship between .NET Aspire and Kubernetes? answer: | .NET Aspire makes it easy to develop distributed applications that can be orchestrated on your local development environment as executables and containers. Kubernetes is a technology that orchestrates and manages containers across multiple machines. .NET Aspire projects can produce a [manifest](../deployment/manifest-format.md) that tool authors can use to produce artifacts for deployment to Kubernetes. In essence, Kubernetes is a deployment target for .NET Aspire projects. + - question: | Are worker services supported in .NET Aspire? answer: | - Due to a deployment related bug, preview 1 of .NET Aspire doesn't support deployment of worker services. + Yes, worker services are fully supported and there are docs and samples available to help you get started. Worker services are a great way to run background tasks, scheduled tasks, or long-running tasks in .NET Aspire. For more information, see [Database migrations with Entity Framework Core sample app](/samples/dotnet/aspire-samples/aspire-efcore-migrations/). - As a workaround consider deploying a web application as a worker which is not exposed to the internet. We are currently tracking this issue and plan to have it resolved for preview 2 (see [GitHub issue](https://github.com/dotnet/aspire/issues/743)). - question: | Are Azure Functions supported in .NET Aspire? answer: | - We have no specific support for Azure Functions in preview 1 of .NET Aspire however it's a target - execution environment for deployment that we are planning to support in future previews. + We have no specific support for Azure Functions thus far in .NET Aspire, however it's a target + execution environment for deployment that we are planning to support in future. additionalContent: | diff --git a/docs/whats-new/dotnet-docs-aspire-mod0.md b/docs/whats-new/dotnet-docs-aspire-mod0.md index 37e1ed3d13..0c5f6d2dd3 100644 --- a/docs/whats-new/dotnet-docs-aspire-mod0.md +++ b/docs/whats-new/dotnet-docs-aspire-mod0.md @@ -1,63 +1,191 @@ --- -title: ".NET Aspire docs: What's new for March 2024" -description: "What's new in the .NET Aspire docs for March 2024." -ms.custom: March-2024 -ms.date: 04/01/2024 +title: ".NET Aspire docs: What's new for June 2024" +description: "What's new in the .NET Aspire docs for June 2024." +ms.custom: June-2024 +ms.date: 07/01/2024 --- -# .NET Aspire docs: What's new for March 2024 +# .NET Aspire docs: What's new for June 2024 -Welcome to what's new in the .NET Aspire docs for March 2024. This article lists some of the major changes to docs during this period. +Welcome to what's new in the .NET Aspire docs for June 2024. This article lists some of the major changes to docs during this period. + +## Get started + +### Updated articles + +- [.NET Aspire overview](../get-started/aspire-overview.md) - purge app except app host +- [Add Node.js apps to a .NET Aspire project](../get-started/build-aspire-apps-with-nodejs.md) + - purge app except app host + - Update toc.yml - node.js app +- [Quickstart: Build your first .NET Aspire project](../get-started/build-your-first-aspire-app.md) + - Update build-your-first-aspire-app.md - app -> project + - Add details about trusting dev-cert +- [Tutorial: Add .NET Aspire to an existing .NET app](../get-started/add-aspire-existing-app.md) + - purge app except app host + - Remove .NET CLI command that was mistakenly included. + - Add external HTTP and update corresponding content. ## Fundamentals ### Updated articles -- [.NET Aspire setup and tooling](../fundamentals/setup-tooling.md) - Add details about container runtime -- [.NET Aspire orchestration overview](../fundamentals/app-host-overview.md) - Add details for shortcuts -- [.NET Aspire dashboard overview](../fundamentals/dashboard/overview.md) - Add details for shortcuts -- [Persist .NET Aspire project data using volumes](../fundamentals/persist-data-volumes.md) - Add details for shortcuts +- [.NET Aspire and launch profiles](../fundamentals/launch-profiles.md) - purge app except app host +- [.NET Aspire components overview](../fundamentals/components-overview.md) - purge app except app host +- [.NET Aspire dashboard overview](../fundamentals/dashboard/overview.md) - purge app except app host +- [.NET Aspire orchestration overview](../fundamentals/app-host-overview.md) + - purge app except app host + - Add missing code, and add flexible PostgreSQL + - Add details about container runtime args. +- [.NET Aspire setup and tooling](../fundamentals/setup-tooling.md) - purge app except app host +- [.NET Aspire telemetry](../fundamentals/telemetry.md) - purge app except app host +- [Explore the .NET Aspire dashboard](../fundamentals/dashboard/explore.md) + - purge app except app host + - Update cookie auth details. +- [Health checks in .NET Aspire](../fundamentals/health-checks.md) + - Fix OutputCache typos + - Add info about required middleware to health checks. +- [Persist .NET Aspire project data using volumes](../fundamentals/persist-data-volumes.md) - purge app except app host +- [Security considerations for running the .NET Aspire dashboard](../fundamentals/dashboard/security-considerations.md) - Update cookie auth details. +- [Testing .NET Aspire projects](../fundamentals/testing.md) - purge app except app host ## Storage ### Updated articles +- [.NET Aspire Azure Blob Storage component](../storage/azure-storage-blobs-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Azure Data Tables component](../storage/azure-storage-tables-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Azure Queue Storage component](../storage/azure-storage-queues-component.md) - Add missing code, and add flexible PostgreSQL - [Tutorial: Connect an ASP.NET Core app to .NET Aspire storage components](../storage/azure-storage-components.md) - - Added CLI path to storage - - add tags for azd content tracking -- [.NET Aspire Azure Blob Storage component](../storage/azure-storage-blobs-component.md) - Add details for shortcuts -- [.NET Aspire Azure Queue Storage component](../storage/azure-storage-queues-component.md) - Add details for shortcuts + - purge app except app host + - Minor clean up ## Database -### New articles +### Updated articles + +- [.NET Aspire Azure Cosmos DB component](../database/azure-cosmos-db-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Microsoft Entity Framework Core Cosmos DB component](../database/azure-cosmos-db-entity-framework-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire MongoDB database component](../database/mongodb-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire MySQL database component](../database/mysql-component.md) + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [.NET Aspire Oracle Entity Framework Component](../database/oracle-entity-framework-component.md) + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [.NET Aspire Pomelo MySQL Entity Framework Component](../database/mysql-entity-framework-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire PostgreSQL component](../database/postgresql-component.md) + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [.NET Aspire PostgreSQL Entity Framework Core component](../database/postgresql-entity-framework-component.md) + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [.NET Aspire Qdrant component](../database/qdrant-component.md) + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [.NET Aspire SQL Server component](../database/sql-server-component.md) + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [.NET Aspire SqlServer Entity Framework Core component](../database/sql-server-entity-framework-component.md) - Add missing code, and add flexible PostgreSQL +- [Apply Entity Framework Core migrations in .NET Aspire](../database/ef-core-migrations.md) - purge app except app host +- [Seed data in a database using .NET Aspire](../database/seed-database-data.md) - purge app except app host +- [Tutorial: Connect an ASP.NET Core app to SQL Server using .NET Aspire and Entity Framework Core](../database/sql-server-components.md) + - Fix code and content. + - purge app except app host +- [Tutorial: Deploy a .NET Aspire project with a SQL Server Database to Azure](../database/sql-server-component-deployment.md) - purge app except app host -- [Tutorial: Deploy a .NET Aspire project with a SQL Server Database to Azure](../database/sql-server-component-deployment.md) +## Messaging ### Updated articles -- [Tutorial: Connect an ASP.NET Core app to SQL Server using .NET Aspire and Entity Framework Core](../database/sql-server-components.md) - Sql server component deploy -- [.NET Aspire Azure Cosmos DB component](../database/azure-cosmos-db-component.md) - Add details for shortcuts -- [Seed data in a database using .NET Aspire](../database/seed-database-data.md) - Add details for shortcuts -- [.NET Aspire SQL Server component](../database/sql-server-component.md) - Add details for shortcuts +- [.NET Aspire Apache Kafka component](../messaging/kafka-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Azure Event Hubs component](../messaging/azure-event-hubs-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Azure Service Bus component](../messaging/azure-service-bus-component.md) + - Add missing code, and add flexible PostgreSQL + - Correct Service Bus tracing details. +- [.NET Aspire NATS component](../messaging/nats-component.md) - Add missing code, and add flexible PostgreSQL +- [.NET Aspire RabbitMQ component](../messaging/rabbitmq-client-component.md) + - Fix RabbitMQ docs usage of AddRabbitMQ for connection string based connection + - Add missing code, and add flexible PostgreSQL + - Adds parameters to app host usage examples, where applicable +- [Tutorial: Use .NET Aspire messaging components in ASP.NET Core](../messaging/messaging-components.md) + - purge app except app host + - Add VS Code bits and fix errors + +## Caching -## Messaging +### New articles + +- [Stack Exchange Redis caching overview](../caching/stackexchange-redis-caching-overview.md) ### Updated articles -- [Tutorial: Use .NET Aspire messaging components in ASP.NET Core](../messaging/messaging-components.md) - Add cli path to manage app +- [.NET Aspire Stack Exchange Redis component](../caching/stackexchange-redis-component.md) + - Add an overview of Stack Exchange Redis caching + - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Stack Exchange Redis distributed caching component](../caching/stackexchange-redis-distributed-caching-component.md) + - Matched the App host Redis reference to the consuming project + - Add an overview of Stack Exchange Redis caching + - Add missing code, and add flexible PostgreSQL +- [.NET Aspire Stack Exchange Redis output caching component](../caching/stackexchange-redis-output-caching-component.md) + - Add an overview of Stack Exchange Redis caching + - Add missing code, and add flexible PostgreSQL +- [Stack Exchange Redis caching overview](../caching/stackexchange-redis-caching-overview.md) + - purge app except app host + - Add an overview of Stack Exchange Redis caching +- [Tutorial: Deploy a .NET Aspire project with a Redis Cache to Azure](../caching/caching-components-deployment.md) + - purge app except app host + - Add an overview of Stack Exchange Redis caching +- [Tutorial: Implement caching with .NET Aspire components](../caching/caching-components.md) + - Add an overview of Stack Exchange Redis caching + - Update and correct hosting bits. + +## Security + +### Updated articles + +- [.NET Aspire Azure Key Vault component](../security/azure-security-key-vault-component.md) + - Add missing code, and add flexible PostgreSQL + - Update KeyVault usage documentation ## Deployment +### New articles + +- [Use custom Bicep templates](../deployment/azure/custom-bicep-templates.md) + +### Updated articles + +- [.NET Aspire deployments](../deployment/overview.md) - purge app except app host +- [.NET Aspire manifest format for deployment tool builders](../deployment/manifest-format.md) - purge app except app host +- [Deploy a .NET Aspire project to Azure Container Apps](../deployment/azure/aca-deployment.md) + - purge app except app host + - Add an include about resource naming. +- [Deploy a .NET Aspire project to Azure Container Apps using the Azure Developer CLI (in-depth guide)](../deployment/azure/aca-deployment-azd-in-depth.md) + - purge app except app host + - Add an include about resource naming. +- [Deploy a .NET Aspire project to Azure Container Apps using Visual Studio](../deployment/azure/aca-deployment-visual-studio.md) + - purge app except app host + - Add an include about resource naming. +- [Local Azure provisioning](../deployment/azure/local-provisioning.md) - Remove invalid trailing comma in config example +- [Tutorial: Deploy a .NET Aspire project using the Azure Developer CLI and GitHub Actions](../deployment/azure/aca-deployment-github-actions.md) + - purge app except app host + - Add an include about resource naming. +- [Use Application Insights for .NET Aspire telemetry](../deployment/azure/application-insights.md) - purge app except app host +- [Use custom Bicep templates](../deployment/azure/custom-bicep-templates.md) + - purge app except app host + - Add new article: Use custom Bicep templates + +## Reference + ### Updated articles -- [.NET Aspire manifest format for deployment tool builders](../deployment/manifest-format.md) - Add details for shortcuts -- [Deploy a .NET Aspire project to Azure Container Apps using the Azure Developer CLI (in-depth guide)](../deployment/azure/aca-deployment-azd-in-depth.md) - add tags for azd content tracking -- [Tutorial: Deploy a .NET Aspire project using the Azure Developer CLI and GitHub Actions](../deployment/azure/aca-deployment-github-actions.md) - add tags for azd content tracking -- [Deploy a .NET Aspire project to Azure Container Apps](../deployment/azure/aca-deployment.md) - add tags for azd content tracking +- [Frequently asked questions about .NET Aspire](../reference/aspire-faq.yml) + - purge app except app host + - update GA on aspire :) ## Community contributors The following people contributed to the .NET Aspire docs during this period. Thank you! Learn how to contribute by following the links under "Get involved" in the [what's new landing page](index.yml). -- [Alexanderbtw](https://github.com/Alexanderbtw) - Alexander ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [BaileyHewitt](https://github.com/BaileyHewitt) - ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) +- [willibrandon](https://github.com/willibrandon) - Brandon Williams ![1 pull requests.](https://img.shields.io/badge/Merged%20Pull%20Requests-1-green) diff --git a/docs/whats-new/index.yml b/docs/whats-new/index.yml index 8c2f0d96c0..d4a1185a86 100644 --- a/docs/whats-new/index.yml +++ b/docs/whats-new/index.yml @@ -5,7 +5,7 @@ summary: Welcome to what's new in .NET Aspire docs. Use this page to quickly fin metadata: title: .NET Aspire what's new? description: Learn about new and updated content in .NET Aspire docs. - ms.date: 06/01/2024 + ms.date: 07/01/2024 ms.topic: landing-page landingContent: - title: .NET Aspire release documentation @@ -50,12 +50,12 @@ landingContent: linkLists: - linkListType: whats-new links: + - text: June 2024 + url: dotnet-docs-aspire-mod0.md - text: May 2024 url: dotnet-docs-aspire-mod2.md - text: April 2024 url: dotnet-docs-aspire-mod1.md - - text: March 2024 - url: dotnet-docs-aspire-mod0.md - title: Find language updates linkLists: - linkListType: whats-new diff --git a/docs/whats-new/toc.yml b/docs/whats-new/toc.yml index 229b73f215..867fd47d92 100644 --- a/docs/whats-new/toc.yml +++ b/docs/whats-new/toc.yml @@ -44,9 +44,9 @@ items: - name: Latest documentation updates expanded: true items: + - name: June 2024 + href: dotnet-docs-aspire-mod0.md - name: May 2024 href: dotnet-docs-aspire-mod2.md - name: April 2024 href: dotnet-docs-aspire-mod1.md - - name: March 2024 - href: dotnet-docs-aspire-mod0.md