Easy-DotNET Easy-DotNET
🏠首页
  • 知识地图
  • 源码脑图

    • 总览
    • Program
    • WebApplication
    • Host主机
    • WebHost主机
    • 依赖注入
    • Autofac
    • Middleware中间件
    • RateLimiter限制速率
    • 响应缓存、请求解压缩
  • 设计初衷
  • 克隆
  • 类型转换
  • 日期时间
  • IO流
  • 工具类
  • 语言特性
  • 集合类
  • Codec编码
  • 文本操作
  • 数学
  • 图片
  • 网络
  • Emoji表情
  • C# 12
  • C# 11
  • C# 10
  • C# 9.0
  • C# 8.0
  • C# 早期版本
  • C# 教程
  • ORM
  • 定时任务
  • 日志
  • 认证与授权
  • Swagger
  • 对象映射
  • 熔断重试限流
  • 缓存
  • 注册发现
  • 网关
  • GraphQL
  • 更多
  • Docker

    • 简介
    • Adminer
    • Apisix
    • Apollo
    • Cassandra
    • Cerebro
    • ClickHouse
    • Consul
    • EasyMock
    • Elasticsearch
    • Emqx
    • FastDFS
    • Flink
    • Gitlab
    • Jenkins
    • Jrebel
    • MariaDB
    • MySQL
    • Percona
    • Phpmyadmin
    • PostgreSQL
    • Redis
  • Linux

    • 查看Linux系统信息
    • CentOS7调整磁盘分区
    • IO压测
    • 图形化监控工具Cockpit
  • 总览
  • 列表

    • 算法数据结构
    • API
    • 应用框架
    • 应用模板
    • 操作系统
    • 工作流
    • 入门套件
    • 示例
    • 人工智能
    • 程序集
    • Assets
    • 认证授权
    • Blazor
    • 区块链
    • 书籍
    • 自动构建
    • 报表
    • 缓存
    • 日历
    • 聊天
    • CLI
    • CLR
    • CMS
    • 代码分析和指标
    • 代码片段
    • 压缩
    • 持续集成
    • 密码学
    • 数据库
    • 数据库驱动
    • 日期时间
    • 反编译
    • 部署
    • DirectX
    • 分布式计算
    • DLR
    • 文档
    • 电商支付
    • 模拟器
    • 环境管理
    • ETL
    • 事件消息
    • Exception
    • 扩展
    • 函数式编程
    • 游戏引擎
    • GIS
    • Git工具
    • 绘图
    • GraphQL
    • GUI
    • HTML-CSS
    • HTTP
    • IDE
    • 图片处理
    • 安装工具
    • 交互式编程
    • 国际化
    • 互操作性
    • IoC
    • JS引擎
    • 日志
    • 机器学习和数据科学
    • Markdown
    • 邮件
    • 数学
    • 媒体
    • 指标
    • 微型框架
    • 最小化器
    • MVVM
    • 网络
    • 对象映射
    • Office
    • OpenAI
    • ORM
    • 包管理器
    • PDF
    • 性能分析工具
    • 协议
    • 推送通知
    • SQL构建器
    • 消息队列
    • RPC
    • 响应式编程
    • 实时通信
    • 正则表达式
    • 任务调度
    • SDK和API
    • 搜索引擎
    • 序列化
    • SMS
    • 状态机
    • 静态站点生成
    • 强命名
    • 风格指南
    • 模板引擎
    • 测试
    • 工具
    • 交易
    • UI自动测试
    • Visual Studio 插件
    • Web浏览器
    • Web框架
    • WebServers
    • WebSocket
    • Windows服务
    • WPF
    • 解析器
    • 源码生成
    • 其他
    • 资源
  • AspNetCore面试题
  • Elasticsearch面试题
  • MongoDB面试题
  • MySql面试题
  • Nginx面试题
  • RabbitMQ面试题
  • Redis面试题
  • 设计模式
  • 微服务
