{"id":13439570,"url":"https://github.com/Kong/kubernetes-ingress-controller","last_synced_at":"2025-03-20T08:31:39.762Z","repository":{"id":37405768,"uuid":"127765544","full_name":"Kong/kubernetes-ingress-controller","owner":"Kong","description":":gorilla: Kong for Kubernetes: The official Ingress Controller for Kubernetes.","archived":false,"fork":false,"pushed_at":"2024-04-15T03:04:14.000Z","size":64611,"stargazers_count":2130,"open_issues_count":258,"forks_count":582,"subscribers_count":66,"default_branch":"main","last_synced_at":"2024-04-15T03:18:28.328Z","etag":null,"topics":["apis","crds","ingress","ingress-controller","k8s","kong","kubernetes","kubernetes-ingress","kubernetes-ingress-controller","microservices"],"latest_commit_sha":null,"homepage":"https://docs.konghq.com/kubernetes-ingress-controller/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kong.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-04-02T14:13:52.000Z","updated_at":"2024-07-24T21:40:14.458Z","dependencies_parsed_at":"2023-10-20T21:03:04.247Z","dependency_job_id":"196e4404-cbd6-4ead-b1cc-86471129e48d","html_url":"https://github.com/Kong/kubernetes-ingress-controller","commit_stats":{"total_commits":2929,"total_committers":128,"mean_commits":22.8828125,"dds":0.8081256401502219,"last_synced_commit":"663cef5358cf71191513561f65f385479865a2c8"},"previous_names":[],"tags_count":101,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fkubernetes-ingress-controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fkubernetes-ingress-controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fkubernetes-ingress-controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fkubernetes-ingress-controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kong","download_url":"https://codeload.github.com/Kong/kubernetes-ingress-controller/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221739734,"owners_count":16872779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apis","crds","ingress","ingress-controller","k8s","kong","kubernetes","kubernetes-ingress","kubernetes-ingress-controller","microservices"],"created_at":"2024-07-31T03:01:15.214Z","updated_at":"2024-10-27T22:31:19.439Z","avatar_url":"https://github.com/Kong.png","language":"Go","funding_links":[],"categories":["HarmonyOS","Go","Ingress controllers","Tools and Libraries","microservices","Load Balancing \u0026 Ingress","Tools"],"sub_categories":["Windows Manager","Networking","Distributions"],"readme":"[![kong-logo]][kong-url]\n[![Build Status](https://github.com/Kong/kubernetes-ingress-controller/actions/workflows/checks.yaml/badge.svg)](https://github.com/Kong/kubernetes-ingress-controller/actions/workflows/checks.yaml)\n[![Go Reference](https://pkg.go.dev/badge/github.com/kong/kubernetes-ingress-controller/v3.svg)](https://pkg.go.dev/github.com/kong/kubernetes-ingress-controller/v3)\n[![Codecov](https://codecov.io/gh/Kong/kubernetes-ingress-controller/branch/main/graph/badge.svg?token=S1aqcXiGEo)](https://codecov.io/gh/Kong/kubernetes-ingress-controller)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/Kong/kong/blob/master/LICENSE)\n[![Twitter](https://img.shields.io/twitter/follow/thekonginc.svg?style=social\u0026label=Follow)](https://twitter.com/intent/follow?screen_name=thekonginc)\n[![Conformance](https://img.shields.io/badge/Gateway%20API%20Conformance%20v1.0.0-Kong%20Ingress%20Controller%203.0-green)](https://github.com/kubernetes-sigs/gateway-api/blob/main/conformance/reports/v1.0.0/kong-kubernetes-ingress-controller.yaml)\n\n# Kong Ingress Controller for Kubernetes (KIC)\n\nUse [Kong][kong] for Kubernetes [Gateway API][gwapi] or [Ingress][ingress].\nConfigure [plugins][docs-konghq-hub], health checking,\nload balancing and more, all using\nCustom Resource Definitions (CRDs) and Kubernetes-native tooling.\n\n[**Features**](#features) | [**Get started**](#get-started) | [**Documentation**](#documentation) | [**main branch builds**](#main-branch-builds) | [**Seeking help**](#seeking-help)\n\n## Features\n\n- **Gateway API support**\n  Use [Gateway API][gwapi] resources (official successor of [Ingress][ingress] resources) to configure Kong.\n  Native support for TCP, UDP, TLS, gRPC and HTTP/HTTPS traffic, reuse the same gateway for multiple protocols and namespaces.\n- **Ingress support**\n  Use [Ingress][ingress] resources to configure Kong.\n- **Declarative configuration for Kong**\n  Configure all of Kong features in declarative Kubernetes native way with CRDs.\n- **Seamlessly operate Kong**\n  Scale and manage multiple replicas of Kong Gateway automatically to ensure performance and high-availability.\n- **Health checking and load-balancing**\n  Load balance requests across your pods and supports active \u0026 passive health-checks.\n- **Enhanced API management using plugins**\n  Use a wide array of [plugins][docs-konghq-hub] for e.g.\n  - authentication\n  - request/response transformations\n  - rate-limiting\n\n## Get started (using Helm)\n\nYou can use [Minikube or Kind][k8s-io-tools] on your local machine or use\na hosted Kubernetes service like [GKE](https://cloud.google.com/kubernetes-engine/).\n\n### Install the Gateway API CRDs\n\nThis command will install all resources that have graduated to GA or beta,\nincluding `GatewayClass`, `Gateway`, `HTTPRoute`, and `ReferenceGrant`.\n\n```shell\nkubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/standard-install.yaml\n```\n\nOr, if you want to use experimental resources and fields such as `TCPRoute`s and `UDPRoute`s,\nplease run this command.\n\n```shell\nkubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/experimental-install.yaml\n```\n\n### Install the Kong Ingress Controller with Helm\n\n```shell\nhelm install kong --namespace kong --create-namespace --repo https://charts.konghq.com ingress\n```\n\nTo learn more details about Helm chart follow the [Helm chart documentation](https://charts.konghq.com/).\n\nOnce installed, please follow the [Getting Started guide][docs-konghq-getting-started-guide]\nto start using Kong in your Kubernetes cluster.\n\n\u003e Note: Kong Enterprise users, please follow along with our\n[enterprise guide][docs-konghq-k4k8s-enterprise-setup] to setup the enterprise version.\n\n## Get started (using Operator) \n\nAs an alternative to Helm, you can also install Kong Ingress Controller using the **Kong Gateway Operator** by following this [quick start guide][kgo-guide].\n\n## Container images\n\n### Release images\n\nRelease builds of Kong Ingress Controller can be found on Docker Hub in\n[kong/kubernetes-ingress-controller repository][dockerhub-kic].\n\nAt the moment we're providing images for:\n\n- Linux `amd64`\n- Linux `arm64`\n\n### `main` branch builds\n\nNightly pre-release builds of the `main` branch are available from the\n[kong/nightly-ingress-controller repository][dockerhub-kic-nightly] hosted on Docker Hub:\n\n`main` contains unreleased new features for upcoming minor and major releases:\n\n```shell\ndocker pull kong/nightly-ingress-controller:nightly\n```\n\n## Documentation\n\nAll documentation for the Kong Ingress Controller is present in the [kong/docs.konghq.com](https://github.com/kong/docs.konghq.com) repository. Pull Requests are welcome for additions and corrections.\n\n### Guides and Tutorials\n\nPlease browse through the [guides][docs-konghq-kic-guides] to get started and to learn specific ingress controller operations.\n\n## Contributing\n\nWe ❤️ pull requests and we’re continually working hard to make it as easy as possible for developers to contribute.\nBefore beginning development with the Kong Ingress Controller, please familiarize yourself with the following developer resources:\n\n- [TESTING](TESTING.md)\n- [CONTRIBUTING](CONTRIBUTING.md)\n- [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md)\n- [COPYRIGHT](https://github.com/Kong/kong/blob/master/COPYRIGHT)\n\n## Seeking help\n\nPlease search through the [FAQs][docs-konghq-faqs], posts on the\n[discussions page][github-kic-discussions] or the\n[Kong Nation Forums](https://discuss.konghq.com/c/kubernetes)\nas it's likely that another user has run into the same problem.\nIf you don't find an answer, please feel free to post a question.\n\nIf you've found a bug, please [open an issue][github-kic-issues].\n\nFor a feature request, please open an issue using the feature request template.\n\nYou can also talk to the developers behind Kong in the\n[#kong][slack-kubernetes-kong] channel on the Kubernetes Slack server.\n\n### Community meetings\n\nYou can join monthly meetups hosted by [Kong](https://konghq.com) to ask questions, provide feedback, or just to listen and hang out.\nSee the [Online Meetups Page](https://konghq.com/online-meetups/) to sign up and receive meeting invites and [Zoom](https://zoom.us) links.\n\n## Preview and Experimental Features\n\nAt any time the KIC may include features or options that are considered\nexperimental and are not enabled by default, nor available in the [Kong\nDocumentation Site][docs-konghq].\n\nTo try out new features that are behind feature gates, please see the\npreview features in [FEATURE_GATES.md][fgates] and documentation for these\npreview features can be found in [FEATURE_PREVIEW_DOCUMENTATION.md][fpreview].\n\n[fgates]:/FEATURE_GATES.md\n[fpreview]:/FEATURE_PREVIEW_DOCUMENTATION.md\n[ingress]: https://kubernetes.io/docs/concepts/services-networking/ingress/\n[gwapi]: https://gateway-api.sigs.k8s.io/\n[kong]: https://konghq.com/kong\n[kong-url]: https://konghq.com/\n[kong-logo]: https://konghq.com/wp-content/uploads/2018/05/kong-logo-github-readme.png\n[k8s-io-tools]: https://kubernetes.io/docs/tasks/tools/\n[slack-Kubernetes-kong]: https://kubernetes.slack.com/messages/kong\n\n[dockerhub-kic]: https://hub.docker.com/r/kong/kubernetes-ingress-controller\n[dockerhub-kic-nightly]: https://hub.docker.com/r/kong/nightly-ingress-controller\n\n[github-kic-discussions]: https://github.com/Kong/kubernetes-ingress-controller/discussions\n[github-kic-issues]: https://github.com/kong/kubernetes-ingress-controller/issues\n\n[docs-konghq]:https://docs.konghq.com\n[docs-konghq-hub]: https://docs.konghq.com/hub/\n[docs-konghq-faqs]: https://docs.konghq.com/kubernetes-ingress-controller/latest/faq/\n[docs-konghq-getting-started-guide]: https://docs.konghq.com/kubernetes-ingress-controller/latest/guides/getting-started/\n[docs-konghq-k4k8s-enterprise-setup]: https://docs.konghq.com/kubernetes-ingress-controller/latest/deployment/k4k8s-enterprise/\n[docs-konghq-kic-guides]: https://docs.konghq.com/kubernetes-ingress-controller/latest/guides/overview/\n\n[kgo-guide]: https://docs.konghq.com/gateway-operator/latest/get-started/kic/install/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKong%2Fkubernetes-ingress-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKong%2Fkubernetes-ingress-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKong%2Fkubernetes-ingress-controller/lists"}