Rewrite the non-Azure messaging integration articles (#1759)

* Initial bits * Fix images * More clean up * Fix MD error * Add keyed services * Simplify long API xref * Add a bit more detail * Address feedback * Update SVGs * Revert to yes/no icons * Link to management docker * Larger link * edit pass * Add details about run cmd * Add extension target * Correct example * Add a bit more detail about container * quick edit pass * Done * Rewrite Kafka * Fix xref * Rewrite NATS * Oops, remove copy/pasta * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Apply a bit more feedback to other content * add callout about bind mount vs volume --------- Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>
dotnet · Oct 10, 2024 · 16d500d · 16d500d
1 parent c6b9b6e
commit 16d500d
Show file tree

Hide file tree

Showing 62 changed files with 733 additions and 350 deletions.
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -263,6 +263,10 @@
  {
  "source_path_from_root": "/docs/extensibility/implement-auth-from-resource-to-integration.md",
  "redirect_url": "/dotnet/aspire/extensibility/secure-communication-between-integrations"
+ },
+ {
+ "source_path_from_root": "/docs/messaging/rabbitmq-client-integration.md",
+ "redirect_url": "/dotnet/aspire/messaging/rabbitmq-integration"
  }
  ]
 }
diff --git a/docfx.json b/docfx.json
@@ -106,14 +106,12 @@
  "docs/**/*.*": "IEvangelist",
  "docs/database/**/*.*": "CamSoper",
  "docs/storage/**/*.*": "CamSoper",
