ABP VNext + Tye：本地微服务编排与调试

ABP VNext + Tye：本地微服务编排与调试 🚀

---

---

TL;DR ✨

• 🚀 一键编排：ABP VNext 微服务 + SQL Server、Redis、RabbitMQ、Jaeger，tye run --env … 即可全量本地启动
• 💪 高可用 & 性能：双保险健康检查、资源 requests/limits、多副本、死信队列与自动重试
• 🔍 全链路可观测：HTTP/gRPC/EF Core Trace → Jaeger UI → Tye Dashboard

---

一、环境与依赖 🛠️

1. 必备工具

   • .NET 6+ SDK

   • ABP VNext 6.x（Volo.Abp.* 系列）

   • Microsoft Tye CLI

     dotnet tool install -g Microsoft.Tye --version "0.12.0-alpha.*"
     

   • Docker Desktop（含 SQL Server、Redis、RabbitMQ、Jaeger 镜像）

2. 容器镜像

   • SQL Server 2022：mcr.microsoft.com/mssql/server:2022-latest
   • Redis 7：redis:7
   • RabbitMQ 3-management：rabbitmq:3-management
   • Jaeger All-in-One：jaegertracing/all-in-one:1.49

3. 项目结构

   abp-tye-demo/
   ├─ services/
   │   ├─ IdentityService/
   │   ├─ OrderService/
   │   └─ ProductService/
   ├─ tye.yaml
   ├─ tye.development.yaml
   ├─ tye.production.yaml
   ├─ docker-compose.override.yml
   └─ README.md
   

---

二、核心配置详解 🚀

1. 主配置 tye.yaml

name: abp-tye-demosecrets:- name: Jwt__Keyservices:# —— 外部依赖 —— - name: sqldockerCompose:file: docker-compose.override.yml- name: redisdockerCompose:file: docker-compose.override.yml- name: rabbitmqdockerCompose:file: docker-compose.override.yml- name: jaegerdockerCompose:file: docker-compose.override.yml# —— ABP 微服务 —— - name: identityproject: services/IdentityService/IdentityService.csprojbindings:- port: 5001env:ConnectionStrings__Default: "Server=sql;User Id=sa;Password=Your_password123;"Redis__Configuration: "redis:6379"RabbitMQ__HostName: "rabbitmq"RabbitMQ__User: "tye"RabbitMQ__Pass: "tyePass123"Jaeger__AgentHost: "jaeger"Jaeger__AgentPort: "6831"Jwt__Key: "Jwt__Key"- name: orderproject: services/OrderService/OrderService.csprojbindings:- port: 5002env:ConnectionStrings__Default: "Server=sql;User Id=sa;Password=Your_password123;"Redis__Configuration: "redis:6379"RabbitMQ__HostName: "rabbitmq"RabbitMQ__User: "tye"RabbitMQ__Pass: "tyePass123"Jaeger__AgentHost: "jaeger"Jaeger__AgentPort: "6831"- name: productproject: services/ProductService/ProductService.csprojbindings:- port: 5003env:ConnectionStrings__Default: "Server=sql;User Id=sa;Password=Your_password123;"Redis__Configuration: "redis:6379"RabbitMQ__HostName: "rabbitmq"RabbitMQ__User: "tye"RabbitMQ__Pass: "tyePass123"Jaeger__AgentHost: "jaeger"Jaeger__AgentPort: "6831"

• 多环境自动合并：tye run --env development|production 会加载对应文件
• Secrets：通过 tye secret set Jwt__Key ... 注入
• RabbitMQ 用户：guest 仅限本地，容器间需自定义用户

---

三、多环境文件 🌱🌳

tye.development.yaml

services:- name: identityreplicas: 1- name: orderreplicas: 1- name: productreplicas: 1

tye.production.yaml

services:- name: identityreplicas: 2resources:requests:cpu: "0.25"memory: "256Mi"limits:cpu: "0.5"memory: "512Mi"- name: orderreplicas: 2resources:requests:cpu: "0.25"memory: "256Mi"limits:cpu: "0.5"memory: "512Mi"- name: productreplicas: 2resources:requests:cpu: "0.25"memory: "256Mi"limits:cpu: "0.5"memory: "512Mi"

---

四、依赖容器定义 🐳

