.NET Aspire+Aspir8部署K8s：Azure存储连接字符串配置问题

问题背景 #

我有一个基于.NET Aspire的简易.NET解决方案，包含Web项目和使用.NET Orleans的服务项目，依赖Azure Storage支持Orleans。本地使用存储模拟器配置AppHost可正常运行，但执行aspirate generate和aspirate deploy部署到本地Rancher Kubernetes后，应用因连接字符串错误无法正常运行。

相关配置代码 #

AppHost配置

// Add the resources which you will use for Orleans clustering and
// grain state storage.
var storage = builder
    .AddAzureStorage("storage")
    .RunAsEmulator();

var clusteringTable = storage.AddTables("clustering");
var grainStorage = storage.AddBlobs("grain-state");

builder.AddOrleans("default")
    .WithClustering(clusteringTable)
    .WithGrainStorage("Default", grainStorage);

manifest.json相关配置

"clustering": {
      "type": "value.v0",
      "connectionString": "{storage.outputs.tableEndpoint}"
    },
    "grain-state": {
      "type": "value.v0",
      "connectionString": "{storage.outputs.blobEndpoint}"
    },

报错信息 #

Unhandled exception. System.InvalidOperationException: Connection string doesn't have value for keyword '{storage.outputs.tableEndpoint}'.

额外发现：Aspir8会自动生成存储账户的Bicep文件，但我不需要该文件或希望其匹配现有配置。想咨询：如何将存储账户连接字符串作为应用的机密使用？是否需要硬编码到manifest.json中？

解决方案 #

1. 用Kubernetes Secrets存储连接字符串（推荐，避免硬编码） #

完全不需要硬编码到manifest.json，正确做法是将Azure Storage的连接字符串存入Kubernetes Secrets，再在Aspire配置中引用：

• 先在Kubernetes集群创建Secrets：

kubectl create secret generic azure-storage-secrets \
  --from-literal=clustering-connection-string="你的表存储完整连接字符串" \
  --from-literal=grain-state-connection-string="你的Blob存储完整连接字符串"

• 修改manifest.json，将配置类型改为secret.v0，指向创建的机密：

"clustering": {
      "type": "secret.v0",
      "name": "azure-storage-secrets",
      "key": "clustering-connection-string"
    },
    "grain-state": {
      "type": "secret.v0",
      "name": "azure-storage-secrets",
      "key": "grain-state-connection-string"
    },

2. 调整AppHost配置适配现有存储 #

如果不想用Aspir8自动生成的Bicep文件，可直接在AppHost中指定现有存储的连接字符串（从环境变量/本地配置读取，避免硬编码）：

// 从环境变量读取，本地开发可改用User Secrets或appsettings.json
var clusteringConnStr = Environment.GetEnvironmentVariable("ORLEANS_CLUSTERING_CONN_STR");
var grainStorageConnStr = Environment.GetEnvironmentVariable("ORLEANS_GRAIN_STORAGE_CONN_STR");

builder.AddOrleans("default")
    .WithClustering(options => options.ConfigureTableServiceClient(clusteringConnStr))
    .WithGrainStorage("Default", options => options.ConfigureBlobServiceClient(grainStorageConnStr));

3. 禁用Aspir8自动生成存储Bicep（可选） #

若要让Aspir8匹配现有存储配置，可在aspirate.yaml中禁用自动生成存储资源的Bicep：

resources:
  storage:
    generateBicep: false

内容的提问来源于stack exchange，提问作者TeamBrett