渴望配置

其他 社区

技能解读

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

何时使用此技能

在以下情况下使用此技能: 将 AppHost 资源连接到基于 Aspire 的存储库中的应用程序配置 确保生产配置在 Aspire 外部透明且可移植 避免在应用程序代码内使用 Aspire 客户端/服务发现包 设计用于开发/测试的功能切换而不更改应用程序代码路径

核心原则

AppHost 拥有 Aspire 基础设施包 Aspire Hosting 包仅属于 AppHost。应用程序项目不应引用 Aspire 客户端/服务发现包。仅显式配置 AppHost 必须将资源输出转换为显式配置键(环境变量)。

配置流程

AppHost 负责将 Aspire 资源转换为显式应用程序设置。该应用程序从不直接使用 Aspire 客户端或服务发现。

示例:数据库 + Blob 存储

关键点WithReference(db, "Postgres")显式设置ConnectionStrings__Postgres。每个外部依赖项都通过显式配置键表示。 API项目仅读取Configuration值。

应用程序代码模式(无 Aspire 客户端)

应用程序代码绑定到选项并直接初始化 SDK。它从不依赖于 Aspire 客户端包或服务发现。请勿将 Aspire 客户端包(或AddServiceDiscovery)添加到应用程序中。这些都是编排问题,应该保留在 AppHost 中。

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

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

输出预览 aspire-configuration.preview
// AppHost/Program.cs
var builder = DistributedApplication.CreateBuilder(args);

var postgres = builder.AddPostgres("postgres");
var db = postgres.AddDatabase("appdb");

var minio = builder.AddContainer("minio", "minio/minio")
    .WithArgs("server", "/data")
    .WithHttpEndpoint(targetPort: 9000, name: "http")
    .WithHttpEndpoint(targetPort: 9001, name: "console")
    .WithEnvironment("MINIO_ROOT_USER", "minioadmin")
    .WithEnvironment("MINIO_ROOT_PASSWORD", "minioadmin");

var api = builder.AddProject<Projects.MyApp_Api>("api")
    .WithReference(db, "Postgres")
    .WithEnvironment("BlobStorage__Enabled", "true")
    .WithEnvironment("BlobStorage__ServiceUrl", minio.GetEndpoint("http"))
    .WithEnvironment("BlobStorage__AccessKey", "minioadmin")
    .WithEnvironment("BlobStorage__SecretKey", "minioadmin")
    .WithEnvironment("BlobStorage__Bucket", "attachments")
    .WithEnvironment("BlobStorage__ForcePathStyle", "true");

builder.Build().Run();

讨论

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