giantswarm/kong-app

This is stars and forks stats for /giantswarm/kong-app repository. As of 09 May, 2024 this repository has 0 stars and 3 forks.

kong-app chart Kong for Kubernetes is an open-source Ingress Controller for Kubernetes that offers API management capabilities with a plugin architecture. Giant Swarm offers a Kong Managed App which can be installed in workload clusters. Available Versions Giant Swarm Chart Release Upstream Chart Release Kong Version Kong IC Version Kong-Gateway Enterprise container tag Unreleased 2.29.0 3.4.1 2.12.0 3.4.1.0-debian v3.4.0 2.23.0 3.3.1 2.10.4 3.3.1.0-debian v3.3.0 2.21.0 3.2.2 2.9.3 3.2.2.1-debian v3.2.0 2.20.1 3.2.2 2.9.3 3.2.2.1-debian v3.1.1 2.19.1 3.2.2 2.9.3 3.2.2.1-debian v3.1.0 2.19.0 3.2.2 2.9.3 3.2.2.1-debian v3.0.1 2.16.4 3.1.1 2.8.1 3.1.1.3-debian v3.0.0 2.16.2 3.1.1 2.8.1 3.1.1.3-debian v2.14.0 2.13.0 2.8.1 2.8.1 2.8.2.3-debian v2.13.0 2.13.0 2.8.1 2.7.0 2.8.2.0-alpine v2.12.0 2.13.0 2.8.1 2.6.0 2.8.1.4-alpine v2.11.0 2.11.0 2.8.1 2.5.0 2.8.1.2-alpine v2.10.1 2.8.2 2.8.1 2.3.1 2.8.1.0-alpine v2.10.0 2.8.2 2.8.1 2.3.1 2.8.1.0-alpine v2.9.0 2e89647 2.8.1 2.3.1 2.8.1.0-alpine v2.8.0 2.7.0 2.7.1 2.2.1 2.7.1.1-alpine v2.7.2 2.7.0 2.7.1 2.2.1 2.7.1.1-alpine v2.7.1 2.7.0 2.7.1 2.2.1 2.7.1.1-alpine v2.7.0 2.7.0 2.7.1 2.2.1 2.7.1.1-alpine v2.6.0 26eff4f 2.7.1 2.1.1 2.7.1.1-alpine v2.5.0 2.6.4 2.7.1 2.1.1 2.7.1.1-alpine v2.4.0 2.6.4 2.7.0 2.1.0 2.7.1.1-alpine v2.3.5 2.3.0 2.5.1 1.3.4 2.5.1.2-alpine v2.3.4 2.3.0 2.5.1 1.3.4 2.5.1.2-alpine v2.3.3 2.3.0 2.5.1 1.3.4 2.5.1.2-alpine v2.3.2 2.3.0 2.5.1 1.3.4 2.5.1.2-alpine v2.3.1 2.3.0 2.5.1 1.3.4 2.5.1.2-alpine v2.3.0 2.3.0 2.5.1 1.3.4 2.5.1.2-alpine v2.1.0 2.1.0 2.4.1 1.2.0 2.3.3.2-alpine For older versions, please refer to the changelog Configuration A basic installation of Kong for Kubernetes will work out of the box without any custom values. In case you want to supply a set of custom configuration options, only include configuation you want to change. DO NOT copy the whole values.yaml file. For detailed explanations of configuration options, please refer to the list of configuration options and also the values.yaml file Any key value put under the env section translates to environment variables used to control Kong's configuration. Every key is prefixed with KONG_ and upper-cased before setting the environment variable. This app does not by default provide a database and if a database is required, then you will need to BYOD (Bring Your Own Database). For testing purposes, it is possible launch postgres alongside this App (described below). The default installation of the App will use Kong Ingress Controller. The recommended way to configure plugins, consumers and services when using Kong for Kubernetes is by utilizing Kong annotations and Kong custom resources. Container image registry You can change the container image registry by setting the following values in your values.yaml file image: registry: &registry docker.io ingressController: image: registry: *registry # In case you've enabled the postgresql sub-chart # postgresql: # image: # registry: *registry # In case you've changed the default waitImage # waitImage: # registry: *registry Kong Enterprise In case you want to use Kong enterprise, a valid enterprise license Secret is required in the namespace next to your kong deployment. Install the app with at least the following custom configuration: image: repository: giantswarm/kong-gateway tag: "3.2.2.1-debian" # use the tag from the release matrix on from the README.md file enterprise: enabled: true license_secret: "kong-enterprise-license" Then create the Secret with name kong-enterprise-license in namespace kong-app from a license file named kong-enterprise-license.json: kubectl create secret generic kong-enterprise-license \ --namespace kong-app \ --from-file=license=./kong-enterprise-license.json Using your own Database Kong supports PostgreSQL version 9.5 up to 15. Example database configuration: env: database: "postgres" # can be "off" or "postgres" pg_host: 127.0.0.1 pg_port: 12345 pg_user: postgres pg_password: # This can also be a string value, but not recommended valueFrom: secretKeyRef: name: postgres key: kong note: If pg_port is not set then it will default to 5432 Installing a database alongside the App For testing purposes, it is possible to install a PostgreSQL server alongside the App. To do this, you'll need to specify the following app configuration: postgresql: enabled: true (There is no need to add PostgreSQL configuration data to env, a default user and password will be used.) Please note: This configuration should only be used for testing and is not officially supported by Giant Swarm. Using Kong Ingress Controller with a Database When using Kong Ingress Controller, a database is not required. However in some cases (for example, plugin support, Kong developer portal) a database is required. The Kong Ingress Controller does not communicate with the database directly. Instead, it uses the Admin API of the proxy container which then persists configuration either in memory or in the configured database. Like in the case of using a database, Giant Swarm does not support the database and can only provide best efforts support with this configuration. To configure, please see 'Using your own Database'. But ensure that that ingressController.enabled is set to true. Note: Is it possible to create consumers using the Admin API? From version 0.5.0 onwards, Kong Ingress Controller tags each entity that it manages inside Kong's database and only manages the entities that it creates. This means that if consumers and credentials are created dynamically, they won't be deleted by the Ingress Controller. (Taken from https://docs.konghq.com/kubernetes-ingress-controller/latest/faq/#is-it-possible-to-create-consumers-using-the-admin-api) Kong Ingress Controller CRDs When installed through the Giant Swarm App platform, CRD installation is taken care of automatically. Credit https://github.com/Kong/charts/ Automatic and manual testing The helm chart in this repository undergoes a series of automated tests running on a kind cluster (kind cluster config) executed by app-test-suite. (chart values used for tests) Testing includes creation of Deployment, Service, and Ingress resources to check if reconciliation works as intended. To execute tests on your machine, obtain a copy of the dats.sh helper script and a chart archive (helm pull https://giantswarm.github.io/giantswarm-catalog/kong-app-2.5.0.tgz or build an archive with your changes using app-build-suite), then execute ./dats.sh -c kong-app-2.5.0.tgz Please check out file .ats/main.yaml for some additional hints configuring app-test-suite. Manual testing The repository includes resources to test this chart and chart upgrades in directory tests/manual. Security Policy Reporting a Vulnerability Please visit https://www.giantswarm.io/responsible-disclosure for information on reporting security issues.