You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by "kayx23 (via GitHub)" <gi...@apache.org> on 2023/06/29 07:15:36 UTC
[GitHub] [apisix-website] kayx23 opened a new pull request, #1629: blog: add Apache APISIX 3.4.0 release note
kayx23 opened a new pull request, #1629:
URL: https://github.com/apache/apisix-website/pull/1629
feat: release APISIX 3.4.0: https://github.com/apache/apisix/pull/9730
est. release date: June 30, 2023
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix-website] yzeng25 commented on a diff in pull request #1629: blog: add Apache APISIX 3.4.0 release notes
Posted by "yzeng25 (via GitHub)" <gi...@apache.org>.
yzeng25 commented on code in PR #1629:
URL: https://github.com/apache/apisix-website/pull/1629#discussion_r1249200739
##########
blog/en/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,114 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: The Apache APISIX 3.4.0 version is released on June 30, 2023. This version adds a new plugin for Grafana Loki, allows for mTLS connection on the route level, and made performance optimization to continuously enhance the user experience of APISIX.
+tags: [Community]
+---
+
+We are pleased to present Apache APISIX 3.4.0 with exciting new features and performance improvements.
+
+<!--truncate-->
+
+This release provides a new plugin `loki-logger` to forward logs to [Grafana Loki](https://grafana.com/oss/loki/), and allows for mTLS connection on the route level. In addition, the release also includes many other updates to continuously enhance the user experience of APISIX.
+
+## New Features
+
+### Support integration with Grafana Loki using the `loki-logger` plugin
+
+The `loki-logger` plugin is used to forward logs to [Grafana Loki](https://grafana.com/oss/loki/) for analysis and storage.
+
+When the plugin is enabled, APISIX serializes the request context information to [log entries in JSON](https://grafana.com/docs/loki/latest/api/#push-log-entries-to-loki) and submits it to the batch queue. When the maximum batch size is reached, the data in the queue is pushed to Loki.
+
+For example, you can enable the `loki-logger` plugin on a specific route:
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "plugins": {
+ "loki-logger": {
+ "endpoint_addrs" : ["http://127.0.0.1:3100"]
+ }
+ },
+ "upstream": {
+ "nodes": {
+ "127.0.0.1:1980": 1
+ },
+ "type": "roundrobin"
+ },
+ "uri": "/hello"
+}'
+```
+
+If successful, APISIX logs should be forwarded to Loki running at `http://127.0.0.1:3100`.
+
+For more information about the plugin, see `loki-logger` [plugin doc](https://github.com/apache/apisix/blob/release/3.4/docs/en/latest/plugins/loki-logger.md).
+
+PR for this feature could be found here [#9399](https://github.com/apache/apisix/pull/9399).
+
+### Support route-level mTLS
+
+Support configuring mTLS on the route level. The Admin API SSL object now has a new configuration option, `client.skip_mtls_uri_regex`. Users can specify a list of URIs (RegEx supported) in this option, for which the verification of the client certificate should be skipped.
+
+For example, you can configure a route-level mTLS such as the following:
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 \
+-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "uri": "/*",
+ "upstream": {
+ "nodes": {
+ "httpbin.org": 1
+ }
+ }
+}'
+```
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/ssls/1 \
+-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "cert": "'"$(path/to/certs/mtls_server.crt)"'",
+ "key": "'"$(path/to/certs/mtls_server.key)"'",
+ "snis": [
+ "*.apisix.dev"
+ ],
+ "client": {
+ "ca": "'"$(path/to/certs/mtls_ca.crt)"'",
+ "depth": 10,
+ "skip_mtls_uri_regex": [
+ "/anything.*"
+ ]
+ }
+}'
+```
+
+If the URI of a request is in the `skip_mtls_uri_regex` list, then the client certificate will not be checked. Note that other URIs of the associated SNI will get HTTP 400 response instead of an alert error in the SSL handshake phase, if the client certificate is missing or invalid.
Review Comment:
delete trailing space.
```suggestion
If the URI of a request is in the `skip_mtls_uri_regex` list, then the client certificate will not be checked. Note that other URIs of the associated SNI will get HTTP 400 response instead of an alert error in the SSL handshake phase, if the client certificate is missing or invalid.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix-website] yzeng25 commented on a diff in pull request #1629: blog: add Apache APISIX 3.4.0 release notes
Posted by "yzeng25 (via GitHub)" <gi...@apache.org>.
yzeng25 commented on code in PR #1629:
URL: https://github.com/apache/apisix-website/pull/1629#discussion_r1248554012
##########
blog/en/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,112 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: The Apache APISIX 3.4.0 version is released on June 30, 2023. This version adds a new plugin for Grafana Loki, allows for mTLS connection on the route level, and made performance optimization to continuously enhance the user experience of APISIX.
+tags: [Community]
+---
+
+We are pleased to present Apache APISIX 3.4.0 with exciting new features and performance improvements.
+
+This release provides a new plugin `loki-logger` to forward logs to [Grafana Loki](https://grafana.com/oss/loki/), and allows for mTLS connection on the route level. In addition, the release also includes many other updates to continuously enhance the user experience of APISIX.
Review Comment:
Please add `<!--truncate-->` to avoid display issue in the blog summary page. An example of missing `<!--truncate-->` would be https://github.com/apache/apisix-website/issues/1606, this issue will give you a better idea.
```suggestion
We are pleased to present Apache APISIX 3.4.0 with exciting new features and performance improvements.
<!--truncate-->
This release provides a new plugin `loki-logger` to forward logs to [Grafana Loki](https://grafana.com/oss/loki/), and allows for mTLS connection on the route level. In addition, the release also includes many other updates to continuously enhance the user experience of APISIX.
```
##########
blog/zh/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,112 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: Apache APISIX 3.4.0 版本于2023年6月30日发布。此版本新增了一个适用于 Grafana Loki 的插件，允许在路由级别上建立 mTLS 连接，并进行性能优化，不断提升 APISIX 的用户体验。
+tags: [Community]
+---
+
+我们很高兴地介绍 Apache APISIX 3.4.0，它带来了令人兴奋的新功能和性能改进。
+
+此版本提供了一个新的插件 `loki-logger`，可将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/)，并允许在路由级别上建立 mTLS 连接。此外，此版本还还引入了许多新的特性，旨在优化对 APISIX 的使用体验。
Review Comment:
ditto, please add `<!--truncate-->`.
```suggestion
我们很高兴地介绍 Apache APISIX 3.4.0，它带来了令人兴奋的新功能和性能改进。
`<!--truncate-->`
此版本提供了一个新的插件 `loki-logger`，可将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/)，并允许在路由级别上建立 mTLS 连接。此外，此版本还还引入了许多新的特性，旨在优化对 APISIX 的使用体验。
```
##########
blog/zh/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,112 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: Apache APISIX 3.4.0 版本于2023年6月30日发布。此版本新增了一个适用于 Grafana Loki 的插件，允许在路由级别上建立 mTLS 连接，并进行性能优化，不断提升 APISIX 的用户体验。
Review Comment:
```suggestion
description: Apache APISIX 3.4.0 版本于 2023 年 6 月 30 日发布。此版本新增了一个适用于 Grafana Loki 的插件，允许在路由级别上建立 mTLS 连接，并进行性能优化，不断提升 APISIX 的用户体验。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix-website] kayx23 commented on a diff in pull request #1629: blog: add Apache APISIX 3.4.0 release notes
Posted by "kayx23 (via GitHub)" <gi...@apache.org>.
kayx23 commented on code in PR #1629:
URL: https://github.com/apache/apisix-website/pull/1629#discussion_r1248347429
##########
blog/zh/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,112 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: Apache APISIX 3.4.0 版本于2023年6月30日发布。此版本新增了一个适用于 Grafana Loki 的插件，允许在路由级别上建立 mTLS 连接，并进行性能优化，不断提升 APISIX 的用户体验。
+tags: [Community]
+---
+
+我们很高兴地介绍 Apache APISIX 3.4.0，它带来了令人兴奋的新功能和性能改进。
+
+此版本提供了一个新的插件 `loki-logger`，可将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/)，并允许在路由级别上建立 mTLS 连接。此外，此版本还还引入了许多新的特性，旨在优化对 APISIX 的使用体验。
+
+## 新功能
+
+### 使用 `loki-logger` 插件支持与 Grafana Loki 集成
+
+`loki-logger` 插件被用于将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/) 进行分析和存储。
+
+启用插件后，APISIX 会将请求上下文信息序列化为[JSON 格式的 Log 条目](https://grafana.com/docs/loki/latest/api/#push-log-entries-to-loki)，并将其提交到批处理队列。当队列条件满足时数据将被推送到 Grafana Loki。
+
+例如，您可以在特定路由上启用 `loki-logger` 插件：
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "plugins": {
+ "loki-logger": {
+ "endpoint_addrs" : ["http://127.0.0.1:3100"]
+ }
+ },
+ "upstream": {
+ "nodes": {
+ "127.0.0.1:1980": 1
+ },
+ "type": "roundrobin"
+ },
+ "uri": "/hello"
+}'
+```
+
+如果成功，APISIX 日志将被转发到运行在 `http://127.0.0.1:3100` 上的 Loki。
+
+有关该插件的更多信息，请参见 `loki-logger` [插件文档](https://github.com/apache/apisix/blob/release/3.4/docs/en/latest/plugins/loki-logger.md)。
Review Comment:
did not locate chinese doc for this
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix-website] kayx23 commented on a diff in pull request #1629: blog: add Apache APISIX 3.4.0 release notes
Posted by "kayx23 (via GitHub)" <gi...@apache.org>.
kayx23 commented on code in PR #1629:
URL: https://github.com/apache/apisix-website/pull/1629#discussion_r1248347429
##########
blog/zh/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,112 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: Apache APISIX 3.4.0 版本于2023年6月30日发布。此版本新增了一个适用于 Grafana Loki 的插件，允许在路由级别上建立 mTLS 连接，并进行性能优化，不断提升 APISIX 的用户体验。
+tags: [Community]
+---
+
+我们很高兴地介绍 Apache APISIX 3.4.0，它带来了令人兴奋的新功能和性能改进。
+
+此版本提供了一个新的插件 `loki-logger`，可将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/)，并允许在路由级别上建立 mTLS 连接。此外，此版本还还引入了许多新的特性，旨在优化对 APISIX 的使用体验。
+
+## 新功能
+
+### 使用 `loki-logger` 插件支持与 Grafana Loki 集成
+
+`loki-logger` 插件被用于将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/) 进行分析和存储。
+
+启用插件后，APISIX 会将请求上下文信息序列化为[JSON 格式的 Log 条目](https://grafana.com/docs/loki/latest/api/#push-log-entries-to-loki)，并将其提交到批处理队列。当队列条件满足时数据将被推送到 Grafana Loki。
+
+例如，您可以在特定路由上启用 `loki-logger` 插件：
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "plugins": {
+ "loki-logger": {
+ "endpoint_addrs" : ["http://127.0.0.1:3100"]
+ }
+ },
+ "upstream": {
+ "nodes": {
+ "127.0.0.1:1980": 1
+ },
+ "type": "roundrobin"
+ },
+ "uri": "/hello"
+}'
+```
+
+如果成功，APISIX 日志将被转发到运行在 `http://127.0.0.1:3100` 上的 Loki。
+
+有关该插件的更多信息，请参见 `loki-logger` [插件文档](https://github.com/apache/apisix/blob/release/3.4/docs/en/latest/plugins/loki-logger.md)。
Review Comment:
did not locate chinese doc for this `loki-logger`
##########
blog/zh/blog/2023/06/30/release-apache-apisix-3.4.0.md:
##########
@@ -0,0 +1,112 @@
+---
+title: "Release Apache APISIX 3.4.0"
+authors:
+ - name: "Xin Rong"
+ title: "Author"
+ url: "https://github.com/AlinsRan"
+ image_url: "https://avatars.githubusercontent.com/u/79972061?v=4"
+ - name: "Traky Deng"
+ title: "Technical Writer"
+ url: "https://github.com/kayx23"
+ image_url: "https://avatars.githubusercontent.com/u/39619599?v=4"
+keywords:
+- Apache APISIX
+- API Gateway
+- API Management Platform
+- New Release
+- Cloud Native
+description: Apache APISIX 3.4.0 版本于2023年6月30日发布。此版本新增了一个适用于 Grafana Loki 的插件，允许在路由级别上建立 mTLS 连接，并进行性能优化，不断提升 APISIX 的用户体验。
+tags: [Community]
+---
+
+我们很高兴地介绍 Apache APISIX 3.4.0，它带来了令人兴奋的新功能和性能改进。
+
+此版本提供了一个新的插件 `loki-logger`，可将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/)，并允许在路由级别上建立 mTLS 连接。此外，此版本还还引入了许多新的特性，旨在优化对 APISIX 的使用体验。
+
+## 新功能
+
+### 使用 `loki-logger` 插件支持与 Grafana Loki 集成
+
+`loki-logger` 插件被用于将日志转发到 [Grafana Loki](https://grafana.com/oss/loki/) 进行分析和存储。
+
+启用插件后，APISIX 会将请求上下文信息序列化为[JSON 格式的 Log 条目](https://grafana.com/docs/loki/latest/api/#push-log-entries-to-loki)，并将其提交到批处理队列。当队列条件满足时数据将被推送到 Grafana Loki。
+
+例如，您可以在特定路由上启用 `loki-logger` 插件：
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "plugins": {
+ "loki-logger": {
+ "endpoint_addrs" : ["http://127.0.0.1:3100"]
+ }
+ },
+ "upstream": {
+ "nodes": {
+ "127.0.0.1:1980": 1
+ },
+ "type": "roundrobin"
+ },
+ "uri": "/hello"
+}'
+```
+
+如果成功，APISIX 日志将被转发到运行在 `http://127.0.0.1:3100` 上的 Loki。
+
+有关该插件的更多信息，请参见 `loki-logger` [插件文档](https://github.com/apache/apisix/blob/release/3.4/docs/en/latest/plugins/loki-logger.md)。
Review Comment:
did not locate chinese doc for `loki-logger`
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix-website] SylviaBABY merged pull request #1629: blog: add Apache APISIX 3.4.0 release notes
Posted by "SylviaBABY (via GitHub)" <gi...@apache.org>.
SylviaBABY merged PR #1629:
URL: https://github.com/apache/apisix-website/pull/1629
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [apisix-website] yzeng25 commented on pull request #1629: blog: add Apache APISIX 3.4.0 release notes
Posted by "yzeng25 (via GitHub)" <gi...@apache.org>.
yzeng25 commented on PR #1629:
URL: https://github.com/apache/apisix-website/pull/1629#issuecomment-1616354679
LGTM, please fix lint.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org