Skip to content

Commit 4870404

Browse files
Merge pull request #47378 from CamSoper/component-2-integration
.NET Aspire terminology change
2 parents 5499a28 + fa0ea85 commit 4870404

File tree

65 files changed

+284
-284
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

65 files changed

+284
-284
lines changed

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/2-store-files-azure-blob-storage.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ uid: learn.azure-storage-dotnet-aspire-app.store-files-azure-blob-storage
33
title: Store files in Azure Blob Storage
44
metadata:
55
title: Store files in Azure Blob Storage
6-
description: In this unit, you'll learn how to store images, videos, and other files in the Azure Blob Storage service by adding the .NET Aspire Azure Blob Storage component.
6+
description: In this unit, you'll learn how to store images, videos, and other files in the Azure Blob Storage service by adding the .NET Aspire Azure Blob Storage integration.
77
author: camsoper
88
ms.author: casoper
99
ms.date: 8/20/2024

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/3-add-items-azure-storage-queues.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ uid: learn.azure-storage-dotnet-aspire-app.add-items-azure-storage-queues
33
title: Add items to Azure Storage Queues
44
metadata:
55
title: Add items to Azure Storage Queues
6-
description: In this unit, you'll learn how to add messages to, and receive messages from, the Azure Queue Storage service by using the .NET Aspire Azure Queue Storage component.
6+
description: In this unit, you'll learn how to add messages to, and receive messages from, the Azure Queue Storage service by using the .NET Aspire Azure Queue Storage integration.
77
author: camsoper
88
ms.author: casoper
99
ms.date: 8/20/2024

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/4-add-rows-azure-storage-tables.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ uid: learn.azure-storage-dotnet-aspire-app.add-rows-azure-storage-tables
33
title: Add rows to Azure Storage Tables
44
metadata:
55
title: Add rows to Azure Storage Tables
6-
description: In this unit, you'll learn how to use the Azure Storage Tables service as a repository for semi-structured data and how to access that data using the .NET Aspire Azure Data Tables component.
6+
description: In this unit, you'll learn how to use the Azure Storage Tables service as a repository for semi-structured data and how to access that data using the .NET Aspire Azure Data Tables integration.
77
author: camsoper
88
ms.author: casoper
99
ms.date: 8/20/2024
Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
Cloud-native applications consist of microservices, each of which implements a small part of the app's complete functionality and is independent of the others. Although each microservice is unique, it's common to need to store files or data. Additionally, to communicate robustly with other microservices, they often make use of message queues. Azure Storage includes services that can satisfy these requirements. It's easy to call those services by using out-of-the-box .NET Aspire components.
1+
Cloud-native applications consist of microservices, each of which implements a small part of the app's complete functionality and is independent of the others. Although each microservice is unique, it's common to need to store files or data. Additionally, to communicate robustly with other microservices, they often make use of message queues. Azure Storage includes services that can satisfy these requirements. It's easy to call those services by using out-of-the-box .NET Aspire integrations.
22

33
Imagine that you work for an outdoor equipment retailer. Your new public-facing eShop, which uses .NET Aspire, must store files, such as product images, and product metadata. You also want to queue messages for communications between microservices. You want to find out if Azure Storage is an efficient and scalable location for this information.
44

5-
In this module, you'll see how to use built-in components to access an Azure Storage account and store and retrieve files, data rows, and messages.
5+
In this module, you'll see how to use built-in integrations to access an Azure Storage account and store and retrieve files, data rows, and messages.
66

77
## Learning objectives
88

99
At the end of this module, you'll be able to:
1010

11-
- Use the .NET Aspire Azure Blob Storage component to store files.
12-
- Use the .NET Aspire Azure Storage Queues component to add messages to a queue.
13-
- Use the .NET Aspire Azure Table Storage component to add rows to a table.
11+
- Use the .NET Aspire Azure Blob Storage integration to store files.
12+
- Use the .NET Aspire Azure Storage Queues integration to add messages to a queue.
13+
- Use the .NET Aspire Azure Table Storage integration to add rows to a table.

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/includes/2-store-files-azure-blob-storage.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
In the outdoor equipment retailer you work for, your team is making good progress with the microservices for the new public-facing eShop. You've already decided to host the final app in Azure. Two separate teams have a need to store blobs: both high resolution photos and product demonstration videos. Now, you want to assess whether an Azure Storage account would be an optimal location to store these files.
44

5-
In this unit, you'll learn about the .NET Aspire Azure Blob Storage component and how it helps developers to store and retrieve blobs in Azure Storage accounts.
5+
In this unit, you'll learn about the .NET Aspire Azure Blob Storage integration and how it helps developers to store and retrieve blobs in Azure Storage accounts.
66

77
## What is an Azure Storage account?
88

