配置路由策略
配置跨域策略
对于已创建的路由,可配置其跨域策略。
- 登录微服务引擎控制台。
- 在左侧导航栏选择“应用网关 ”。
- 单击待操作的实例名称。
- 在左侧导航栏选择“路由管理 > 路由配置”。
- 单击待配置的路由名称,在路由详情页面的“策略配置”区域,在“跨域”页签下,单击“配置跨域策略”,在“配置跨域策略”弹出框,配置如下参数。
表1 跨域策略 参数
描述
允许的访问来源
设置允许通过浏览器访问服务器资源的站点,其作用于Access-Control-Allow-Origin头部,可以添加多条,以换行分隔。默认为*,允许所有的访问来源。
允许的方法
选择跨域访问时允许的HTTP方法,常见的方法有GET、POST、PUT、DELETE、HEAD、OPTIONS和PATCH,其作用于Access-Control-Allow-Methods头部,默认全选。
允许的请求头
设置跨域访问时允许的Header,其作用于Access-Control-Allow-Headers头部,可以添加多条,以换行分隔。默认为*,允许所有的请求头。
允许的响应头
允许浏览器、JavaScript脚本访问的响应头部,其作用于Access-Control-Expose-Headers头部,可以添加多条,以换行分隔。
默认为*,允许所有的响应头。
携带凭证
跨域访问时可是否允许携带凭证信息,其作用于Access-Control-Allow-Credentials头部,默认为“允许”。
预检过期时间
指定本次预检请求的有效期,在有效期内,无需再次发出预检请求。其作用于Access-Control-Max-Age头部,默认为24h。
跨域策略开关
可设置该策略是否打开,默认打开。
- 单击“确定”创建完成。跨域策略创建完成后,可单击“跨域”页签的“修改跨域策略”根据需要编辑策略。
配置重试策略
应用网关支持对路由设置重试策略,设置在哪些情况下会进行重试、重试多少次,为出错的请求自动进行重试。
不配置重试策略时,重试状态默认为“已关闭”。
- 登录微服务引擎控制台。
- 在左侧导航栏选择“应用网关 ”。
- 单击待操作的应用网关实例名称。
- 在左侧导航栏选择“路由管理 > 路由配置”。
- 单击待配置的路由名称,在路由详情页面的“策略配置”区域,在“重试”页签下,单击“修改重试策略”,在弹出框中配置重试策略参数。
表2 重试策略参数 参数
描述
*重试次数
设置当符合重试条件的请求出错时可进行重试的最大次数。重试次数支持设置0~10次。
说明:当重试次数设置为0时,表示重试功能不生效。
重试条件
选择在满足什么情况下应用网关会进行重试,可同时选择多个。
- 5xx:当后端服务返回任何5xx响应时,应用网关将尝试对出错请求进行重试。
说明:
5xx包含connect-failure和refused-stream的条件。
- reset:当发生连接断开、重置、读取超时事件,应用网关将尝试对出错请求进行重试。
- connect-failure:当请求是由连接断开导致的出错,应用网关将尝试对出错请求进行重试。
- refused-stream:当后端服务以REFUSED_STREAM错误代码来重置流,应用网关将尝试对出错请求进行重试。
- retriable-status-codes:当后端服务响应结果的HTTP状态码匹配上您指定的重试状态码,应用网关将尝试对该请求进行重试。
重试状态码
指定对某个响应的HTTP状态码进行重试,支持配置多个HTTP状态码。
说明:当“重试条件”选择“retriable-status-codes”时,需配置此参数。
是否启用重试
- 可单击启用重试策略。
- 可单击关闭重试策略。
说明:
关闭重试策略后,应用网关内部存在默认的重试配置,重试次数默认为2次,重试条件默认为connect-failure、refused-stream、unavailable、cancelled和retriable-status-codes。
- 5xx:当后端服务返回任何5xx响应时,应用网关将尝试对出错请求进行重试。
- 单击“确定”重试策略配置完成。还可根据业务需要修改、开启或禁用重试策略。
配置重写策略
应用网关允许对主机域、路径分别设置重写(也可只重写其中一个)。
- 登录微服务引擎控制台。
- 在左侧导航栏选择“应用网关 ”。
- 单击待操作的应用网关实例名称。
- 在左侧导航栏选择“路由管理 > 路由配置”。
- 单击待配置的路由名称,在路由详情页面的“策略配置”区域,在“重写”页签下,单击“配置重写策略”,在弹出框中配置重写策略参数。
表3 重写策略参数 重写范围
参数
描述
路径
重写类型
重写类型分为:标准和正则。
- 标准重写:对于路径精确匹配或路径正则匹配的路由,进行完整覆盖重写;对于路径前缀匹配的路由,仅重写前缀匹配的部分。
- 正则重写:根据正则表达式进行重写。
说明:
两种类型为互斥关系。
重写路径
输入重写的路径。支持精确重写、前缀重写。使用此值重写原始的路径(或前缀)部分。如果原始路径是根据前缀匹配的,则此字段中提供的值将替换相应匹配的前缀。
说明:当选择“标准”重写类型时需要配置此参数。
匹配模式
设置匹配路径上需要修改的内容。如输入^/service/([^/]+)/(.*)$。
说明:当选择“正则”重写类型时需要配置此参数。
重写替换
设置使用此值替换匹配路径上的内容。如输入/customprefix/\2/\1。
说明:当选择“正则”重写类型时需要配置此参数。
主机域
重写主机域
支持精确重写,使用此值重写原有主机域。
- 设置“是否启用重写规则”,默认启用重写策略。
- 可单击启用重写策略。
- 可单击关闭重写策略。
- 单击“确定”,重写策略完成。重写策略创建完成后,可单击“重写”页签的“配置重写策略”根据需要编辑策略。