There are many different ways to deploy Kong Gateway. In this post, Viktor Gamov (Principal Developer Advocate at Kong) walks through the four most popular ways.
Depending on your particular use case, you may find that one or more of these is a good fit. Let's get started!
Using the DB-less and declarative configuration mode is one of the quickest and easiest ways to get started with Kong Gateway. For this mode, start with a Kong.yml file (which includes declarative configuration for Kong objects like services, plugins, and routes).
We can start Kong by providing this declarative configuration. One note here is that the Kong Admin API will only be available in Read Only mode. But if you want to make any changes to the configuration, you’ll need to submit the file to the /config endpoint with the new configuration.
Because this configuration doesn't rely on pulling data from anywhere or automatic updates, we call this DB-less mode. It's extremely simple and lightweight. If you're running the Kong Ingress Controller, this is a great option because KIC deploys and ships the declarative configuration through this config API.
If you're looking to scale your deployment and make incremental changes to your configuration, you'll need to use the Kong Admin API.
This requires introducing a database. The Kong Admin API will be available with configurations for services, plugins, and routes. We call this traditional mode.
This can be used with just a single cluster node or with multiple clusters — but all of them will derive their configuration from the database and the configuration established there. You’ll still need a load balancer in front of the database to assist with routing (this can also be Kong), but the configuration will be consistent.
With this deployment mode, you can also use Kong Manager and the Developer Portal with the database. But one caution here: you may run into a challenge where you’re spending a lot of effort maintaining the database, instead of on your applications. In order to optimize performance, Kong supports a cluster of Postgres, integration with read-only replicas, and doesn't call from the database each time.
If you’re still looking to solve the challenge of having too many calls from the database, you can deploy Kong in hybrid mode.
With this mode, different Kong nodes take on different Kong roles. This is done by creating a Kong instance that is explicitly serving the role of data plane (there can be multiples) with another instance that manages centralized configuration called the control plane. The data plane (or data planes) serves user traffic and is separated from the control plane.
In this mode, only the control plane talks to the database, and it isn't directly serving user traffic.
Kong Manager and Developer Portal are available in this mode as well and are part of the control plane, working directly with the database. So this deployment mode solves a lot of the scaling challenges you might face in traditional mode.
For organizations with many APIs looking to segregate deployment based on environment (for example, different environments for development, QA, regions, etc), the best deployment option is Kong Konnect.
In this deployment mode, we still have our Kong data planes, but the control plane is a cloud-managed control plane. This allows you to segregate and separate different environments using Runtime Manager. Kong Konnect also includes a Service Hub, where you can discover and publish your services — along with Developer Portal as a managed solution.
Kong Konnect also has built-in analytics for observing and monitoring your Kong instances. This allows you to have different Runtime Groups running in different environments (Docker, Kubernetes clusters, VMs, etc). With the managed cloud control plane in Kong Konnect, configuration is centralized and available to submit into different environments. This allows you to support GitOps or APIOps configurations. And with a SaaS control plane, the Kong Konnect team is able to quickly and frequently release new features, updates, and changes.
Get started quickly and easily by downloading Kong Gateway to launch in DB-less, traditional, or hybrid mode — or start a free trial of Kong Konnect to explore the cloud-managed control plane option.
Don’t forget to join the Kong Community to stay up to date on all things Kong — with access to Meetups, user calls, Tech Talks, and more!
Continued Learning & Related Content
We're pleased to announce the launch of Standard Webhooks! Kong has been part of the Technical Committee of this standard with other great companies like Svix (the initiator of the project), Ngrok, Zapier, Twillio, Lob, Mux, and Supabase. This was
There are many pros and cons for both GraphQL and REST APIs, but one of the areas where GraphQL really shines is API composition. Taking data from multiple APIs and combining them to make something new is a key part of delivering a useful service.
Infrastructure as code is a core component of all modern SRE team's day-to-day work. There are plenty of options available, but the one that I'm most excited about is Pulumi . Instead of writing a domain-specific language (DSL) to configure your in
Change is the primary cause of service reliability issues for agile engineering teams. In this post, I’ll cover how you can limit the impact of a buggy change, making it past your quality gates with Kong Gateway and Spinnaker for canary deployment.
Kong Enterprise provides customers with the fastest, most scalable and flexible API management solution in the market. One of Kong's main advantages is the ability to quickly deploy and integrate with a customer's ecosystem of already-deployed solut
Routing Tricks and Tips Kong is very easy to get up and running: start an instance, configure a service, configure a route pointing to the service, and off it goes routing requests, applying any plugins you enable along the way. But Kong can do a lo
APIs have quietly powered the global shift to an interconnected economy. They’ve served as the data exchange highways behind the seamless experiences we now take for granted — booking a ride, paying a vendor, sending a message, syncing financial rec