Installation [Alpha]#
Minimum Requirements#
Kubernetes cluster must have the following minimum requirements available:
CPU Unit | RAM | Disk Space | Processor Type |
---|---|---|---|
1 | 2 GB | 10 GB | 64 Bit |
DB-less mode(Recommended)#
To install Gluu Gateway on kuberentes, follow these steps:
-
[Pre-requirement] Install Gluu on kubernetes if not already installed and make sure OXD server is installed by answering
Y
toInstall Casa
. AnswerN
to promptInstall Gluu Gateway Database mode
as this option is for Database mode. -
Install Kong with GG plugins. The only component that must be changed inside kongs manifests is the
image:tag
of kong togluufederation/gluu-gateway:4.2.0_dev
. Please refer to kongs kubernetes installation for more tweaks and detail.-
With yaml manifests
wget https://bit.ly/kong-ingress-dbless && cat kong-ingress-dbless | sed -s "s@image: kong:2.0@image: gluufederation/gluu-gateway:4.1.0_dev@g" | kubectl apply -f -
-
With Helm. Please refer to kongs official chart for more options.
helm repo add kong https://charts.konghq.com helm repo update # Helm 3 helm install gg-kong kong/kong --set ingressController.installCRDs=false --set image.repository=gluufederation/gluu-gateway --set image.tag=4.2.0_dev --set --namespace=gluu-gateway
-
Note
Please make sure to create a secret called kong-config
in the same namespace Kong was deployed in containing the kong.yml
declaration file and restart gg-kong deployment.
Head to DB-less for more information. Please note that loading kong.yml
occurs automatically as the kong.yml
gets pulled from secrets and loaded if changes occur to it.
Uninstall#
helm delete gg-kong -n gluu-gateway
DB mode#
Automatic full installation#
-
Install Gluu with Gluu gateway on kubernetes.
./pygluu-kubernetes.pyz install # To install Gluu-Gateway only: Gluu must be already installed in the same kubernetes cluster ./pygluu-kubernetes.pyz install-gg-dbmode
Helm#
-
Install Gluu and Postgres run. Answer
Y
to promptInstall Gluu Gateway
. This will install Gluu, Postgres, and setup the databases and required secrets for Gluu-Gateway and Gluu-Gateway-UI../pygluu-kubernetes.pyz helm-install
-
Wait until Gluu is up and running. Make sure oxd server and oxauth pods are running
kubectl -n gluu wait --for=condition=available --timeout=900s deploy/gluu-oxauth kubectl -n gluu wait --for=condition=available --timeout=300s deploy/gluu-oxd-server
-
Install Gluu Gateway and Gluu Gateway UI
./pygluu-kubernetes.pyz helm-install-gg-dbmode
Uninstall#
./pygluu-kubernetes.pyz uninstall-gg-dbmode
# With helm
./pygluu-kubernetes.pyz helm-uninstall-gg-dbmode