微服务 API 网关 Kong 插件开发 – 存储自定义实体

原文地址:https://docs.konghq.com/1.1.x/plugin-development/custom-entities/ (不能保证所有的翻译都是准确无误的,所有如有翻译的不准确或错误之处,请一定记得查看原文,并欢迎留言指出)。 介绍 虽然不是所有插件都需要它,但是您的插件可能需要在数据库中存储比配置更多的东西。在这种情况下,Kong在其主要数据存储之上提供了一个抽象,允许您存储自定义实体。 如前一章节访问数据存储区所述。Kong通过我们称之为“DAOs”的类与模型层交互,并且可以在通常被称为“DAO Factory”的单例上使用。本章将解释如何为您自己的实体提供一个抽象体。 Modules kong.plugins.<plugin_name>.daos ko……

阅读全文 »

openSSL 的加密方式与证书制作

openSSL是什么 OpenSSL项目是安全套接字层(secure sockets layer,SSL)和传输层安全(transport layer security,TLS)协议的一个实现,是大家共同努力开发出的代码可靠、功能齐全、商业级别的开源工具集。除了OpenSSL之外的其他TLS实现方式,如GnuTLS、Mozilla的网络安全服务(NSS)和Windows平台的TLS。 项目由遍布世界的志愿者所组成的社区进行管理,他们通过互联网进行沟通、计划和开发OpenSSL工具集以及相关的文档。现在几乎所有的服务器软件和很多客户端软件都在使用OpenSSL,其中基于命令行的工具是进行密钥、证书管理以及测试最常用到的软件了。 公钥算法与私钥算法 私钥算法 私钥加密算法,又称 对称加密算法,因……

阅读全文 »

微服务 API 网关 Kong 单元测试中文文档

原文链接: https://docs.konghq.com/1.0.x/plugin-development/tests/ (如有翻译的不准确或错误之处,欢迎留言指出) 集成测试:https://docs.konghq.com/1.0.x/plugin-development/tests/#write-integration-tests 介绍 如果你认真对待你写的插件,你可能想为它编写一些测试。Lua的单元测试很简单,并且可以使用许多测试框架。但是,您可能还想编写集成测试。Kong可以再次为您提供支援。 编写集成测试 Kong的首选测试框架是busted,它与resty-cli解释器一起运行,但如果您愿意,可以自由使用另一个。在Kong存储库中,可以在bin/busted找到 busted ……

阅读全文 »

微服务 API 网关 Kong 命令行中文文档

原文链接: https://docs.konghq.com/1.0.x/cli/ (如有翻译的不准确或错误之处,欢迎留言指出) 介绍 提供的CLI(命令行界面Command Line Interface)允许启动,停止和管理Kong实例。CLI可以管理本地节点(如在当前计算机上)。 如果您还没有使用,我们建议您阅读配置参考。 通用标志参数 所有命令都将一组特殊的可选标志作为参数: –help:打印此命令的帮助信息 –v:启用详细模式 –vv:启用调试模式(很多输出) 可用命令 kong check Usage: kong check <conf> 检查给定Kong配置文件的有效性。 <conf> (default /etc/kong/kong.conf) 配置文……

阅读全文 »

微服务 API 网关 Kong File Log 插件中文文档

原文链接: https://docs.konghq.com/hub/kong-inc/file-log (如有翻译的不准确或错误之处,欢迎留言指出) 将请求和响应数据写入磁盘上的日志文件中。不建议在生产中使用此插件,在生产环境下,最好使用另一个日志插件,例如syslog。由于系统限制,此插件使用阻塞文件i/o,将会损害性能,因此是Kong安装的反面模式。 注意:此插件的功能与0.10.2之前的Kong版本捆绑在一起,与此处记录的不同。 有关详细信息,请参阅CHANGELOG。 配置 在服务上启用插件 通过发出以下请求在服务上配置此插件: $ curl -X POST http://kong:8001/services/{service}/plugins \ –data “name=file……

阅读全文 »

微服务 API 网关 Kong 1.0.0 升级指南

原文地址:https://docs.konghq.com/1.0.x/upgrading/#2-deprecation-notices (不能保证所有的翻译都是准确无误的,所有如有翻译的不准确或错误之处,请一定记得查看原文,并欢迎留言指出)。 注意:以下是1.0.x的升级指南。 如果您要升级到Kong的早期版本,请阅读Kong repo中的UPGRADE.md文件。 本指南将告知您在升级时应了解的重大更改,并指导您完成正确的步骤,以便在不同的升级方案中获得不需要停止服务的迁移。 升级到 1.0.0 此版本(1.0.0) 是Kong的主要版本,包括许多新功能以及重大变化。 这个版本中引入了新的插件架构格式,Admin API 终端的更改,数据库迁移,Nginx配置更改以及已删除的配置属性。 在……

阅读全文 »

你需要好好对待你的牙齿

