Aspire Azure Blob Storage 集成

包含： - Client 集成

Azure Blob Storage 是用于存储大量非结构化数据的服务。 通过 AspireAzure Blob Storage 集成，可以连接到现有 Azure Blob Storage 实例，或从 .NET 应用程序创建新实例。

托管集成

存储AspireAzure托管集成将各种存储资源建模为以下类型：

• AzureStorageResource：表示 Azure 存储资源。
• AzureStorageEmulatorResource：表示 Azure 存储模拟器资源（Azurite）。
• AzureBlobStorageResource：表示 Azure Blob 存储资源。
• AzureQueueStorageResource：表示 Azure 队列存储资源。
• AzureTableStorageResource：是 Azure 表存储资源的代表。

若要访问这些类型和 API 来表达它们，请添加 .📦AspireHosting.Azure.AppHost 项目中的存储 NuGet 包。

dotnet add package Aspire.Hosting.Azure.Storage

<PackageReference Include="Aspire.Hosting.Azure.Storage"
                  Version="*" />

有关详细信息，请参阅 dotnet add package 或 在.NET 应用程序中管理包依赖项。

添加 Azure 存储资源

在 AppHost 项目中，调用 AddAzureStorage 添加并返回 Azure 存储资源生成器。

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage");

// An Azure Storage resource is required to add any of the following:
//
// - Azure Blob storage resource.
// - Azure Queue storage resource.
// - Azure Table storage resource.

// After adding all resources, run the app...

向 AppHost 添加 a AzureStorageResource 时，它会公开其他有用的 API 来添加 Azure Blob、队列和表存储资源。 换句话说，在添加任何其他存储资源之前，必须添加 AzureStorageResource。

连接到现有 Azure 存储帐户

您可能已有一个现有的 Azure 存储帐户需要连接。 可以链式调用以标注 AzureStorageResource 是现有资源。

var builder = DistributedApplication.CreateBuilder(args);

var existingStorageName = builder.AddParameter("existingStorageName");
var existingStorageResourceGroup = builder.AddParameter("existingStorageResourceGroup");

var storageaccount = builder.AddAzureStorage("storage")
                    .AsExisting(existingStorageName, existingStorageResourceGroup)
                    .AddBlobs("blobs");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(storageaccount);

// After adding all resources, run the app...

有关将 Azure 存储资源视为现有资源的详细信息，请参阅 “使用现有 Azure 资源”。

添加 Azure 存储模拟器资源

若要添加 Azure 存储模拟器资源，请将对 IResourceBuilder<AzureStorageResource> 的调用链接到 RunAsEmulator API：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage")
                     .RunAsEmulator();

// After adding all resources, run the app...

调用 RunAsEmulator时，它将存储资源配置为使用模拟器在本地运行。 在本例中，模拟器为 Azurite。 Azurite 开源模拟器为测试你的 Azure Blob、队列存储和表存储应用提供了一个免费的本地环境，是 AspireAzure 托管集成的理想选择。 Azurite 未安装，而是可作为 Aspire 容器访问。 将容器添加到 AppHost 时，如前面的示例 mcr.microsoft.com/azure-storage/azurite 所示，该映像会在 AppHost 启动时创建并启动容器。 有关详细信息，请参阅 容器资源生命周期。

配置 Azurite 容器

容器资源可以使用各种配置，例如，可以配置容器的端口、环境变量、 生存期等。

配置 Azurite 容器端口

默认情况下，Azurite 容器在配置 Aspire时公开以下终结点：

默认情况下，他们正在侦听的端口是动态的。 容器启动时，端口将映射到主机上的随机端口。 若要配置终结点端口，请对 RunAsEmulator 方法提供的容器资源生成器进行链式调用，如以下示例所示：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithBlobPort(27000)
                                .WithQueuePort(27001)
                                .WithTablePort(27002);
                     });

// After adding all resources, run the app...

前面的代码将 Azurite 容器的现有 blob、queue和 table 终结点分别配置为侦听端口 27000、27001和 27002。 Azurite 容器的端口映射到主机端口，如下表所示：

配置持久生存期的 Azurite 容器

