feat(apisix): add Cloudron package

- Implements Apache APISIX packaging for Cloudron platform.
- Includes Dockerfile, CloudronManifest.json, and start.sh.
- Configured to use Cloudron's etcd addon.

🤖 Generated with Gemini CLI
Co-Authored-By: Gemini <noreply@google.com>

CloudronPackages/APISIX/apisix-source/docs/en/latest/benchmark.md

@@ -0,0 +1,151 @@
+---
+title: Benchmark
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+### Benchmark Environments
+
+n1-highcpu-8 (8 vCPUs, 7.2 GB memory) on Google Cloud
+
+But we **only** used 4 cores to run APISIX, and left 4 cores for system and [wrk](https://github.com/wg/wrk),
+which is the HTTP benchmarking tool.
+
+### Benchmark Test for reverse proxy
+
+Only used APISIX as the reverse proxy server, with no logging, limit rate, or other plugins enabled,
+and the response size was 1KB.
+
+#### QPS
+
+The x-axis means the size of CPU core, and the y-axis is QPS.
+
+![benchmark-1](../../assets/images/benchmark-1.jpg)
+
+#### Latency
+
+Note the y-axis latency in **microsecond(μs)** not millisecond.
+
+![latency-1](../../assets/images/latency-1.jpg)
+
+#### Flame Graph
+
+The result of Flame Graph:
+![flamegraph-1](../../assets/images/flamegraph-1.jpg)
+
+And if you want to run the benchmark test in your machine, you should run another Nginx to listen 80 port.
+
+:::note
+You can fetch the `admin_key` from `config.yaml` and save to an environment variable with the following command:
+
+```bash
+admin_key=$(yq '.deployment.admin.admin_key[0].key' conf/config.yaml | sed 's/"//g')
+```
+
+:::
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H "X-API-KEY: $admin_key" -X PUT -d '
+{
+    "methods": ["GET"],
+    "uri": "/hello",
+    "upstream": {
+        "type": "roundrobin",
+        "nodes": {
+            "127.0.0.1:80": 1,
+            "127.0.0.2:80": 1
+        }
+    }
+}'
+```
+
+then run wrk:
+
+```shell
+wrk -d 60 --latency http://127.0.0.1:9080/hello
+```
+
+### Benchmark Test for reverse proxy, enabled 2 plugins
+
+Only used APISIX as the reverse proxy server, enabled the limit rate and prometheus plugins,
+and the response size was 1KB.
+
+#### QPS
+
+The x-axis means the size of CPU core, and the y-axis is QPS.
+
+![benchmark-2](../../assets/images/benchmark-2.jpg)
+
+#### Latency
+
+Note the y-axis latency in **microsecond(μs)** not millisecond.
+
+![latency-2](../../assets/images/latency-2.jpg)
+
+#### Flame Graph
+
+The result of Flame Graph:
+![flamegraph-2](../../assets/images/flamegraph-2.jpg)
+
+And if you want to run the benchmark test in your machine, you should run another Nginx to listen 80 port.
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H "X-API-KEY: $admin_key" -X PUT -d '
+{
+    "methods": ["GET"],
+    "uri": "/hello",
+    "plugins": {
+        "limit-count": {
+            "count": 999999999,
+            "time_window": 60,
+            "rejected_code": 503,
+            "key": "remote_addr"
+        },
+        "prometheus":{}
+    },
+    "upstream": {
+        "type": "roundrobin",
+        "nodes": {
+            "127.0.0.1:80": 1,
+            "127.0.0.2:80": 1
+        }
+    }
+}'
+```
+
+then run wrk:
+
+```shell
+wrk -d 60 --latency http://127.0.0.1:9080/hello
+```
+
+For more reference on how to run the benchmark test, you can see this [PR](https://github.com/apache/apisix/pull/6136) and this [script](https://gist.github.com/membphis/137db97a4bf64d3653aa42f3e016bd01).
+
+:::tip
+
+If you want to run the benchmark with a large number of connections, You may have to update the [**keepalive**](https://github.com/apache/apisix/blob/master/conf/config.yaml.example#L241) config by adding the configuration to [`config.yaml`](https://github.com/apache/apisix/blob/master/conf/config.yaml) and reload APISIX. Connections exceeding this number will become short connections. You can run the following command to test the benchmark with a large number of connections:
+
+```bash
+wrk -t200 -c5000 -d30s http://127.0.0.1:9080/hello
+```
+
+For more details, you can refer to [Module ngx_http_upstream_module](http://nginx.org/en/docs/http/ngx_http_upstream_module.html).
+
+:::