🧑‍💻.NET Blog
GitHub (opens new window)
🏠首页
  • 知识地图
  • 源码脑图

    • 总览
    • Program
    • WebApplication
    • Host主机
    • WebHost主机
    • 依赖注入
    • Autofac
    • Middleware中间件
    • RateLimiter限制速率
    • 响应缓存、请求解压缩
  • 设计初衷
  • 克隆
  • 类型转换
  • 日期时间
  • IO流
  • 工具类
  • 语言特性
  • 集合类
  • Codec编码
  • 文本操作
  • 数学
  • 图片
  • 网络
  • Emoji表情
  • C# 12
  • C# 11
  • C# 10
  • C# 9.0
  • C# 8.0
  • C# 早期版本
  • C# 教程
  • ORM
  • 定时任务
  • 日志
  • 认证与授权
  • Swagger
  • 对象映射
  • 熔断重试限流
  • 缓存
  • 注册发现
  • 网关
  • GraphQL
  • 更多
  • Docker

    • 简介
    • Adminer
    • Apisix
    • Apollo
    • Cassandra
    • Cerebro
    • ClickHouse
    • Consul
    • EasyMock
    • Elasticsearch
    • Emqx
    • FastDFS
    • Flink
    • Gitlab
    • Jenkins
    • Jrebel
    • MariaDB
    • MySQL
    • Percona
    • Phpmyadmin
    • PostgreSQL
    • Redis
  • Linux

    • 查看Linux系统信息
    • CentOS7调整磁盘分区
    • IO压测
    • 图形化监控工具Cockpit
  • 总览
  • 列表

    • 算法数据结构
    • API
    • 应用框架
    • 应用模板
    • 操作系统
    • 工作流
    • 入门套件
    • 示例
    • 人工智能
    • 程序集
    • Assets
    • 认证授权
    • Blazor
    • 区块链
    • 书籍
    • 自动构建
    • 报表
    • 缓存
    • 日历
    • 聊天
    • CLI
    • CLR
    • CMS
    • 代码分析和指标
    • 代码片段
    • 压缩
    • 持续集成
    • 密码学
    • 数据库
    • 数据库驱动
    • 日期时间
    • 反编译
    • 部署
    • DirectX
    • 分布式计算
    • DLR
    • 文档
    • 电商支付
    • 模拟器
    • 环境管理
    • ETL
    • 事件消息
    • Exception
    • 扩展
    • 函数式编程
    • 游戏引擎
    • GIS
    • Git工具
    • 绘图
    • GraphQL
    • GUI
    • HTML-CSS
    • HTTP
    • IDE
    • 图片处理
    • 安装工具
    • 交互式编程
    • 国际化
    • 互操作性
    • IoC
    • JS引擎
    • 日志
    • 机器学习和数据科学
    • Markdown
    • 邮件
    • 数学
    • 媒体
    • 指标
    • 微型框架
    • 最小化器
    • MVVM
    • 网络
    • 对象映射
    • Office
    • OpenAI
    • ORM
    • 包管理器
    • PDF
    • 性能分析工具
    • 协议
    • 推送通知
    • SQL构建器
    • 消息队列
    • RPC
    • 响应式编程
    • 实时通信
    • 正则表达式
    • 任务调度
    • SDK和API
    • 搜索引擎
    • 序列化
    • SMS
    • 状态机
    • 静态站点生成
    • 强命名
    • 风格指南
    • 模板引擎
    • 测试
    • 工具
    • 交易
    • UI自动测试
    • Visual Studio 插件
    • Web浏览器
    • Web框架
    • WebServers
    • WebSocket
    • Windows服务
    • WPF
    • 解析器
    • 源码生成
    • 其他
    • 资源
  • AspNetCore面试题
  • Elasticsearch面试题
  • MongoDB面试题
  • MySql面试题
  • Nginx面试题
  • RabbitMQ面试题
  • Redis面试题
  • 设计模式
  • 微服务