若要使用持久性生存期配置 Azurite 容器，请在 Azurite 容器资源上调用 WithLifetime 方法，并传递 ContainerLifetime.Persistent：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithLifetime(ContainerLifetime.Persistent);
                     });

// After adding all resources, run the app...

有关详细信息，请参阅 容器资源生存期。

使用数据卷配置 Azurite 容器

若要将数据卷添加到 Azure 存储模拟器资源，请在 WithDataVolume 存储模拟器资源上调用 Azure 方法：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithDataVolume();
                     });

// After adding all resources, run the app...

数据卷用于在容器生命周期之外保留 Azurite 数据。 数据卷装载在 Azurite 容器中的 /data 路径，如果未提供 name 参数，则名称的格式为 .azurite/{resource name}。 有关数据卷以及它们为何优于绑定装载的信息，请参阅Docker文档：卷。

配置 Azurite 容器，使用数据绑定挂载

若要将数据绑定挂载添加到 Azure 存储仿真器资源，请调用 WithDataBindMount 方法：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithDataBindMount("../Azurite/Data");
                     });

// After adding all resources, run the app...

数据绑定挂载依赖主机文件系统，以便在容器重启时持久化 Azurite 数据。 数据绑定装载安装在 ../Azurite/Data 主机上相对于 Azurite 容器中的 AppHost 目录 （IDistributedApplicationBuilder.AppHostDirectory） 的路径上。 有关数据绑定装载的详细信息，请参阅 Docker 文档：绑定装载。

连接到存储资源

Aspire运行 AppHost 时，外部工具（如Azure存储资源管理器）可以访问存储资源。 如果存储资源在本地运行并使用 Azurite，Azure 存储资源管理器会自动检测到它。

若要从 Azure 存储资源管理器连接到存储资源，请执行以下步骤：

1. 运行Aspire AppHost。

2. 打开 Azure 存储资源管理器。

3. 查看 资源管理器 窗格。

4. 选择“ 刷新所有 ”链接以刷新存储帐户列表。

5. 展开 模拟器和附加 节点。

6. 展开 “存储帐户 ”节点。

7. 您应该看到一个以您的资源名称为前缀的存储帐户。

   

可以使用 Azure 存储资源管理器免费浏览存储帐户及其内容。 有关使用 Azure 存储资源管理器的详细信息，请参阅 存储资源管理器入门。

添加 Azure Blob Storage 资源

在 AppHost 项目中，通过链接对Azure Blob Storage返回AddBlobs的实例的IResourceBuilder<IAzureStorageResource>调用来注册AddAzureStorage集成。 以下示例演示如何添加名为 Azure Blob Storage 的 storage 资源，以及名为 blobs的 blob 容器：

var builder = DistributedApplication.CreateBuilder(args);

var blobs = builder.AddAzureStorage("storage")
                   .RunAsEmulator()
                   .AddBlobs("blobs");

builder.AddProject<Projects.ExampleProject>()
       .WithReference(blobs)
       .WaitFor(blobs);

// After adding all resources, run the app...

前面的代码：

• 添加名为 Azure的 storage 存储资源。
• 将对 RunAsEmulator 的调用链接起来，以配置存储资源，使其能够通过模拟器在本地运行。 在本例中，模拟器为 Azurite。
• 将名为 blobs 的 blob 容器添加到存储资源。
• 将 blobs 资源添加到 ExampleProject，并在启动项目之前等待它准备就绪。

由预配生成的 Bicep

如果你不熟悉 Bicep，则它是用于定义 Azure 资源的特定于域的语言。 使用 Aspire时，无需手动编写 Bicep，而是预配 API 会为你生成 Bicep。 发布应用时，生成的 Bicep 会与清单文件一起输出。 添加 Azure 存储资源时，将生成以下的 Bicep 代码：

@description('The location for the resource(s) to be deployed.')
param location string = resourceGroup().location