- "docs/messaging/**/*.*": "CamSoper",
  "docs/deployment/**/*.*": "CamSoper"
  },
  "ms.author": {
  "docs/**/*.*": "dapine",
  "docs/database/**/*.*": "casoper",
  "docs/storage/**/*.*": "casoper",
- "docs/messaging/**/*.*": "casoper",
  "docs/deployment/**/*.*": "casoper"
  },
  "ms.collection": {

diff --git a/docs/authentication/keycloak-integration.md b/docs/authentication/keycloak-integration.md
@@ -30,7 +30,7 @@ dotnet add package Aspire.Keycloak.Authentication
 
 ```xml
 <PackageReference Include="Aspire.Keycloak.Authentication"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -84,7 +84,7 @@ dotnet add package Aspire.Hosting.Keycloak
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Keycloak"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/azureai/azureai-openai-integration.md b/docs/azureai/azureai-openai-integration.md
@@ -28,7 +28,7 @@ dotnet add package Aspire.Azure.AI.OpenAI
 
 ```xml
 <PackageReference Include="Aspire.Azure.AI.OpenAI"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -66,7 +66,7 @@ dotnet add package Aspire.Hosting.Azure.CognitiveServices
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Azure.CognitiveServices"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/azureai/azureai-search-document-integration.md b/docs/azureai/azureai-search-document-integration.md
@@ -28,7 +28,7 @@ dotnet add package Aspire.Azure.Search.Documents
 
 ```xml
 <PackageReference Include="Aspire.Azure.Search.Documents"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -87,7 +87,7 @@ dotnet add package Aspire.Hosting.Azure.Search
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Azure.Search"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/caching/caching-integrations.md b/docs/caching/caching-integrations.md
@@ -55,7 +55,7 @@ Visual Studio creates a new .NET Aspire solution that consists of the following
 
  ```xml
  <PackageReference Include="Aspire.Hosting.Redis"
- Version="[SelectVersion]" />
+ Version="*" />
  ```
 
  ---

diff --git a/docs/caching/includes/garnet-app-host.md b/docs/caching/includes/garnet-app-host.md
@@ -10,7 +10,7 @@ dotnet add package Aspire.Hosting.Garnet
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Garnet"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/caching/includes/redis-app-host.md b/docs/caching/includes/redis-app-host.md
@@ -10,7 +10,7 @@ dotnet add package Aspire.Hosting.Redis
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Redis"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/caching/includes/valkey-app-host.md b/docs/caching/includes/valkey-app-host.md
@@ -10,7 +10,7 @@ dotnet add package Aspire.Hosting.Valkey
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Valkey"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/caching/stackexchange-redis-distributed-caching-integration.md b/docs/caching/stackexchange-redis-distributed-caching-integration.md
@@ -24,7 +24,7 @@ dotnet add package Aspire.StackExchange.Redis.DistributedCaching
 
 ```xml
 <PackageReference Include="Aspire.StackExchange.Redis.DistributedCaching"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/caching/stackexchange-redis-integration.md b/docs/caching/stackexchange-redis-integration.md
@@ -24,7 +24,7 @@ dotnet add package Aspire.StackExchange.Redis
 
 ```xml
 <PackageReference Include="Aspire.StackExchange.Redis"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/caching/stackexchange-redis-output-caching-integration.md b/docs/caching/stackexchange-redis-output-caching-integration.md
@@ -24,7 +24,7 @@ dotnet add package Aspire.StackExchange.Redis.OutputCaching
 
 ```xml
 <PackageReference Include="Aspire.StackExchange.Redis.OutputCache"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/azure-cosmos-db-entity-framework-integration.md b/docs/database/azure-cosmos-db-entity-framework-integration.md
@@ -23,7 +23,7 @@ dotnet add package Aspire.Microsoft.EntityFrameworkCore.Cosmos
 
 ```xml
 <PackageReference Include="Aspire.Microsoft.EntityFrameworkCore.Cosmos"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -63,7 +63,7 @@ dotnet add package Aspire.Hosting.Azure.CosmosDB
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Azure.CosmosDB"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/azure-cosmos-db-integration.md b/docs/database/azure-cosmos-db-integration.md
@@ -23,7 +23,7 @@ dotnet add package Aspire.Microsoft.Azure.Cosmos
 
 ```xml
 <PackageReference Include="Aspire.Microsoft.Azure.Cosmos"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -63,7 +63,7 @@ dotnet add package Aspire.Hosting.Azure.CosmosDB
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Azure.CosmosDB"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/includes/mysql-app-host.md b/docs/database/includes/mysql-app-host.md
@@ -10,7 +10,7 @@ dotnet add package Aspire.Hosting.MySql
 
 ```xml
 <PackageReference Include="Aspire.Hosting.MySql"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/includes/postgresql-app-host.md b/docs/database/includes/postgresql-app-host.md
@@ -10,7 +10,7 @@ dotnet add package Aspire.Hosting.PostgreSQL
 
 ```xml
 <PackageReference Include="Aspire.Hosting.PostgreSQL"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/includes/postgresql-flexible-server.md b/docs/database/includes/postgresql-flexible-server.md
@@ -12,7 +12,7 @@ dotnet add package Aspire.Hosting.Azure.PostgreSQL
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Azure.PostgreSQL"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/includes/sql-app-host.md b/docs/database/includes/sql-app-host.md
@@ -10,7 +10,7 @@ dotnet add package Aspire.Hosting.SqlServer
 
 ```xml
 <PackageReference Include="Aspire.Hosting.SqlServer"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/milvus-integration.md b/docs/database/milvus-integration.md
@@ -27,7 +27,7 @@ dotnet add package Aspire.Milvus.Client
 
 ```xml
 <PackageReference Include="Aspire.Milvus.Client"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -56,7 +56,7 @@ dotnet add package Aspire.Hosting.Milvus
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Milvus"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/mongodb-integration.md b/docs/database/mongodb-integration.md
@@ -32,7 +32,7 @@ dotnet add package Aspire.MongoDB.Driver
 
 ```xml
 <PackageReference Include="Aspire.MongoDB.Driver"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -72,7 +72,7 @@ dotnet add package Aspire.Hosting.MongoDB
 
 ```xml
 <PackageReference Include="Aspire.Hosting.MongoDB"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/mysql-entity-framework-integration.md b/docs/database/mysql-entity-framework-integration.md
@@ -22,7 +22,7 @@ dotnet add package Aspire.Pomelo.EntityFrameworkCore.MySql
 
 ```xml
 <PackageReference Include="Aspire.Pomelo.EntityFrameworkCore.MySql"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/mysql-integration.md b/docs/database/mysql-integration.md
@@ -31,7 +31,7 @@ dotnet add package Aspire.MySqlConnector
 
 ```xml
 <PackageReference Include="Aspire.MySqlConnector"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/oracle-entity-framework-integration.md b/docs/database/oracle-entity-framework-integration.md
@@ -22,7 +22,7 @@ dotnet add package Aspire.Oracle.EntityFrameworkCore
 
 ```xml
 <PackageReference Include="Aspire.Oracle.EntityFrameworkCore"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -71,7 +71,7 @@ dotnet add package Aspire.Hosting.Oracle
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Oracle"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/postgresql-entity-framework-integration.md b/docs/database/postgresql-entity-framework-integration.md
@@ -36,7 +36,7 @@ dotnet add package Aspire.Npgsql.EntityFrameworkCore.PostgreSQL
 
 ```xml
 <PackageReference Include="Aspire.Npgsql.EntityFrameworkCore.PostgreSQL"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/postgresql-integration.md b/docs/database/postgresql-integration.md
@@ -22,7 +22,7 @@ dotnet add package Aspire.Npgsql
 ### [PackageReference](#tab/package-reference)
 
 ```xml
-<PackageReference Include="Aspire.Npgsql" Version="[SelectVersion]" />
+<PackageReference Include="Aspire.Npgsql" Version="*" />
 ```
 
 ---

diff --git a/docs/database/qdrant-integration.md b/docs/database/qdrant-integration.md
@@ -23,7 +23,7 @@ dotnet add package Aspire.Qdrant.Client
 
 ```xml
 <PackageReference Include="Aspire.Qdrant.Client"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -61,7 +61,7 @@ dotnet add package Aspire.Hosting.Qdrant
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Qdrant"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/sql-server-entity-framework-integration.md b/docs/database/sql-server-entity-framework-integration.md
@@ -32,7 +32,7 @@ dotnet add package Aspire.Microsoft.EntityFrameworkCore.SqlServer
 
 ```xml
 <PackageReference Include="Aspire.Microsoft.EntityFrameworkCore.SqlServer"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/database/sql-server-integration.md b/docs/database/sql-server-integration.md
@@ -33,7 +33,7 @@ dotnet add package Aspire.Microsoft.Data.SqlClient
 
 ```xml
 <PackageReference Include="Aspire.Microsoft.Data.SqlClient"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/deployment/azure/application-insights.md b/docs/deployment/azure/application-insights.md
@@ -120,7 +120,7 @@ Add the following package to the `ServiceDefaults` project, so that it will be i
 
 ``` xml
 <PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" 
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 Add a using statement to the top of the project.

diff --git a/docs/deployment/azure/custom-bicep-templates.md b/docs/deployment/azure/custom-bicep-templates.md
@@ -29,7 +29,7 @@ dotnet add package Aspire.Hosting.Azure
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Azure"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/frameworks/dapr.md b/docs/frameworks/dapr.md
@@ -40,7 +40,7 @@ dotnet add package Aspire.Hosting.Dapr
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Dapr"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---
@@ -87,7 +87,7 @@ dotnet add package Dapr.AspNetCore
 
 ```xml
 <PackageReference Include="Dapr.AspNetCore"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---

diff --git a/docs/frameworks/orleans.md b/docs/frameworks/orleans.md
@@ -33,7 +33,7 @@ dotnet add package Aspire.Hosting.Orleans
 
 ```xml
 <PackageReference Include="Aspire.Hosting.Orleans"
- Version="[SelectVersion]" />
+ Version="*" />
 ```
 
 ---