🧑‍💻.NET Blog
GitHub (opens new window)
npm
  • 简介
  • ORM

    • EFCore
    • Dapper
    • FreeSql
    • SqlSugar
  • 任务调度

    • Hangfire
    • Quartz
    • FluentScheduler
    • Coravel
    • Quartzmin
  • 日志

    • Serilog
    • NLog
    • Log4Net
    • Stackdriver
    • ExceptionLess
  • 身份认证与授权

    • IdentityServer4
    • Identity
    • JWTBearer
    • Auth0
    • OpenIddict
  • Swagger文档

    • Swagger
    • Swashbuckle
    • NSwag
    • ReDoc
  • 对象映射

    • AutoMapper
    • EmitMapper
    • AgileMapper
    • Mapster
  • 消息传递

    • MediatR
    • MassTransit
    • Rebus
    • NServiceBus
  • 熔断重试限流

    • Polly
    • Resilience4j
    • AkkaNET
  • 缓存

    • CsRedis
    • FreeRedis
    • EasyCaching
    • StackExchangeRedis
    • CacheCow
    • NCache
    • Memory
  • 注册发现

    • Consul
    • Nacos
    • Apollo
  • 网关

    • Ocelot
    • Kong
    • Traefik
    • Zuul
      • 准备工作
      • 创建一个新的 .NET Core 项目
      • 配置 Zuul
      • 实现微服务
      • 测试 Zuul
      • 配置 Zuul 过滤器
      • 总结
  • GraphQL

    • GraphQLPlatform
    • GraphQLdotnet
  • 更多

    • NodaTime
    • FluentAssertions
    • Humanizer
    • 爬虫-AngleSharp
    • 邮件-MailKit
  • NET微服务
  • 网关
一个大西瓜
2023-04-25
目录

Zuul

开源地址

Github:https://github.com/Netflix/zuul (opens new window)

Zuul 是 Netflix 开源的微服务网关,用于处理微服务之间的请求路由和负载均衡。在 .NET 生态中,Zuul 可以使用 Spring Cloud Zuul .NET 这个第三方库来实现。本文将介绍如何使用 Zuul 和 Spring Cloud Zuul .NET 来构建一个微服务网关。

# 准备工作

在开始之前,需要确保以下环境已经准备好:

  • .NET Core 3.1 或更高版本
  • Visual Studio 2019 或更高版本

# 创建一个新的 .NET Core 项目

首先,我们需要创建一个新的 .NET Core 项目。在 Visual Studio 中,选择 "新建项目",然后选择 "ASP.NET Core Web 应用程序",并设置项目名称为 "Gateway"。选择 "API" 作为项目模板,因为我们将使用 ASP.NET Core Web API 来实现我们的网关。

在项目创建完成后,我们需要安装以下 NuGet 包:

  • SpringCloud.AspNetCore.Zuul
  • SpringCloud.Commons

这两个包都是由 Spring Cloud Zuul .NET 提供的,用于实现 Zuul 网关。

# 配置 Zuul

接下来,我们需要配置 Zuul。在 Startup.cs 文件中,添加以下代码:


using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.DependencyInjection;
using SpringCloud.AspNetCore.Zuul;

namespace Gateway
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddZuul(options =>
            {
                // 配置 Zuul 路由
                options.Routes.Add("service1", new ZuulRoute
                {
                    Path = "/service1/**",
                    ServiceId = "service1"
                });

                options.Routes.Add("service2", new ZuulRoute
                {
                    Path = "/service2/**",
                    ServiceId = "service2"
                });

                // 添加过滤器
                options.AddFilter<RequestLoggingFilter>();
            });
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            app.UseZuul();
        }
    }
}

在这个代码中,我们使用了 AddZuul 扩展方法来添加 Zuul。在 AddZuul 方法中,我们可以配置 Zuul 的路由和过滤器。在这个例子中,我们添加了两个路由,分别代表两个微服务 service1 和 service2,并添加了一个过滤器 RequestLoggingFilter,用于记录请求日志。

# 实现微服务

现在我们需要实现两个微服务 service1 和 service2,用于测试我们的 Zuul 网关。创建两个新的 ASP.NET Core Web API 项目,并分别设置它们的端口号为 5001 和 5002。

在每个微服务项目中,添加以下代码:


using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.DependencyInjection;

namespace Service1
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            app.UseRouting();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        }
    }
}

在这个代码中,我们使用了 AddControllers 扩展方法来添加控制器,然后使用 UseRouting 和 UseEndpoints 方法来配置 ASP.NET Core 路由和终端点。

对于 service1 微服务,我们添加一个简单的控制器来返回一个字符串。在 Service1Controller.cs 文件中,添加以下代码:


