首页 > 网游 > 正文

bad gateway是什么意思(服务和路由是什么?)

2023-02-09 17:14:07来源:互联网  

在本篇中,您将了解如何通过路由暴露服务。

服务和路由是什么?

服务和路由对象允许您使用Kong Gateway向客户端暴露服务。在配置对API的访问时,您将从指定一个服务开始。在Kong Gateway中,服务是表示外部上游API或微服务的实体——例如,数据转换微服务、账单API等等。


(相关资料图)

服务的主要属性是它的URL,服务在其中监听请求。可以使用单个字符串指定URL,也可以分别指定其协议、主机、端口和路径。

在开始对服务发出请求之前,需要向其添加一个路由。路由决定请求在到达Kong Gateway后如何(以及是否)发送到它们的服务。

单个服务可以有多个路由。配置好服务和路由后,您就可以开始通过Kong Gateway发出请求了。

此图说明了通过服务路由到后端API的请求和响应的流量。

服务路由到后端API的请求和响应的流程

添加服务

出于本例的目的,您将创建一个指向Mockbin API的服务。Mockbin是一个“echo”类型的公共网站,它将请求作为响应返回给请求者。这种可视化将有助于了解Kong Gateway如何代理API请求。

Kong Gateway在端口8001上公开RESTful管理API。网关的配置(包括添加服务和路由)是通过请求Admin API完成的。

可以通过以下三种方式添加:

Admin API

1.使用名称example_service和URL http://mockbin.org定义服务。

使用cURL:

 $ curl -i -X POST http://<admin-hostname>:8001/services  --data name=example_service  --data url="http://mockbin.org"

或者使用HTTPie:

 $ http POST :8001/services name=example_service url="http://mockbin.org"

如果服务成功创建,您将收到一条201成功消息。

2.验证服务的端点。

使用cURL:

 $ curl -i http://<admin-hostname>:8001/services/example_service

或者使用HTTPie:

 $ http :8001/services/example_service
Kong Manager

1.在Kong Manager的Workspaces选项卡上,滚动到工作区部分并单击默认工作区。这个示例使用默认的工作空间,但是您也可以创建一个新的工作空间,或者使用一个现有的工作空间。

2.向下滚动到Services并单击Add a Service。

3.在创建服务对话框中,输入名称example_service和URL http://mockbin.org。

4.单击Create。

服务被创建,页面自动重定向回example_service概览页面。

decK (YAML)

1.在Kong网关的kong.yaml文件中,定义一个名为example_service的服务,URL为http://mockbin.org:

_format_version: "1.1" services: - host: mockbin.org   name: example_service   port: 80   protocol: http

2.保存文件。从您的终端,同步配置以更新Kong:

$ deck sync

该消息应该显示您正在创建一个服务:

 creating service example_service Summary: Created: 1 Updated: 0 Deleted: 0

添加路由

要想通过Kong Gateway访问该服务,您需要为其添加一个路由。

可以通过以下三种方式添加:

Admin API

为客户端请求的特定路径服务(example_service)定义一个路由(/mock)。注意,要使路由与服务匹配,必须设置至少一个主机、路径或方法。

使用cURL:

  $ curl -i -X POST http://<admin-hostname>:8001/services/example_service/routes   --data "paths[]=/mock"   --data name=mocking

或者使用HTTPie:

 $ http :8001/services/example_service/routes paths:="["/mock"]" name=mocking

一条201消息表示路由已成功创建。

Kong Manager

1.在example_service概览页面中,向下滚动到Route部分并单击New Route。Create Route对话框将显示自动填充服务名称和ID号的服务字段。此字段是必需的。注意:如果服务字段没有自动填充,请单击左侧导航窗格中的Services。找到您的服务,单击id字段旁边的剪贴板图标,然后返回到创建路由页面并将其粘贴到服务字段。

2,为路由输入一个名称,以及至少以下字段中的一个:主机、方法或路径。对于这个例子,使用以下方法:

名字输入“mock”。路径,单击添加路径并进入/mock。

3.单击Create。

创建路由后,您将自动重定向回example_service概览页面。新路由出现在路由部分的下面。

decK (YAML)

1.将以下内容粘贴到kong.yaml文件,在example_service条目下:

 routes: - name: mocking   paths:   - /mock   strip_path: true

你的文件现在应该是这样的:

 _format_version: "1.1" services: - host: mockbin.org   name: example_service   port: 80   protocol: http   routes:   - name: mocking     paths:     - /mock     strip_path: true

2.同步配置:

$ deck sync

3.你可以用Kong现在使用的配置更新你的本地文件(可选):

小心!任何后续的堆转储将覆盖现有的kong.yaml文件。根据需要创建备份。

 $ deck dump

另外,在同步对配置的更改时,您还将在decK显示的差异中看到此配置。

你会注意到服务和路由现在都有了你没有显式设置的参数,这些是每个服务和路由创建时使用的默认参数:

services: - connect_timeout: 60000   host: mockbin.org   name: example_service   port: 80   protocol: http   read_timeout: 60000   retries: 5   write_timeout: 60000   routes:   - name: mocking     paths:     - /mock     path_handling: v0     preserve_host: false     protocols:     - http     - https     regex_priority: 0     strip_path: true     https_redirect_status_code: 426

你可以这样做后,任何deck同步看到Kong Gateway的最新配置。

本指南的其余部分继续使用配置文件的简化版本,但不为每个步骤执行deck转储,以使其易于遵循。

验证路由将请求转发给服务

Admin API

使用Admin API,发出以下信息:

使用cURL:

$ curl -i -X GET http://<admin-hostname>:8000/mock/request

或者使用HTTPie:

$ http :8000/mock/request
Web浏览器

默认情况下,Kong在端口8000上处理代理请求。

标签:

相关阅读

相关词

推荐阅读