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

Kookoos2025-07-07 14:10

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

📚 目录

  • [ABP VNext + Tye：本地微服务编排与调试 🚀](#ABP VNext + Tye：本地微服务编排与调试 🚀)
    • [TL;DR ✨](#TL;DR ✨)
    • [一、环境与依赖 🛠️](#一、环境与依赖 🛠️)
    • [二、核心配置详解 🚀](#二、核心配置详解 🚀)
      • [1. 主配置 `tye.yaml`](#1. 主配置 tye.yaml)
    • [三、多环境文件 🌱🌳](#三、多环境文件 🌱🌳)
    • [四、依赖容器定义 🐳](#四、依赖容器定义 🐳)
    • [五、ABP VNext 集成 🔌](#五、ABP VNext 集成 🔌)
      • [1. NuGet 包](#1. NuGet 包)
      • [2. `appsettings.json`](#2. appsettings.json)
      • [3. 分布式缓存 & 锁 🔒](#3. 分布式缓存 & 锁 🔒)
      • [4. RabbitMQ & CAP 🐰](#4. RabbitMQ & CAP 🐰)
      • [5. 全链路追踪 🕵️](#5. 全链路追踪 🕵️)
    • [六、一键启动 & 验证 ⚡](#六、一键启动 & 验证 ⚡)
    • [七、流程图 📊](#七、流程图 📊)
      • [1. 配置加载与启动](#1. 配置加载与启动)
      • [2. 服务依赖关系](#2. 服务依赖关系)
    • [八、断点调试 🎯](#八、断点调试 🎯)
    • [九、进阶与安全 🛠️🔒](#九、进阶与安全 🛠️🔒)

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

      bash 复制代码 
      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

yaml 复制代码 
name: abp-tye-demo

secrets:
  - name: Jwt__Key

services:
  # ------ 外部依赖 ------ 
  - name: sql
    dockerCompose:
      file: docker-compose.override.yml

  - name: redis
    dockerCompose:
      file: docker-compose.override.yml

  - name: rabbitmq
    dockerCompose:
      file: docker-compose.override.yml

  - name: jaeger
    dockerCompose:
      file: docker-compose.override.yml

  # ------ ABP 微服务 ------ 
  - name: identity
    project: services/IdentityService/IdentityService.csproj
    bindings:
      - port: 5001
    env:
      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: order
    project: services/OrderService/OrderService.csproj
    bindings:
      - port: 5002
    env:
      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: product
    project: services/ProductService/ProductService.csproj
    bindings:
      - port: 5003
    env:
      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

yaml 复制代码 
services:
  - name: identity
    replicas: 1
  - name: order
    replicas: 1
  - name: product
    replicas: 1

tye.production.yaml

yaml 复制代码 
services:
  - name: identity
    replicas: 2
    resources:
      requests:
        cpu: "0.25"
        memory: "256Mi"
      limits:
        cpu: "0.5"
        memory: "512Mi"

  - name: order
    replicas: 2
    resources:
      requests:
        cpu: "0.25"
        memory: "256Mi"
      limits:
        cpu: "0.5"
        memory: "512Mi"

  - name: product
    replicas: 2
    resources:
      requests:
        cpu: "0.25"
        memory: "256Mi"
      limits:
        cpu: "0.5"
        memory: "512Mi"

四、依赖容器定义 🐳

yaml 复制代码 
version: '3.4'
services:
  sql:
    image: mcr.microsoft.com/mssql/server:2022-latest
    environment:
      SA_PASSWORD: "Your_password123"
      ACCEPT_EULA: "Y"
    ports:
      - "1433:1433"
    volumes:
      - ./mssql-data:/var/opt/mssql
    healthcheck:
      test: ["CMD", "sh", "-c", "if nc -z localhost 1433; then exit 0; else exit 1; fi"]
      interval: 10s
      retries: 5

  redis:
    image: redis:7
    ports:
      - "6379:6379"
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      retries: 5

  rabbitmq:
    image: rabbitmq:3-management
    environment:
      RABBITMQ_DEFAULT_USER: "tye"
      RABBITMQ_DEFAULT_PASS: "tyePass123"
    ports:
      - "5672:5672"    # AMQP
      - "15672:15672"  # Management UI
    healthcheck:
      test: ["CMD", "rabbitmq-diagnostics", "ping"]
      interval: 10s
      retries: 5

  jaeger:
    image: jaegertracing/all-in-one:1.49
    ports:
      - "16686:16686"     # Jaeger UI
      - "6831:6831/udp"   # Trace 数据
  • 数据持久化：SQL Server volume
  • 网络说明 ：Linux 可选 network: host

五、ABP VNext 集成 🔌

1. NuGet 包

xml 复制代码 
<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

jsonc 复制代码 
{
  "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. 分布式缓存 & 锁 🔒

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

4. RabbitMQ & CAP 🐰

csharp 复制代码 
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. 全链路追踪 🕵️

csharp 复制代码 
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"]);
      });
});

六、一键启动 & 验证 ⚡

bash 复制代码 
# 注入 Secret
tye secret set Jwt__Key --value "YourSuperSecretKey"

# 启动服务
tye run --env production --watch

七、流程图 📊

1. 配置加载与启动

合并配置 环境变量 自动加载 tye.production.yaml 合并到 tye.yaml tye run --env production Tye Runtime 启动 服务列表 sql, redis, rabbitmq, jaeger identity, order, product

2. 服务依赖关系

Services Containers Trace Trace Trace Metrics & Logs Metrics & Logs Metrics & Logs IdentityService
5001 OrderService
5002 ProductService
5003 SQL Server
1433 Redis
6379 RabbitMQ
5672 Jaeger
6831/UDP Tye Dashboard

八、断点调试 🎯

VS Code Attach

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

调试序列图

开发者 Tye Runtime VS Code IdentityService tye run --watch Attach Debugger Attach to process Breakpoint Hit 开发者 Tye Runtime VS Code IdentityService

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

九、进阶与安全 🛠️🔒

  1. 自定义 Dockerfile

    yaml 复制代码 
    - name: custom-service
  container:
    dockerFile: services/Custom/Dockerfile
    image: myorg/custom:latest

  2. 公网隧道

    bash 复制代码 
    tye proxy identity --bind 5001

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

  3. 网络模式

    • Linux 可选 network: host
    • 跨宿主机访问时可自定义 Docker 网络
相关推荐
一人一萧十只猫�5 小时前
Kubernetes 全面解析：从基础设施变革到核心架构详解
云原生·容器·kubernetes
SoFlu软件机器人7 小时前
秒级构建消息驱动架构：描述事件流程，生成 Spring Cloud Stream+RabbitMQ 代码
分布式·架构·rabbitmq
之墨_7 小时前
【大语言模型入门】—— Transformer 如何工作：Transformer 架构的详细探索
语言模型·架构·transformer
77qqqiqi9 小时前
mp核心功能
java·数据库·微服务·mybatisplus
Jacob023412 小时前
为什么现在越来越多项目选择混合开发？从 WebAssembly 在无服务器中的表现说起
架构·rust·webassembly
乌恩大侠13 小时前
USRP X440 和USRP X410 直接RF采样架构的优势
5g·fpga开发·架构·usrp·usrp x440·usrp x410
极客奇点13 小时前
容器化成本优化：K8s资源请求与限制的黄金法则——从资源画像分析到25%成本削减的实战指南
云原生·容器·kubernetes·降本增效·成本优化
TransPlus14 小时前
K8s集群两者不同的对外暴露服务的方式
云原生·容器·kubernetes
●VON15 小时前
重生之我在暑假学习微服务第四天《Docker-下篇》
java·学习·docker·微服务·容器
热门推荐
01Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code02全球最强模型Grok4，国内已可免费使用！（附教程）03Coze 开源了，送上保姆级私有化部署方案【建议收藏】04【手把手攻略】国家育儿补贴正式开领！一键算清你能拿多少钱？附补贴领取计算器05扣子开源本地部署教程 丨Coze智能体小白喂饭级指南06腾讯还是太全面了，限时免费！超全CodeBuddy IDE保姆级教程！（附案例）07KGG转MP3工具|非KGM文件|解密音频08MSPM0G3507——读取引脚的高低电平方法（数字信号循迹模块）09【Spring】依赖注入的方式：构造方法、setter注入、字段注入10机器学习——多项式回归算法