resource storage 'Microsoft.Storage/storageAccounts@2024-01-01' = {
  name: take('storage${uniqueString(resourceGroup().id)}', 24)
  kind: 'StorageV2'
  location: location
  sku: {
    name: 'Standard_GRS'
  }
  properties: {
    accessTier: 'Hot'
    allowSharedKeyAccess: false
    minimumTlsVersion: 'TLS1_2'
    networkAcls: {
      defaultAction: 'Allow'
    }
  }
  tags: {
    'aspire-resource-name': 'storage'
  }
}

output blobEndpoint string = storage.properties.primaryEndpoints.blob

output queueEndpoint string = storage.properties.primaryEndpoints.queue

output tableEndpoint string = storage.properties.primaryEndpoints.table

output name string = storage.name

前面的 Bicep 是一个模块，它预配了具有以下默认值的 Azure 存储帐户：

• kind：存储帐户的类型。 默认值为 StorageV2。
• sku：存储帐户的 SKU。 默认值为 Standard_GRS。
• properties：存储帐户的属性：
  • accessTier：存储帐户的访问层。 默认值为 Hot。
  • allowSharedKeyAccess：一个布尔值，该值指示存储帐户是否允许使用帐户访问密钥授权请求。 默认值为 false。
  • minimumTlsVersion：存储帐户支持的最低 TLS 版本。 默认值为 TLS1_2。
  • networkAcls：存储账户的网络 ACL。 默认值为 { defaultAction: 'Allow' }。

除了存储帐户，它还预配 Blob 容器。

以下角色分配将添加到存储帐户，以授予应用程序访问权限。 有关详细信息，请参阅 内置的基于 Azure 角色的访问控制（Azure RBAC）角色 ：

此外，在单独的模块中为 Azure 资源创建角色分配：

@description('The location for the resource(s) to be deployed.')
param location string = resourceGroup().location

param storage_outputs_name string

param principalType string

param principalId string

resource storage 'Microsoft.Storage/storageAccounts@2024-01-01' existing = {
  name: storage_outputs_name
}

resource storage_StorageBlobDataContributor 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(storage.id, principalId, subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'ba92f5b4-2d11-453d-a403-e96b0029c9fe'))
  properties: {
    principalId: principalId
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'ba92f5b4-2d11-453d-a403-e96b0029c9fe')
    principalType: principalType
  }
  scope: storage
}

resource storage_StorageTableDataContributor 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(storage.id, principalId, subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '0a9a7e1f-b9d0-4cc4-a60d-0319b160aaa3'))
  properties: {
    principalId: principalId
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '0a9a7e1f-b9d0-4cc4-a60d-0319b160aaa3')
    principalType: principalType
  }
  scope: storage
}

resource storage_StorageQueueDataContributor 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(storage.id, principalId, subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '974c5e8b-45b9-4653-ba55-5f855dd0fb88'))
  properties: {
    principalId: principalId
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '974c5e8b-45b9-4653-ba55-5f855dd0fb88')
    principalType: principalType
  }
  scope: storage
}

生成的 Bicep 作为起点，受 C# 中资源配置基础设施更改的影响。 直接对 Bicep 文件的自定义项所做的更改将被覆盖，因此请通过 C# 预配 API 进行更改，以确保它们反映在生成的文件中。

自定义预配基础结构

所有 AspireAzure 资源都是 AzureProvisioningResource 类型的子类。 此类型允许通过使用 Azure API 所提供的 fluent API 来配置 ConfigureInfrastructure<T>(IResourceBuilder<T>, Action<AzureResourceInfrastructure>) 资源，从而自定义生成的 Bicep。 例如，可以配置 kind、sku、properties等。 以下示例演示如何自定义 Azure 存储资源：

builder.AddAzureStorage("storage")
    .ConfigureInfrastructure(infra =>
    {
        var storageAccount = infra.GetProvisionableResources()
                                  .OfType<StorageAccount>()
                                  .Single();

        storageAccount.AccessTier = StorageAccountAccessTier.Cool;
        storageAccount.Sku = new StorageSku { Name = StorageSkuName.PremiumZrs };
        storageAccount.Tags.Add("ExampleKey", "Example value");
    });

前面的代码：

