Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(km) note Kong Manager perf issue in traditional mode #4015

Merged
merged 3 commits into from
Jun 15, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 17 additions & 11 deletions app/gateway/2.8.x/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ With {{site.base_gateway}}, users can:
* Create a thriving API developer ecosystem
* Proactively identify API-related anomalies and threats
* Secure and govern APIs/services, and improve API visibility across the
entire organization
entire organization.

## Extending the Kong Gateway
## Extending the {{site.base_gateway}}

{{site.base_gateway}} is a Lua application running in Nginx. {{site.base_gateway}}
is distributed along with [OpenResty](https://openresty.org/), which is a bundle
Expand All @@ -43,11 +43,11 @@ the [PDK reference](/gateway/{{page.kong_version}}/pdk), and the guide on

{{site.base_gateway}} is available in the following modes:

**Kong Gateway (OSS)**: an open-source package containing the basic API gateway
**{{site.base_gateway}} (OSS)**: an open-source package containing the basic API gateway
functionality and open-source plugins. You can manage the open-source Gateway
with Kong's [Admin API](#kong-admin-api) or with [declarative configuration](#deck).

**Kong Gateway** (available in
**{{site.base_gateway}}** (available in
[Free, Plus, or Enterprise modes](https://konghq.com/pricing)): Kong's API gateway
with added functionality.
* <span class="badge free"></span> In **Free mode**,
Expand Down Expand Up @@ -89,6 +89,12 @@ using the Kong Admin API.
### Kong Manager
{:.badge .free}

{:.note}
> **Note**: If you are running Kong in traditional mode, increased traffic could
> lead to potential performance with Kong Proxy.
> Server-side sorting and filtering large quantities of entities will also cause increased CPU usage in both Kong CP and database.


[Kong Manager](/gateway/{{page.kong_version}}/configure/auth/kong-manager) is
the graphical user interface (GUI) for {{site.base_gateway}}. It uses the Kong
Admin API under the hood to administer and control {{site.base_gateway}}.
Expand Down Expand Up @@ -116,7 +122,7 @@ object-level health using intuitive, customizable dashboards

{{site.base_gateway}} can run natively on Kubernetes with its custom [ingress controller](/kubernetes-ingress-controller/), Helm chart, and Operator. A Kubernetes ingress controller is a proxy that exposes Kubernetes services from applications (for example, Deployments, ReplicaSets) running on a Kubernetes cluster to client applications running outside of the cluster. The intent of an ingress controller is to provide a single point of control for all incoming traffic into the Kubernetes cluster.

### Kong Gateway plugins
### {{site.base_gateway}} plugins

[{{site.base_gateway}} plugins](/hub/) provide advanced functionality to better manage your API and microservices. With turnkey capabilities to meet the most challenging use cases, {{site.base_gateway}} plugins ensure maximum control and minimizes unnecessary overhead. Enable features like authentication, rate-limiting, and transformations by enabling {{site.base_gateway}} plugins through Kong Manager or the Admin API.

Expand All @@ -129,17 +135,17 @@ Kong also provides API lifecycle management tools that you can use with {{site.b

### decK
[decK](/deck) helps manage {{site.base_gateway}}’s configuration in a declarative fashion.
This means that a developer can define the desired state of Kong Gateway or
Konnect &ndash; services, routes, plugins, and more &ndash; and let decK handle
This means that a developer can define the desired state of {{site.base_gateway}} or
{{site.konnect_short_name}} &ndash; services, routes, plugins, and more &ndash; and let decK handle
implementation without needing to execute each step manually, as you would with
the Kong Admin API.


## Get started with Kong Gateway
## Get started with {{site.base_gateway}}

[Download and install Kong Gateway](/gateway/{{page.kong_version}}/install-and-run).
[Download and install {{site.base_gateway}}](/gateway/{{page.kong_version}}/install-and-run).
To test it out, you can choose either the open-source package, or
run Kong Gateway in free mode and also try out Kong Manager.
run {{site.base_gateway}} in free mode and also try out Kong Manager.

After installation, get started with one of our introductory guides:
* **[Quickstart](/gateway/{{page.kong_version}}/get-started/quickstart)**: An introduction to
Expand All @@ -149,7 +155,7 @@ The complete {{site.base_gateway}}
getting started guide provides in-depth examples, explanations, and step-by-step
instructions, and explores Kong's many available tools for managing the gateway.

### Try in Konnect
### Try in {{site.konnect_short_name}}

[{{site.konnect_product_name}}](/konnect/) can manage {{site.base_gateway}}
instances. With this setup, Kong hosts the control plane and you host your
Expand Down