Kong 2.1.0 released!

Announcements
#1

Hello, Kong Nation!

:fireworks:

We are happy to announce that Kong 2.1.0 is now generally available!

Since Kong Gateway 2.0 was released in January, we have released a number of patch releases, but we have also been busy writing new features as well! This release comes packed with new functionality:

  • Asynchrounous load balancer Updates
  • New gRPC plugins
  • Plugin improvements all around
  • Postgres read-only replica support
  • Dynamic upstream keepalive pools
  • Per-service customization of TLS parameters
  • Hybrid Mode and declarative config improvements
  • Additions to the PDK
  • and more!

:rocket: Check out the announcement post at the Kong blog for all details!! :rocket:

Download

:package: Download Kong 2.1.0 today!

:whale: Updated Docker images should be live soon on Docker Hub.

More Info

:open_book: For more details about the updated installation, please visit the official docs: https://konghq.com/install.

:spiral_notepad: For detailed technical notes, links to PRs and so on, here’s a link to the 2.1.0 Changelog.

Thank you all for the feedback during our beta cycle, and keep sending in your impressions of the new release! :rocket:

Happy Konging! :gorilla:

1 Like
#2

Hi,
The 2.1.0 version introduces some changes in the Nginx configuration file.
Those of us who use a custom template must update it accordingly.
For example, after upgrading to 2.1.0 I get this error at runtime:

[error] 31866#0: *21 lua entry thread aborted: runtime error: /usr/local/share/lua/5.1/kong/runloop/handler.lua:1237: variable "upstream_x_forwarded_prefix" not found for writing; maybe it is a built-in variable that is not changeable or you forgot to use "set $upstream_x_forwarded_prefix '';" in the config file to define it first

To solve this the following must be added to the custom template:
set $upstream_x_forwarded_prefix '';

Is it possible to document all changes to the Nginx configuration file under https://github.com/Kong/kong/blob/master/UPGRADE.md as was done for previous versions?

2 Likes
#3

Hi,
After upgrading Kong to version 2.1.0 on macOS I see the following warnings/notice logs on Kong boot:

nginx: [warn] load balancing method redefined in /usr/local/opt/kong/nginx-kong.conf:60
2020/07/21 22:36:25 [notice] 28551#0: [lua] regex.lua:413: parse_regex_opts(): regex compilation cache disabled in init phase under macOS
2020/07/21 22:36:25 [notice] 28551#0: [lua] regex.lua:417: parse_regex_opts(): regex compilation disabled in init phase under macOS
2020/07/21 22:36:25 [warn] 28551#0: [lua] init.lua:114: missing method ‘ngx_balancer.enable_keepalive()’ (was the dyn_upstream_keepalive patch applied?) set the ‘nginx_upstream_keepalive’ configuration property instead of ‘upstream_keepalive_pool_size’
nginx: [warn] [lua] init.lua:114: missing method ‘ngx_balancer.enable_keepalive()’ (was the dyn_upstream_keepalive patch applied?) set the ‘nginx_upstream_keepalive’ configuration property instead of ‘upstream_keepalive_pool_size’
2020/07/21 22:36:25 [notice] 28551#0: [lua] regex.lua:417: parse_regex_opts(): regex compilation disabled in init phase under macOS
2020/07/21 22:36:25 [notice] 28551#0: [lua] regex.lua:413: parse_regex_opts(): regex compilation cache disabled in init phase under macOS
2020/07/21 22:36:25 [notice] 28551#0: [lua] regex.lua:417: parse_regex_opts(): regex compilation disabled in init phase under macOS
2020/07/21 22:36:25 [notice] 28551#0: [lua] regex.lua:413: parse_regex_opts(): regex compilation cache disabled in init phase under macOS
2020/07/21 22:36:26 [notice] 28551#0: [lua] regex.lua:417: parse_regex_opts(): regex compilation disabled in init phase under macOS
2020/07/21 22:36:26 [notice] 28551#0: [lua] regex.lua:413: parse_regex_opts(): regex compilation cache disabled in init phase under macOS

Is that expected?
Thanks

#4

@ayala Hello,

How did you install Kong 2.1.0 on macOs? Is it via Homebrew or some other method (see installations)?

Best,

#5

@dorongold Yes, the UPGRADE.md update is coming shortly, thanks for the heads up!

1 Like
#6

@thibaultcha Yes, I have installed the new version via Homebrew

#7

@ayala The homebrew formulas have just been fixed to ensure that the OpenResty dependency pulls the latest version with all needed patches — thanks for reporting!

#8

@hisham Thanks
I reinstalled Kong but I still see some errors (less than before):

nginx: [warn] load balancing method redefined in /usr/local/opt/kong/nginx-kong.conf:60
2020/07/28 14:15:37 [notice] 48547#0: [lua] regex.lua:413: parse_regex_opts(): regex compilation 
cache disabled in init phase under macOS
2020/07/28 14:15:37 [notice] 48547#0: [lua] regex.lua:417: parse_regex_opts(): regex compilation 
disabled in init phase under macOS
2020/07/28 14:15:37 [notice] 48547#0: [lua] regex.lua:417: parse_regex_opts(): regex compilation 
disabled in init phase under macOS
2020/07/28 14:15:37 [notice] 48547#0: [lua] regex.lua:413: parse_regex_opts(): regex compilation 
cache disabled in init phase under macOS
2020/07/28 14:15:38 [notice] 48547#0: using the "kqueue" event method
2020/07/28 14:15:38 [notice] 48547#0: openresty/1.15.8.3
2020/07/28 14:15:38 [notice] 48547#0: built by clang 10.0.1 (clang-1001.0.46.4)
#9

@ayala Those aren’t errors. The warning is letting you know that you have two load balancing methods in use (probably a leftover nginx_upstream_keepalive_* value set in your configuration). With the new dynamic upstream keepalive pools in 2.1 replacing this older mechanism, you can drop this legacy option and the warning will go away.
The other logs are notice logs and aren’t harmful in any way.