using Microsoft.AspNetCore.Mvc;

namespace Service1.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class Service1Controller : ControllerBase
    {
        [HttpGet]
        public IActionResult Get()
        {
            return Ok("Hello from Service 1");
        }
    }
}

对于 service2 微服务,我们添加一个控制器来返回一个随机数。在 Service2Controller.cs 文件中,添加以下代码:


using Microsoft.AspNetCore.Mvc;
using System;

namespace Service2.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class Service2Controller : ControllerBase
    {
        [HttpGet]
        public IActionResult Get()
        {
            var random = new Random();
            return Ok(random.Next(1, 100));
        }
    }
}

现在我们已经完成了微服务的实现。在 Visual Studio 中启动这两个微服务,并确保它们分别运行在端口号 5001 和 5002。

# 测试 Zuul

现在我们可以测试我们的 Zuul 网关是否能够正常工作了。在浏览器中访问 http://localhost:5000/service1,应该会返回 "Hello from Service 1"。同样的,访问 http://localhost:5000/service2,应该会返回一个随机数。

在控制台中,可以看到 Zuul 的日志输出,记录了每个请求的详细信息。

# 配置 Zuul 过滤器

现在我们已经成功地测试了 Zuul 网关的基本功能,接下来我们可以尝试配置 Zuul 过滤器来实现更复杂的功能。在这个例子中,我们将实现一个身份验证过滤器,用于验证每个请求是否带有正确的身份验证令牌。

在 Gateway 项目中,添加一个新的类 AuthenticationFilter.cs,并添加以下代码:


using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Primitives;
using SpringCloud.AspNetCore.Zuul.Filters;

namespace Gateway
{
    public class AuthenticationFilter : ZuulFilter
    {
        public override string FilterType => "pre";

        public override int FilterOrder => 1;

        public override bool ShouldFilter(HttpContext context)
        {
            // 只对 "/service2" 路径进行身份验证
            return context.Request.Path.StartsWithSegments("/service2");
        }

        public override Task<IList<ZuulFilterResult>> Run(HttpContext context)
        {
            StringValues token;

            // 检查请求头中是否包含 "Authorization" 令牌
            if (context.Request.Headers.TryGetValue("Authorization", out token))
            {
                // TODO: 实现身份验证逻辑
                // 如果令牌验证成功,继续执行下一个过滤器
                return Task.FromResult(new List<ZuulFilterResult> { new ZuulFilterResult(true) });
            }
            else
            {
                // 如果令牌验证失败,返回一个 HTTP 401 错误
                context.Response.StatusCode = 401;
                return Task.FromResult(new List<ZuulFilterResult> { new ZuulFilterResult(false) });
            }
        }
    }
}

在这个代码中,我们实现了一个身份验证过滤器,用于对 /service2 路径的请求进行身份验证。如果请求头中包含了正确的身份验证令牌,则继续执行下一个过滤器;否则返回一个 HTTP 401 错误。

在 Startup.cs 文件中,添加以下代码,以将身份验证过滤器添加到 Zuul 中:

options.AddFilter<AuthenticationFilter>();

现在我们已经成功地配置了一个身份验证过滤器,并将其添加到了 Zuul 中。在浏览器中访问 http://localhost:5000/service2,应该会返回一个 HTTP 401 错误,因为我们还没有提供正确的身份验证令牌。

# 总结

通过本文,我们介绍了如何使用 Zuul 和 Spring Cloud Zuul .NET 来构建一个微服务网关。我们实现了两个微服务,并配置了 Zuul 的路由和过滤器。最后,我们实现了一个身份验证过滤器,用于对请求进行身份验证。

Zuul 是一个非常强大的微服务网关,可以用于处理微服务之间的请求路由和负载均衡。通过学习本文,您应该已经掌握了如何使用 Zuul 和 Spring Cloud Zuul .NET 来构建一个微服务网关,并实现了一些常见的功能。

上次更新: 2023/04/26, 22:10:06
Traefik
GraphQLPlatform

← Traefik GraphQLPlatform→

Theme by Vdoing | Copyright © 2019-2024 一个大西瓜 | MIT License | 苏ICP备2023013501号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式