{"id":13741240,"url":"https://github.com/kong/gateway-operator","last_synced_at":"2025-06-19T22:36:09.379Z","repository":{"id":228791667,"uuid":"744016174","full_name":"Kong/gateway-operator","owner":"Kong","description":"Kubernetes Operator for Kong Gateways","archived":false,"fork":false,"pushed_at":"2025-06-16T10:46:23.000Z","size":11662,"stargazers_count":70,"open_issues_count":189,"forks_count":24,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-06-16T11:41:25.410Z","etag":null,"topics":["team-k8s"],"latest_commit_sha":null,"homepage":"","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":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":".github/supported_k8s_node_versions.yaml","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-16T13:18:55.000Z","updated_at":"2025-06-16T10:46:24.000Z","dependencies_parsed_at":"2024-05-20T10:26:03.002Z","dependency_job_id":"116c3cef-49e7-415e-9a3f-c251b829f487","html_url":"https://github.com/Kong/gateway-operator","commit_stats":null,"previous_names":["kong/gateway-operator"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/Kong/gateway-operator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fgateway-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fgateway-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fgateway-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fgateway-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kong","download_url":"https://codeload.github.com/Kong/gateway-operator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kong%2Fgateway-operator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260844643,"owners_count":23071649,"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":["team-k8s"],"created_at":"2024-08-03T04:00:57.125Z","updated_at":"2025-06-19T22:36:04.363Z","avatar_url":"https://github.com/Kong.png","language":"Go","funding_links":[],"categories":["Kubernetes Operators"],"sub_categories":[],"readme":"# [Kong Gateway Operator](https://docs.konghq.com/gateway-operator/latest/)\n\n\u003cimg src=\"./logo/logo.png\" alt=\"KGO logo\" title=\"Kong Gateway Operator\" height=\"150\" width=\"150\" /\u003e\n\nKong Gateway Operator is a [Kubernetes Operator][operator-concept] that can manage\nyour Kong Ingress Controller, Kong Gateway Data Planes, or both together when running\non Kubernetes.\n\nWith Kong Gateway Operator, users can:\n\n* Deploy and configure Kong Gateway services.\n* Customise deployments using `PodTemplateSpec` to:\n  * [Deploy sidecars][docs_sidecar],\n  * [Set image][docs_dataplane_image],\n  * [And much more][docs_podtemplatespec].\n* Upgrade Data Planes using a [rolling restart][docs_upgrade_rolling] or [blue/green deployments][docs_upgrade_bg].\n* Configure [auto scaling on Data Planes][docs_autoscaling].\n\n[docs_sidecar]: https://docs.konghq.com/gateway-operator/latest/customization/sidecars/\n[docs_dataplane_image]: https://docs.konghq.com/gateway-operator/latest/customization/data-plane-image/\n[docs_podtemplatespec]: https://docs.konghq.com/gateway-operator/latest/customization/pod-template-spec/\n[docs_upgrade_rolling]: https://docs.konghq.com/gateway-operator/latest/guides/upgrade/data-plane/rolling/\n[docs_upgrade_bg]: https://docs.konghq.com/gateway-operator/latest/guides/upgrade/data-plane/blue-green/\n[docs_autoscaling]: https://docs.konghq.com/gateway-operator/latest/guides/autoscaling-kong/\n\n## Current Features\n\nThe following features are considered supported:\n\n* Kong Gateway Deployment \u0026 Configuration Management using the [Gateway API][gwapi]\n* Creation of [Kong Gateways][konggw] using the `DataPlane` API\n* [Kong Gateways][konggw] upgrades, downgrades and autoscaling\n* Creation of [Kong Ingress Controller][kic] instances using the `ControlPlane` API\n* Hybrid Mode Attachment using the `DataPlane` API\n* Configuration and management of `AIGateway`s (experimental feature)\n\nSee our [Features Page](/FEATURES.md) for details on these capabilities.\n\n## API stability\n\nThe operator provides 2 APIs:\n\n- YAML / manifests API which users use to apply their manifests against Kubernetes clusters.\n- Go API through types exported under [api/](https://github.com/Kong/gateway-operator/tree/main/api)\n  and other exported packages.\n\nThis project:\n\n- Follows [Kubernetes API versioning][k8s_api_versioning] for the YAML API.\n  - This is considered part of the user contract.\n- Tries to not break users implementing against operator's Go API but does not\n  offer a non breaking guarantee.\n\n[k8s_api_versioning]: https://kubernetes.io/docs/reference/using-api/#api-versioning\n\n## Quick Start and documentation\n\nIf you are eager to start with the operator, you can visit the quick start [section][docsqs]\nof the documentation. Alternatively, the complete [docs][docs] provide a full and\ndetailed description of how to thoroughly use this project.\n\n## Container images\n\n### Release images\n\nRelease builds can be found on Docker Hub in [kong/gateway-operator-oss repository][dockerhub-kgo-oss].\n\nAt the moment we're providing images for:\n\n- Linux `amd64`\n- Linux `arm64`\n\n[dockerhub-kgo-oss]: https://hub.docker.com/r/kong/gateway-operator-oss\n\n### `main` branch builds\n\nNightly pre-release builds of the `main` branch are available from the\n[kong/nightly-gateway-operator-oss repository][dockerhub-kgo-nightly] hosted on Docker Hub.\n\n[dockerhub-kgo-nightly]: https://hub.docker.com/r/kong/nightly-gateway-operator-oss\n\n## Development\n\n### Prerequisites\n\nIn order to build the operator you'll have to have Go installed on your machine.\nIn order to do so, follow the instructions on its website[go-dev-site].\n\n### Build process\n\nBuilding the operator should be as simple as running:\n\n```console\nmake build\n```\n\nThis `Makefile` target will take care of everything from generating client side code,\ngenerating Kubernetes manifests, downloading the dependencies and the tools used\nin the build process and finally, it will build the binary.\n\nAfter this step has finished successfully you should see the operator's binary `bin/manager`.\n\nYou can also run it directly via `make run` which will run the operator on your\nmachine against the cluster that you have configured via your `KUBECONFIG`.\n\n### Adding new CRDs\n\nWhenever you add a new CRD:\n- Ensure that it is included in project's [`PROJECT`](./PROJECT) file. This is necessary for creation of\n  a bundle for external hubs like [Operator Hub's community operators][community-operators].\n- Annotate the CRD and any new type it depends on with the right markers to make sure it will be included\n  in the generated documentation. See [available markers][available-markers].\n\n[community-operators]: https://github.com/k8s-operatorhub/community-operators/\n[available-markers]: https://github.com/Kong/kubernetes-configuration/blob/main/README.md#available-custom-markers\n\n## Seeking Help\n\nPlease search through the posts on the [discussions page][disc] as it's likely\nthat another user has run into the same problem. If you don't find an answer,\nplease feel free to post a question.\n\nIf you've found a bug, please [open an issue][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 [#kong][slack] channel on\nthe Kubernetes Slack server.\n\n## Community Meetings\n\nYou can join bi-weekly meetups hosted by [Kong][kong] to ask questions, provide\nfeedback, or just to listen and hang out.\n\nSee the [Online Meetups Page][kong-meet] to sign up and receive meeting invites\nand [Zoom][zoom] links.\n\n[kong]:https://konghq.com\n[konggw]:https://github.com/kong/kong\n[kic]:https://github.com/kong/kubernetes-ingress-controller\n[gwapi]:https://github.com/kubernetes-sigs/gateway-api\n[go-dev-site]: https://go.dev/\n[disc]:https://github.com/kong/gateway-operator/discussions\n[issues]:https://github.com/Kong/gateway-operator/issues\n[slack]:https://kubernetes.slack.com/messages/kong\n[kong-meet]:https://konghq.com/online-meetups/\n[zoom]:https://zoom.us\n[docs]:https://docs.konghq.com/gateway-operator/latest/\n[docsqs]:https://docs.konghq.com/gateway-operator/latest/get-started/kic/install/\n[operator-concept]:https://kubernetes.io/docs/concepts/extend-kubernetes/operator/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkong%2Fgateway-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkong%2Fgateway-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkong%2Fgateway-operator/lists"}