@@ -15,7 +15,7 @@ Azure is Microsoft's industry leading cloud services solution and it includes ma
1515
You can use one, two, or all three of these services in a single storage account. If your organization uses Azure, you should consider Azure Storage as a simple and effective way to add these backing services to your cloud-native app.
1616

1717
> [!NOTE]
18-
> Azure Storage is only one solution you can use for message queuing, blob storage, and semi-structured data storage. For example, MongoDB and RabbitMQ provide data tables and message queues without requiring Azure. Within Azure you can choose Cosmos DB and Azure Service Bus instead. .NET Aspire includes components for all these services.
18+
> Azure Storage is only one solution you can use for message queuing, blob storage, and semi-structured data storage. For example, MongoDB and RabbitMQ provide data tables and message queues without requiring Azure. Within Azure you can choose Cosmos DB and Azure Service Bus instead. .NET Aspire includes integrations for all these services.
1919
2020
## Why use Azure Blob Storage?
2121

@@ -25,7 +25,7 @@ Azure Blob Storage is optimized to store large files or large numbers of files t
2525

2626
## Using Azure Blob Storage with .NET Aspire
2727

28-
.NET Aspire makes it easy to work with files in Azure Blob Storage by including the built-in **.NET Aspire Azure Blob Storage component**. This component registers a connected `BlobServiceClient` object in the dependency injection container maintained by the app host project. You can pass that client to any microservice in your solution and use it to store or retrieve files. .NET Aspire also configures health checks and telemetry for the Blob Storage client.
28+
.NET Aspire makes it easy to work with files in Azure Blob Storage by including the built-in **.NET Aspire Azure Blob Storage integration**. This integration registers a connected `BlobServiceClient` object in the dependency injection container maintained by the app host project. You can pass that client to any microservice in your solution and use it to store or retrieve files. .NET Aspire also configures health checks and telemetry for the Blob Storage client.
2929

3030
### Modifying the app host project
3131

@@ -35,7 +35,7 @@ Start by installing the `Aspire.Hosting.Azure.Storage` NuGet package:
3535
dotnet add package Aspire.Hosting.Azure.Storage
3636
```
3737

38-
Next, register the Azure Blob Storage component:
38+
Next, register the Azure Blob Storage integration:
3939

4040
```csharp
4141
var blobs = builder.AddAzureStorage("storage")
@@ -51,7 +51,7 @@ var catalogMicroservice = builder.AddProject<Projects.CatalogMicroservice>()
5151

5252
### Modifying the consuming projects
5353

54-
To use the Azure Blob Storage component in a microservice, first you must install it using the NuGet package manager, or the .NET CLI:
54+
To use the Azure Blob Storage integration in a microservice, first you must install it using the NuGet package manager, or the .NET CLI:
5555

5656
```dotnetcli
5757
dotnet add package Aspire.Azure.Storage.Blobs
@@ -153,6 +153,6 @@ if (builder.Environment.IsDevelopment())
153153

154154
- [Storage account overview](/azure/storage/common/storage-account-overview)
155155
- [Azure Blob Storage documentation](/azure/storage/blobs/)
156-
- [.NET Aspire Azure Blob Storage component](/dotnet/aspire/storage/azure-storage-blobs-component)
157-
- [Tutorial: Connect an ASP.NET Core app to .NET Aspire storage components](/dotnet/aspire/storage/azure-storage-components)
156+
- [.NET Aspire Azure Blob Storage integration](/dotnet/aspire/storage/azure-storage-blobs-integration)
157+
- [Tutorial: Connect an ASP.NET Core app to .NET Aspire storage integrations](/dotnet/aspire/storage/azure-storage-integrations)
158158
- [Use the Azurite emulator for local Azure Storage development](/azure/storage/common/storage-use-azurite)

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/includes/3-add-items-azure-storage-queues.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Azure Storage accounts don't only store blobs; they also enable developers to cr
22

33
In the outdoor equipment retailer you work for, two of your microservice teams have implemented Azure Storage accounts to serve blobs to users. However, stress testing has identified a potential issue with microservice communications at times of high load. You want to investigate whether queues in Azure Storage accounts can help resolve the problem.
44

5-
In this unit, you'll learn about the .NET Aspire Azure Queue Storage component and how you can use it to communicate between microservices in a cloud-native app.
5+
In this unit, you'll learn about the .NET Aspire Azure Queue Storage integration and how you can use it to communicate between microservices in a cloud-native app.
66

77
## Why use Azure Queue Storage?
88

@@ -22,7 +22,7 @@ If the destination microservice is temporarily unavailable, messages wait in the
2222
2323
## Using Azure Queue Storage with .NET Aspire
2424

25-
If you're using .NET Aspire to build a cloud-native app, you can add the **.NET Aspire Azure Queue Storage component** to work with Azure storage queues. The component registers a `QueueServiceClient` object in the dependency injection container maintained by the app host project. When you pass that object to consuming microservices, you can use it to create queues and send or receive messages.
25+
If you're using .NET Aspire to build a cloud-native app, you can add the **.NET Aspire Azure Queue Storage integration** to work with Azure storage queues. The integration registers a `QueueServiceClient` object in the dependency injection container maintained by the app host project. When you pass that object to consuming microservices, you can use it to create queues and send or receive messages.
2626

2727
### Modifying the app host Project
2828

@@ -32,7 +32,7 @@ As for the blob client, you must install the `Aspire.Hosting.Azure.Storage` pack
3232
dotnet add package Aspire.Hosting.Azure.Storage
3333
```
3434

