配置

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用此技能

在以下情况下使用此技能: 使用 .NET Aspire 编排设置新的 Akka.NET 项目 通过集群引导和发现配置 Akka.Cluster 将 Akka.Persistence 与 SQL Server 集成 设置 Akka.Management 以进行集群管理

相关技能

akka-net-management - 深入研究 Akka.Management、Cluster Bootstrap 和发现提供程序(Kubernetes、Azure、Config) microsoft-extensions-configuration - 用于配置验证的 IValidateOptions 模式 akka-net-best-practices - 可测试 Actor 系统的集群/本地模式抽象 aspire-integration-testing - 使用真实基础设施测试 Aspire 应用程序

核心原则

通过 Microsoft.Extensions.Configuration 进行配置 - 使用从 appsettings.json 绑定的强类型设置类(请参阅microsoft-extensions-configuration 技能) Akka.Hosting 进行 DI 集成 - 使用 Akka.Hosting 库实现无缝 ASP.NET Core 集成 Aspire for Orchestration - 让 Aspire 管理服务依赖项、网络和环境配置 运行状况检查 - 始终配置集群、持久性和就绪性的运行状况检查

配置模型(AkkaSettings.cs)

创建强类型配置类:

模式 3:健康检查

始终在 Program.cs 中配置运行状况检查:

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@Aaronontheweb · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 akka-net-aspire-configuration.preview
// Use Aspire's DistributedApplicationTestingBuilder for infrastructure
// Use Akka.Hosting.TestKit for actor testing
public class AkkaAspireIntegrationTests : IAsyncLifetime
{
    private DistributedApplication? _app;

    public async Task InitializeAsync()
    {
        var appHost = await DistributedApplicationTestingBuilder
            .CreateAsync<Projects.YourApp_AppHost>();

        _app = await appHost.BuildAsync();
        await _app.StartAsync();
    }

    [Fact]
    public async Task ActorSystem_WithRealDatabase_ShouldPersistEvents()
    {
        // Get SQL connection string from Aspire
        var dbResource = _app!.GetResource("yourdb");
        var connectionString = await dbResource.GetConnectionStringAsync();

        // Create HttpClient to test actor endpoints
        var httpClient = _app.CreateHttpClient("yourapp");

        // Test actor behavior through HTTP API
        var response = await httpClient.PostAsJsonAsync("/orders", new
        {
            OrderId = "ORDER-001",
            Amount = 100.00m
        });

        response.Should().BeSuccessStatusCode();

        // Verify data was persisted to real database
        await using var connection = new SqlConnection(connectionString);
        await connection.OpenAsync();

        var events = await connection.QueryAsync<string>(
            "SELECT EventType FROM EventJournal WHERE PersistenceId = 'order-ORDER-001'");

        events.Should().Contain("OrderCreated");
    }

    public async Task DisposeAsync()
    {
        if (_app is not null)
            await _app.DisposeAsync();
    }
}

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。