从去年到今年,断断续续的把自己的牙齿整治了一番,拔掉两颗智齿,洗了两次牙,跟牙科医生交流了很多,了解了很多关于牙齿的知识,结论就是:你的牙齿可以一直使用下去,哪怕你已经七老八十。可能跟请我们大家多数人的印象不太一样,觉得人老了,牙齿就必须掉的七零八落,然而事实是,如果你对自己的牙齿正视起来,并且好好保护它,它将让你七八十岁还能嚼的动爆米花。 整齐的牙齿 如果你发现你的牙齿层次不齐,纵横交错,那么你可能需要注意了,这样的牙齿会极易引发一些牙齿疾病,比如不整齐的牙齿之间容易残留食物残渣,轻则造成口气难闻,重则就容易发生龋齿,以及沉积一些牙结石,牙结石增多的情况下,就会导致牙龈出血,然后诱发牙周炎啊一些乱七八糟的牙齿疾病。而且对于咬合也是有一定影响,会导致牙齿磨损不一。 如果你还是一个青少年,可以……

阅读全文 »

微服务 API 网关 Kong CORS 插件中文文档

原文地址:https://docs.konghq.com/hub/kong-inc/cors/ (不能保证所有的翻译都是准确无误的,所有如有翻译的不准确或错误之处,请一定记得查看原文,并欢迎留言指出)。 通过启用此插件,轻松将跨源资源共享(CORS)添加到 Service, Route 。 配置 在 Service 上启用插件 通过发出以下请求在 Service 上配置此插件: $ curl -X POST http://kong:8001/services/{service}/plugins \ –data “name=cors” \ –data “config.origins=http://mockbin.com” \ –data “config.methods=GET, POST……

阅读全文 »

微服务 API 网关 Kong 插件开发添加自定义配置文件

由于在 Kong 的插件开发中,需要添加一些自定义的配置文件,而且是一些插件公用的配置,但是又不方便都写在插件的 schema.lua 中,那么就考虑引入常规的配置文件,这里以.env文件为例,写一下添加和使用过程。 首先需要了解的是,Kong 的插件使用了一个叫 Classic 的 class 机制。所有的插件都是从 base_plugin.lua 基类上继承而来。base_plugin.lua 定义了插件在各个阶段被执行的方法名:,所以我们就从这里入手,以添加redis配置信息为例。 添加配置文件 进入到插件目录,我这里是/usr/local/share/lua/5.1/kong/plugins,然后新建一个.env文件,写入: REDIS_HOST=127.0.0.1 REDIS_PA……

阅读全文 »

微服务 API 网关 Kong 插件开发套件PDK 中文文档

原文地址:https://docs.konghq.com/1.0.x/pdk/(不能保证所有的翻译都是准确无误的,所有如有翻译的不准确或错误之处,请一定记得查看原文,并欢迎留言指出)。 插件开发工具包 Plugin Development Kit(或“PDK”)是一组Lua函数和变量,插件可以使用这些函数和变量来实现自己的逻辑。PDK是一个语义版本的组件,最初在Kong 0.14.0中发布。PDK将保证从1.0.0版本开始向前兼容。 截至本版本,PDK尚未达到1.0.0,但插件作者已经可以依赖它来使用安全可靠的方式进行请求、响应或者做一些核心组件。 可以从kong全局变量访问插件开发工具包,并在此表下命名各种功能,例如kong.request,kong.log等… kong.ve……

阅读全文 »

微服务 API 网关 Kong 配置文件中文详解

原文地址:https://docs.konghq.com/1.0.x/configuration/ (不能保证所有的翻译都是准确无误的,所有如有翻译的不准确或错误之处,请一定记得查看原文,并欢迎留言指出)。 配置加载 如果您通过官方软件包安装Kong,则可以在/etc/kong/kong.conf.default找到默认配置文件。 要开始配置Kong,您可以复制此配置文件文件: $ cp /etc/kong/kong.conf.default /etc/kong/kong.conf 如果您的配置文件中的所有值都被注释掉,Kong将使用默认设置运行。 启动时,Kong会自动查找可能包含配置文件的多个默认位置: /etc/kong/kong.conf /etc/kong.conf 您可以通过使用……

阅读全文 »

微服务 API 网关 Kong Route 中文文档

原文地址:https://docs.konghq.com/1.0.x/admin-api/#route-object (不能保证所有的翻译都是准确无误的,所有如有翻译的不准确或错误之处,请一定记得查看原文,并欢迎留言指出)。 route 路由 路由实体定义规则以匹配客户端请求。每个Route与一个服务相关联,一个服务可能有多个与之关联的路由。匹配给定路由的每个请求都将代理到其关联的服务。 Routes 和 Services 的组合(以及它们之间的关注点分离)提供了一种强大的路由机制,通过它可以在 Kong 中定义细粒度的入口点,从而导致基础架构的不同上游服务。 { “id”: “173a6cee-90d1-40a7-89cf-0329eca780a6″, “created_at”: 1422……

阅读全文 »