35-
Then, register the Azure Queue Storage component:
35+
Then, register the Azure Queue Storage integration:
3636

3737
```csharp
3838
var queues = builder.AddAzureStorage("storage")
@@ -48,7 +48,7 @@ var catalogMicroservice = builder.AddProject<Projects.CatalogMicroservice>()
4848

4949
### Modifying the consuming projects
5050

51-
In a microservice where you want to send or receive messages, you must first install the component:
51+
In a microservice where you want to send or receive messages, you must first install the integration:
5252

5353
```dotnetcli
5454
dotnet add package Aspire.Azure.Storage.Queues
@@ -114,6 +114,6 @@ The string you pass to this method is the name of a connection string. You shoul
114114

115115
## Learn more
116116

117-
- [.NET Aspire Azure Queue Storage component](/dotnet/aspire/storage/azure-storage-queues-component)
117+
- [.NET Aspire Azure Queue Storage integration](/dotnet/aspire/storage/azure-storage-queues-integration)
118118
- [Azure Storage Queues client library for .NET](/dotnet/api/overview/azure/storage.queues-readme)
119119
- [Quickstart: Azure Queue Storage client library for .NET](/azure/storage/queues/storage-quickstart-queues-dotnet)

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/includes/4-add-rows-azure-storage-tables.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Another service included in Azure Storage accounts is Azure Table storage. In th
22

33
In the outdoor equipment retailer you work for, you're already using Azure Storage accounts in several microservices to store blobs and message queues. One microservice uses an SQL database for product information but you want to assess whether Azure Table storage is a better place to keep this data.
44

5-
In this unit, you'll learn about the .NET Aspire Azure Data Tables component and how you can implement it in a cloud-native app.
5+
In this unit, you'll learn about the .NET Aspire Azure Data Tables integration and how you can implement it in a cloud-native app.
66

77
## Why use Azure Storage Tables?
88

@@ -18,7 +18,7 @@ Azure Storage accounts include a NoSQL structured data storage solution called A
1818
1919
## Using Azure Table Storage with .NET Aspire
2020

21-
The choice of data store is usually made by each microservice development team. Each team may choose a different storage technology according to their requirements and preferences so your complete cloud-native app may use many different database technologies. If you build your cloud-native app by using .NET Aspire, then it's easy for each microservice to use Azure Storage Tables because they can use the .NET Aspire Azure Data Tables component.
21+
The choice of data store is usually made by each microservice development team. Each team may choose a different storage technology according to their requirements and preferences so your complete cloud-native app may use many different database technologies. If you build your cloud-native app by using .NET Aspire, then it's easy for each microservice to use Azure Storage Tables because they can use the .NET Aspire Azure Data Tables integration.
2222

2323
### Modifying the app host project
2424

@@ -28,7 +28,7 @@ In the app host project for your solution, you must install the `Aspire.Hosting.
2828
dotnet add package Aspire.Hosting.Azure.Storage
2929
```
3030

31-
Next, register the Azure Table Storage component:
31+
Next, register the Azure Table Storage integration:
3232