• 将调用连接到 ConfigureInfrastructure 应用程序接口。
  • infra 参数是 AzureResourceInfrastructure 类型的实例。
  • 通过调用 GetProvisionableResources() 方法检索可预配资源。
  • 单个 StorageAccount 被获取。
  • StorageAccount.AccessTier 被分配给 StorageAccountAccessTier.Cool。
  • StorageAccount.Sku 被分配给一个新的 StorageSku，其 Name 为 PremiumZrs。
  • 标记将添加到存储帐户中，其密钥为 ExampleKey，值为 Example value。

还有更多配置选项可用于自定义 Azure 存储资源。 有关详细信息，请参阅 Azure.Provisioning.Storage。

添加 Azure 存储模拟器资源

若要添加 Azure 存储模拟器资源，请将对 IResourceBuilder<AzureStorageResource> 的调用链接到 RunAsEmulator API：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage")
                     .RunAsEmulator();

// After adding all resources, run the app...

调用 RunAsEmulator时，它将存储资源配置为使用模拟器在本地运行。 在本例中，模拟器为 Azurite。 Azurite 开源模拟器为测试你的 Azure Blob、队列存储和表存储应用提供了一个免费的本地环境，是 AspireAzure 托管集成的理想选择。 未安装 Azurite;可以将其作为容器进行访问 Aspire 。 将容器添加到 AppHost 时，如前面的示例 mcr.microsoft.com/azure-storage/azurite 所示，该映像会在 AppHost 启动时创建并启动容器。 有关详细信息，请参阅 容器资源生命周期。

配置 Azurite 容器

容器资源可以使用各种配置，例如，可以配置容器的端口、环境变量、 生存期等。

配置 Azurite 容器端口

默认情况下，当通过 Aspire 配置时，Azurite 容器会暴露以下终结点：

默认情况下，他们正在侦听的端口是动态的。 容器启动时，端口将映射到主机上的随机端口。 若要配置终结点端口，请对 RunAsEmulator 方法提供的容器资源生成器进行链式调用，如以下示例所示：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithBlobPort(27000)
                                .WithQueuePort(27001)
                                .WithTablePort(27002);
                     });

// After adding all resources, run the app...

前面的代码将 Azurite 容器的现有 blob、queue和 table 终结点分别配置为侦听端口 27000、27001和 27002。 Azurite 容器的端口映射到主机端口，如下表所示：

配置持久生存期的 Azurite 容器

若要使用持久性生存期配置 Azurite 容器，请在 Azurite 容器资源上调用 WithLifetime 方法，并传递 ContainerLifetime.Persistent：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithLifetime(ContainerLifetime.Persistent);
                     });

// After adding all resources, run the app...

有关详细信息，请参阅 容器资源生存期。

使用数据卷配置 Azurite 容器

若要将数据卷添加到 Azure 存储模拟器资源，请在 WithDataVolume 存储模拟器资源上调用 Azure 方法：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithDataVolume();
                     });

// After adding all resources, run the app...

数据卷用于在容器生命周期之外保留 Azurite 数据。 数据卷装载在 Azurite 容器中的 /data 路径，如果未提供 name 参数，则名称的格式为 .azurite/{resource name}。 有关数据卷以及它们为何优于绑定装载的信息，请参阅Docker文档：卷。

配置 Azurite 容器，使用数据绑定挂载

若要将数据绑定挂载添加到 Azure 存储仿真器资源，请调用 WithDataBindMount 方法：

var builder = DistributedApplication.CreateBuilder(args);

var storage = builder.AddAzureStorage("storage").RunAsEmulator(
                     azurite =>
                     {
                         azurite.WithDataBindMount("../Azurite/Data");
                     });

// After adding all resources, run the app...

数据绑定挂载依赖主机文件系统，以便在容器重启时持久化 Azurite 数据。 数据绑定装载安装在 ../Azurite/Data 主机上相对于 Azurite 容器中的 AppHost 目录 （IDistributedApplicationBuilder.AppHostDirectory） 的路径上。 有关数据绑定装载的详细信息，请参阅 Docker 文档：绑定装载。

连接到现有 Azure 存储帐户

