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 网络
相关推荐
怕浪猫2 小时前
领域特定语言（Domain-Specific Language, DSL）
设计模式·程序员·架构
怕浪猫3 小时前
哪些软件对 Chrome DevTools Protocol 频繁使用
人工智能·架构·前端框架
Jack2010 小时前
HarmonyOS APP事件驱动大揭秘
架构
米丘10 小时前
微前端之 Web Components 完全指南
微服务·html
秋播10 小时前
国内本地WSL2编译rancher源码
云原生
Colin草率地做慢慢地改10 小时前
关于QuickStore这个项目的重构（2）- 数据库建表文件
后端·面试·架构
candyTong1 天前
RTK 技术原理：一次典型会话里，80% 上下文是怎么省下来的
javascript·后端·架构
唐某人丶1 天前
从画架构图开始：架构分析与进阶指南
架构
小猿姐2 天前
MySQL Top 10 热点问题 AI 运维实战：从内核诊断到云原生运维
mysql·云原生·aiops
热门推荐
012026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？022026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？032026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf04【AI】2026 年具身智能模型和世界模型总结05GitHub 镜像站点06AI科技热点日报 | 2026年6月1日07AI一周事件 · 2026-06-03 至 2026-06-09082026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？09Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析10上线仅72小时被强制下架：Claude Fable 5 的短命