ABP VNext + Tye:本地微服務編排與調試 🚀
📚 目錄
- ABP VNext + Tye:本地微服務編排與調試 🚀
- TL;DR ?
- 一、環境與依賴 🛠?
- 二、核心配置詳解 🚀
- 1. 主配置 `tye.yaml`
- 三、多環境文件 🌱🌳
- `tye.development.yaml`
- `tye.production.yaml`
- 四、依賴容器定義 🐳
- 五、ABP VNext 集成 🔌
- 1. NuGet 包
- 2. `appsettings.json`
- 3. 分布式緩存 & 鎖 🔒
- 4. RabbitMQ & CAP 🐰
- 5. 全鏈路追蹤 🕵?
- 六、一鍵啟動 & 驗證 ?
- 七、流程圖 📊
- 1. 配置加載與啟動
- 2. 服務依賴關系
- 八、斷點調試 🎯
- VS Code Attach
- 調試序列圖
- 九、進階與安全 🛠?🔒
TL;DR ?
- 🚀 一鍵編排:ABP VNext 微服務 + SQL Server、Redis、RabbitMQ、Jaeger,
tye run --env …
即可全量本地啟動 - 💪 高可用 & 性能:雙保險健康檢查、資源
requests/limits
、多副本、死信隊列與自動重試 - 🔍 全鏈路可觀測:HTTP/gRPC/EF Core Trace → Jaeger UI → Tye Dashboard
一、環境與依賴 🛠?
-
必備工具
-
.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 鏡像)
-
-
容器鏡像
- 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
- SQL Server 2022:
-
項目結構
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
。
九、進階與安全 🛠?🔒
-
自定義 Dockerfile
- name: custom-servicecontainer:dockerFile: services/Custom/Dockerfileimage: myorg/custom:latest
-
公網隧道
tye proxy identity --bind 5001
?? 僅限測試,生產請結合 API Gateway/認證。
-
網絡模式
- Linux 可選
network: host
- 跨宿主機訪問時可自定義 Docker 網絡
- Linux 可選