3333
```csharp
3434
var tables = builder.AddAzureStorage("storage")
@@ -160,6 +160,6 @@ The string you pass to this method is the name of a connection string. You shoul
160160

161161
## Learn more
162162

163-
- [.NET Aspire Azure Data Tables component](/dotnet/aspire/storage/azure-storage-tables-component)
163+
- [.NET Aspire Azure Data Tables integration](/dotnet/aspire/storage/azure-storage-tables-integration)
164164
- [What is Azure Table storage?](/azure/storage/tables/table-storage-overview)
165165
- [Azure Tables client library for .NET](/dotnet/api/overview/azure/data.tables-readme)

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/includes/5-exercise-add-items-azure-storage.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
In this exercise, you'll use the .NET Aspire Azure Queue Storage component to send a message to a queue.
1+
In this exercise, you'll use the .NET Aspire Azure Queue Storage integration to send a message to a queue.
22

33
> [!NOTE]
44
> Visual Studio includes the Azurite emulator. In this lab, you'll use this tool to emulate an Azure Storage account on your local computer.
@@ -120,7 +120,7 @@ Let's use `git` to obtain a sample app, which doesn't yet use Azure Storage:
120120
121121
## Add the Azure Storage backing service
122122
123-
Next, let's add the Azure Storage components to the .NET Aspire solution host project:
123+
Next, let's add the Azure Storage integrations to the .NET Aspire solution host project:
124124
125125
1. Start Visual Studio, and select **Open a project or solution**.
126126
1. Navigate to the folder where you cloned the project.
@@ -168,7 +168,7 @@ Next, let's add the Azure Storage components to the .NET Aspire solution host pr
168168
169169
## Store a message in a queue
170170
171-
Now, let's modify the **Catalog.API** project to use an Azure Storage Queue. You must start by installing the correct Aspire component:
171+
Now, let's modify the **Catalog.API** project to use an Azure Storage Queue. You must start by installing the correct Aspire integration:
172172
173173
1. In **Solution Explorer**, right-click the **Catalog.API** project, select **Add**, and then select **.NET Aspire package**.
174174
1. In the search textbox, at the end of the existing text, type **Storage**.
Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
Since microservices are frequently deployed to the cloud for production, Azure is a good fit to provide storage services for files, tables, and message queues. Azure Storage accounts can provide this functionality and .NET Aspire includes components that make it easy to connect to them and start storing and retrieving information. In this module, you've learned how to add the .NET Aspire Azure Storage components to your cloud-native application and written code that interacts with Azure Storage accounts.
1+
Since microservices are frequently deployed to the cloud for production, Azure is a good fit to provide storage services for files, tables, and message queues. Azure Storage accounts can provide this functionality and .NET Aspire includes integrations that make it easy to connect to them and start storing and retrieving information. In this module, you've learned how to add the .NET Aspire Azure Storage integrations to your cloud-native application and written code that interacts with Azure Storage accounts.
22

33
Now that you've completed this module, you can:
44

5-
- Use the .NET Aspire Azure Blob Storage component to store files.
6-
- Use the .NET Aspire Azure Storage Queues component to add messages to a queue.
7-
- Use the .NET Aspire Azure Table Storage component to add rows to a table.
5+
- Use the .NET Aspire Azure Blob Storage integration to store files.
6+
- Use the .NET Aspire Azure Storage Queues integration to add messages to a queue.
7+
- Use the .NET Aspire Azure Table Storage integration to add rows to a table.
88

99
## Learn more
1010

1111
- [.NET Aspire documentation](/dotnet/aspire/)
12-
- [.NET Aspire Azure Blob Storage component](/dotnet/aspire/storage/azure-storage-blobs-component)
13-
- [.NET Aspire Azure Queue Storage component](/dotnet/aspire/storage/azure-storage-queues-component)
14-
- [.NET Aspire Azure Data Tables component](/dotnet/aspire/storage/azure-storage-tables-component)
12+
- [.NET Aspire Azure Blob Storage integration](/dotnet/aspire/storage/azure-storage-blobs-integration)
13+
- [.NET Aspire Azure Queue Storage integration](/dotnet/aspire/storage/azure-storage-queues-integration)
14+
- [.NET Aspire Azure Data Tables integration](/dotnet/aspire/storage/azure-storage-tables-integration)

learn-pr/aspnetcore/azure-storage-dotnet-aspire-app/index.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
uid: learn.azure-storage-dotnet-aspire-app
33
metadata:
44
title: Use Azure Storage with .NET Aspire
5-
description: In this module, you'll learn about the components built into .NET Aspire that make it simple to store files, data, and messages in Azure Storage accounts.
5+
description: In this module, you'll learn about the integrations built into .NET Aspire that make it simple to store files, data, and messages in Azure Storage accounts.
66
author: camsoper
77
ms.author: casoper
88
manager: coxford
@@ -16,9 +16,9 @@ summary: Learn how to access and use Azure Storage accounts from .NET Aspire sol
1616
abstract: |
1717
By the end of this module, you'll be able to:
1818
19-
- Use the .NET Aspire Azure Blob Storage component to store files.
20-
- Use the .NET Aspire Azure Storage Queues component to add messages to a queue.
21-
- Use the .NET Aspire Azure Table Storage component to add rows to a table.
19+
- Use the .NET Aspire Azure Blob Storage integration to store files.
20+
- Use the .NET Aspire Azure Storage Queues integration to add messages to a queue.
21+
- Use the .NET Aspire Azure Table Storage integration to add rows to a table.
2222
ratingEnabled: true
2323
iconUrl: /learn/achievements/generic-badge.svg
2424
levels:

0 commit comments

Comments
 (0)