goma-gateway/docs/install/kuberntes-advanced.md

title, layout, parent, nav_order

title	layout	parent	nav_order
Kubernetes Advanced deployment	default	Installation	5

Kubernetes Advanced deployment using CRDs and an Operator

Install the CRDs and Operator into the cluster:

kubectl apply -f https://raw.githubusercontent.com/jkaninda/goma-operator/main/dist/install.yaml

Resources

• Gateway
• Route
• Middleware

Gateway

The Gateway serves as the entry point to the server, handling and routing incoming traffic.

Installation Details

When a Gateway is installed, it automatically creates the following Kubernetes resources, all with the same name as the Gateway:

• Service
• ConfigMap
• Deployment

Service Ports

The service exposes the following ports:

• HTTP: 8080
• HTTPS: 8443

Exposing the Gateway Outside the Cluster

To expose your Gateway outside the cluster, you have the following options:

1. Create an Ingress resource:
   Configure an Ingress to route external traffic to your Gateway.

2. Change the Service Type:
   Patch the Gateway's service to change its type (e.g., to LoadBalancer or NodePort) for external accessibility.

A simple example of gateway

apiVersion: gomaproj.github.io/v1beta1
kind: Gateway
metadata:
  labels: {}
  name: gateway-sample
spec:
  # The version of Goma Gateway
  # See: https://github.com/jkaninda/goma-gateway/releases
  gatewayVersion: latest
  ## Server config
  server:
    # Kubernetes tls secret name
    tlsSecretName: '' #Optional, tls-secret
    #Redis configs for distributed rate limiting across multiple instances
    redis:
        addr: '' #Optional, redis:6379
        password: '' #Optional, password
    writeTimeout: 10
    readTimeout: 15
    idleTimeout: 30
    logLevel: info
    disableHealthCheckStatus: false
    disableKeepAlive: false
    enableMetrics: true
  replicaCount: 1
  resources:
    limits:
      cpu: 200m
      memory: 512Mi
    requests:
      cpu: 100m
      memory: 128Mi
  # Enable auto scaling
  autoScaling:
    enabled: true
    minReplicas: 2
    maxReplicas: 5
    targetCPUUtilizationPercentage: 80
    targetMemoryUtilizationPercentage: 80
  affinity: {}

Delete gateway

kubectl delete gateway (gatewayName)

Or

kubectl delete gateways.gomaproj.github.io (gatewayName)

Middleware

A simple example of middleware

apiVersion: gomaproj.github.io/v1beta1
kind: Middleware
metadata:
  name: basic-middleware-sample
spec:
    type: basic
    paths:
      - /admin/*
    rule:
        username: admin
        password: admin

Route

A simple example of route

apiVersion: gomaproj.github.io/v1beta1
kind: Route
metadata:
  labels: {}
  name: route-sample
spec:
  gateway: gateway-sample
  path: /
  hosts: []
  rewrite: /
  methods:
    - GET
    - POST
    - PUT
  destination: https://example.com
  backends: []
  insecureSkipVerify: false
  healthCheck:
    path: /
    interval: 10s
    timeout: 10s
    healthyStatuses:
      - 200
      - 404
  cors:
    origins: []
    headers: {}
  rateLimit: 15
  disableHostFording: true
  interceptErrors: []
  blockCommonExploits: false
  ## Middleware names
  middlewares:
    - basic-middleware-sample

Uninstall

kubectl delete -f https://raw.githubusercontent.com/jkaninda/goma-operator/main/dist/install.yaml

Force Gateway deletion

kubectl patch  gateways.gomaproj.github.io (gatewayName) -p '{"metadata":{"finalizers":[]}}' --type=merge

Force gateway crd deletion

kubectl patch crd gateways.gomaproj.github.io -p '{"metadata":{"finalizers":[]}}' --type=merge