您可能已有一个现有的 Azure 存储帐户需要连接。 可以向 AppHost 添加连接字符串，而不是表示新的 Azure 存储资源。 若要将连接添加到现有 Azure 存储帐户，请调用 AddConnectionString 方法：

var builder = DistributedApplication.CreateBuilder(args);

var blobs = builder.AddConnectionString("blobs");

builder.AddProject<Projects.WebApplication>("web")
       .WithReference(blobs);

// After adding all resources, run the app...

连接字符串在 AppHost 的配置中配置，通常位于“ 用户机密”部分下 ConnectionStrings 。 AppHost 将此连接字符串作为环境变量注入到所有依赖资源中，例如：

{
    "ConnectionStrings": {
        "blobs": "https://{account_name}.blob.core.windows.net/"
    }
}

依赖资源可以通过调用 GetConnectionString 方法并传递连接名称作为参数来访问注入的连接字符串，在本例中为 "blobs"。 GetConnectionString API 是 IConfiguration.GetSection("ConnectionStrings")[name]的简写。

连接到存储资源

Aspire运行 AppHost 时，外部工具（如Azure存储资源管理器）可以访问存储资源。 如果存储资源在本地运行并使用 Azurite，Azure 存储资源管理器会自动检测到它。

若要从 Azure 存储资源管理器连接到存储资源，请执行以下步骤：

1. 运行Aspire应用程序主机。

2. 打开 Azure 存储资源管理器。

3. 查看 资源管理器 窗格。

4. 选择“ 刷新所有 ”链接以刷新存储帐户列表。

5. 展开 模拟器和附加 节点。

6. 展开 “存储帐户 ”节点。

7. 您应该看到一个以您的资源名称为前缀的存储帐户。

   

可以使用 Azure 存储资源管理器免费浏览存储帐户及其内容。 有关使用 Azure 存储资源管理器的详细信息，请参阅 存储资源管理器入门。

托管集成运行状况检查

Azure 存储托管集成会自动为存储资源添加运行状况检查。 仅当以模拟器模式运行时才会添加此功能，并会验证 Azurite 容器正在运行以及与其的连接可以建立。 托管集成依赖于 📦 AspNetCore.HealthChecks.Azure。Storage.Blobs NuGet 包。

Client 集成

若要开始 AspireAzure Blob Storage 客户端集成，请在使用 📦 客户端的项目中安装 Aspire 的 NuGet 包，即用于该应用程序的项目。 Azure Blob Storage 客户端集成会注册一个 BlobServiceClient 实例，该实例可用于与 Azure Blob Storage交互。

dotnet add package Aspire.Azure.Storage.Blobs

<PackageReference Include="Aspire.Azure.Storage.Blobs"
                  Version="*" />

添加 Azure Blob Storage 客户端

在客户端使用项目的 Program.cs 文件中，对任何 AddAzureBlobClient 调用 IHostApplicationBuilder 扩展方法，以注册 BlobServiceClient，以便通过依赖项注入容器使用。 该方法采用连接名称参数。

builder.AddAzureBlobClient("blobs");

然后，可以使用依赖项注入检索 BlobServiceClient 实例。 例如，若要从服务检索客户端：

public class ExampleService(BlobServiceClient client)
{
    // Use client...
}

Configuration

Aspire Azure Blob Storage 集成提供了多个选项，用于根据项目的要求和约定配置 BlobServiceClient。

使用连接字符串

使用 ConnectionStrings 配置部分中的连接字符串时，可以在调用 AddAzureBlobClient时提供连接字符串的名称：

builder.AddAzureBlobClient("blobs");

然后，从 ConnectionStrings 配置部分检索连接字符串，支持两种连接格式：

服务统一资源标识符 (URI)

建议的方法是使用 ServiceUri，它与 AzureStorageBlobsSettings.Credential 属性配合以建立连接。 如果未配置凭据，则使用 Azure.Identity.DefaultAzureCredential。

{
  "ConnectionStrings": {
    "blobs": "https://{account_name}.blob.core.windows.net/"
  }
}

连接字符串

或者， Azure 可以使用存储连接字符串 。

{
  "ConnectionStrings": {
    "blobs": "AccountName=myaccount;AccountKey=myaccountkey"
  }
}