version: '3.4'
services:sql:image: mcr.microsoft.com/mssql/server:2022-latestenvironment:SA_PASSWORD: "Your_password123"ACCEPT_EULA: "Y"ports:- "1433:1433"volumes:- ./mssql-data:/var/opt/mssqlhealthcheck:test: ["CMD", "sh", "-c", "if nc -z localhost 1433; then exit 0; else exit 1; fi"]interval: 10sretries: 5redis:image: redis:7ports:- "6379:6379"healthcheck:test: ["CMD", "redis-cli", "ping"]interval: 10sretries: 5rabbitmq:image: rabbitmq:3-managementenvironment:RABBITMQ_DEFAULT_USER: "tye"RABBITMQ_DEFAULT_PASS: "tyePass123"ports:- "5672:5672"    # AMQP- "15672:15672"  # Management UIhealthcheck:test: ["CMD", "rabbitmq-diagnostics", "ping"]interval: 10sretries: 5jaeger:image: jaegertracing/all-in-one:1.49ports:- "16686:16686"     # Jaeger UI- "6831:6831/udp"   # Trace 数据

• 数据持久化：SQL Server volume
• 网络说明：Linux 可选 network: host

---

五、ABP VNext 集成 🔌

1. NuGet 包

<PackageReference Include="Volo.Abp.AspNetCore" Version="6.*" />
<PackageReference Include="Volo.Abp.DistributedLocking.Redis" Version="6.*" />
<PackageReference Include="Volo.Abp.EventBus.CAP" Version="6.*" />

2. appsettings.json

{"ConnectionStrings": {"Default": "Server=sql;User Id=sa;Password=Your_password123;"},"Redis": {"Configuration": "redis:6379"},"RabbitMQ": {"HostName": "rabbitmq","Port": 5672,"User": "tye","Pass": "tyePass123"},"Jaeger": {"AgentHost": "jaeger","AgentPort": 6831},"Jwt": {"Key": ""}
}

3. 分布式缓存 & 锁 🔒

builder.Services.AddStackExchangeRedisCache(options =>{options.Configuration = builder.Configuration["Redis:Configuration"];}).AddAbpDistributedLock(sp =>sp.AddRedisLock(builder.Configuration["Redis:Configuration"]));

4. RabbitMQ & CAP 🐰

builder.Services.AddCap(options =>
{options.UseRabbitMQ(cfg =>{cfg.HostName = builder.Configuration["RabbitMQ:HostName"];cfg.Port = int.Parse(builder.Configuration["RabbitMQ:Port"]);cfg.UserName = builder.Configuration["RabbitMQ:User"];cfg.Password = builder.Configuration["RabbitMQ:Pass"];});options.UseDashboard();options.FailedRetryCount = 5;
});// 事件订阅示例
public class OrderCreatedConsumer : ICapSubscribe
{[CapSubscribe("order.created")]public Task Handle(OrderCreatedEvent evt) => /*...*/;
}

5. 全链路追踪 🕵️

builder.Services.AddOpenTelemetryTracing(tp =>
{tp.AddAspNetCoreInstrumentation().AddHttpClientInstrumentation().AddGrpcClientInstrumentation().AddEntityFrameworkCoreInstrumentation().AddJaegerExporter(opts =>{opts.AgentHost = builder.Configuration["Jaeger:AgentHost"];opts.AgentPort = int.Parse(builder.Configuration["Jaeger:AgentPort"]);});
});

---

六、一键启动 & 验证 ⚡

# 注入 Secret
tye secret set Jwt__Key --value "YourSuperSecretKey"# 启动服务
tye run --env production --watch

• 验证副本 & 资源：tye describe

• 访问监控

  功能	地址
  Tye Dashboard	http://localhost:8000
  RabbitMQ UI	http://localhost:15672
  Jaeger UI	http://localhost:16686

---

七、流程图 📊

1. 配置加载与启动

2. 服务依赖关系

---

八、断点调试 🎯

VS Code Attach

{"version": "0.2.0","configurations": [{"name": "Attach to Tye IdentityService","type": "coreclr","request": "attach","processName": "dotnet","justMyCode": false}]
}

调试序列图

Tip：遇到 IIS Express 冲突，切换至 “Project” 启动或在 launchSettings.json 指定 --urls http://*:5001。

---

九、进阶与安全 🛠️🔒

1. 自定义 Dockerfile

   - name: custom-servicecontainer:dockerFile: services/Custom/Dockerfileimage: myorg/custom:latest
   

2. 公网隧道

   tye proxy identity --bind 5001
   

   ⚠️ 仅限测试，生产请结合 API Gateway/认证。

3. 网络模式

   • Linux 可选 network: host
   • 跨宿主机访问时可自定义 Docker 网络

---