Use Kong for Kubernetes Ingress.
Configure plugins, health checking,
load balancing and more in Kong
for Kubernetes Services, all using
Custom Resource Definitions(CRDs) and Kubernetes-native tooling.
- Ingress routing: Use Ingress resources to configure Kong
- Health checking and Load-balancing: Load balance requests across your pods and supports active & passive health-checks.
- Configure Plugins: Execute custom code as a request is proxied to your service.
- Request/response transformations: Use plugins to modify your requests/responses on the fly.
- Authentication: Protect your services using authentication plugins.
- Declarative configuration for Kong Configure all of Kong using CRDs in Kubernetes and manage Kong declaratively.
Version compatibility doc details on compatibility between versions of the controller and versions of Kong, Kong for Kubernetes Enterprise and Kong Enterprise.
You can deploy Kong Ingress Controller on any
Kubernetes cluster which supports a Service of type: LoadBalancer.
You can use Minikube on your local machine or use a hosted k8s service like GKE.
To setup Kong Ingress Controller in your k8s cluster, execute:
# using YAMLs
kubectl apply -f https://bit.ly/k4k8s
# or using Helm
helm install stable/kongIf you are setting up Kong for Kubernetes Enterprise, please follow along this guide.
It takes a few minutes for all components to spin up. You now have set up Kong as your Ingress point and all Ingress resources in your Kubernetes Cluster will be satisfied.
Follow the Getting Started guide to start using Ingress in Kubernetes.
All documentation around Kong Ingress Controller is present in this repository inside the docs directory. Pull Requests are welcome for additions and corrections.
Following are some helpful link:
- Getting Started: Get Kubernetes Ingress setup up and running.
- Deployment: Deployment guides for Minikube, GKE and other types of clusters.
- Custom Resources Definitions (CRDs): Use custom resources to configure Kong in addition to the Ingress resource.
- Annotations: Associate plugins with your requests using annotations
- FAQs: Frequently Asked Questions.
Please search through the posts on Kong Nation as it's likely that another user has run into the same problem. If you don't find an answer, please feel free to post a question. For a feature request, please post in Feature Suggestions category.
You can also talk to the developers behind Kong in the #kong channel on the Kubernetes Slack server.
If you've spotted a bug, please open an issue on our Github.
Copyright 2018 Kong Inc.
Licensed 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.