有关详细信息，请参阅 配置 Azure 存储连接字符串。

使用配置提供程序

Aspire Azure Blob Storage 集成支持 Microsoft.Extensions.Configuration。 它从配置中使用 AzureStorageBlobsSettings 键加载 BlobClientOptions 和 Aspire:Azure:Storage:Blobs。 以下代码片段是一个配置某些选项的 appsettings.json 文件示例：

{
  "Aspire": {
    "Azure": {
      "Storage": {
        "Blobs": {
          "DisableHealthChecks": true,
          "DisableTracing": false,
          "ClientOptions": {
            "Diagnostics": {
              "ApplicationId": "myapp"
            }
          }
        }
      }
    }
  }
}

有关完整的 Azure Blob Storage 客户端集成 JSON 架构，请参阅 Aspire.Azure.Storage.Blobs/ConfigurationSchema.json。

使用命名配置

集成 AspireAzure Blob Storage 支持命名配置，通过该配置，可以使用不同的设置来配置同一资源类型的多个实例。 命名配置使用连接名称作为主配置部分下的密钥。

{
  "Aspire": {
    "Azure": {
      "Storage": {
        "Blobs": {
          "blob1": {
            "DisableHealthChecks": true,
            "ClientOptions": {
              "Diagnostics": {
                "ApplicationId": "myapp1"
              }
            }
          },
          "blob2": {
            "DisableTracing": true,
            "ClientOptions": {
              "Diagnostics": {
                "ApplicationId": "myapp2"
              }
            }
          }
        }
      }
    }
  }
}

在此示例中，当调用blob1时，可以使用blob2和AddAzureBlobClient作为连接名称。

builder.AddAzureBlobClient("blob1");
builder.AddAzureBlobClient("blob2");

命名配置优先于顶级配置。 如果同时提供这两种设置，则命名配置中的设置将替代顶级设置。

使用内联委托

还可以传递 Action<AzureStorageBlobsSettings> configureSettings 委托直接设置一些或所有选项，例如配置健康检查：

builder.AddAzureBlobClient(
    "blobs",
    settings => settings.DisableHealthChecks = true);

您还可以通过使用 BlobClientOptions 委托（作为 Action<IAzureClientBuilder<BlobServiceClient, BlobClientOptions>> configureClientBuilder 方法的第二个参数）来设置 AddAzureBlobClient。 例如，为了设置此客户端发出的所有请求的用户代理标头的第一部分：

builder.AddAzureBlobClient(
    "blobs",
    configureClientBuilder: clientBuilder =>
        clientBuilder.ConfigureOptions(
            options => options.Diagnostics.ApplicationId = "myapp"));

Client 集成健康检查

默认情况下，Aspire 集成为所有服务启用 健康检查。 有关详细信息，请参阅 Aspire 集成概述。

Aspire Azure Blob Storage 的集成：

• 在 AzureStorageBlobsSettings.DisableHealthChecks 为 false时，添加运行状况检查，尝试连接到 Azure Blob Storage。
• 与 /health HTTP 终结点集成，该终结点规定所有已注册的健康检查必须通过，应用才被视为可接受流量。

可观测性和遥测

Aspire 集成会自动设置日志记录、跟踪和指标配置，这些配置有时称为 可观测性支柱。 有关集成可观测性和遥测的详细信息，请参阅 Aspire 集成概述。 根据支持服务，某些集成可能仅支持其中一些功能。 例如，某些集成支持日志记录和跟踪，但不支持指标。 还可以使用 “配置” 部分中介绍的技术禁用遥测功能。

Logging

Aspire Azure Blob Storage 集成使用以下日志类别：

• Azure.Core
• Azure.Identity

Tracing

Aspire Azure Blob Storage 集成使用 OpenTelemetry 发出以下跟踪活动：

• Azure.Storage.Blobs.BlobContainerClient

Metrics

由于 Aspire SDK 的限制，Azure Blob StorageAzure 集成目前默认不支持度量。

另请参阅

• Azure Blob Storage 文档
• Aspire 集成
• Aspire GitHub 回购