Helm Chart

Deploy the ingress2gateway web UI to your Kubernetes cluster using Helm.

Prerequisites

Kubernetes 1.21+
Helm 3.0+

Installation

Add Helm Repository

helm repo add ingress2gateway https://pmady.github.io/ingress2gateway
helm repo update

Install Chart

# Basic installation
helm install ingress2gateway ingress2gateway/ingress2gateway

# With custom namespace
helm install ingress2gateway ingress2gateway/ingress2gateway -n tools --create-namespace

# With custom values
helm install ingress2gateway ingress2gateway/ingress2gateway -f values.yaml

Install from Source

git clone https://github.com/pmady/ingress2gateway.git
cd ingress2gateway
helm install ingress2gateway ./charts/ingress2gateway

Configuration

Basic Values

Parameter	Description	Default
`replicaCount`	Number of replicas	`1`
`image.repository`	Image repository	`ghcr.io/pmady/ingress2gateway`
`image.tag`	Image tag	`""` (uses appVersion)
`image.pullPolicy`	Image pull policy	`IfNotPresent`
`service.type`	Service type	`ClusterIP`
`service.port`	Service port	`8000`

Ingress Configuration

Parameter	Description	Default
`ingress.enabled`	Enable Ingress	`false`
`ingress.className`	Ingress class	`""`
`ingress.annotations`	Ingress annotations	`{}`
`ingress.hosts`	Ingress hosts	`[]`
`ingress.tls`	Ingress TLS configuration	`[]`

Gateway API Configuration

Parameter	Description	Default
`gateway.enabled`	Enable Gateway API	`false`
`gateway.className`	Gateway class	`istio`
`gateway.listeners`	Gateway listeners	`[{name: http, port: 80, protocol: HTTP}]`
`gateway.httproute.hostnames`	HTTPRoute hostnames	`[]`

Resources

Parameter	Description	Default
`resources.limits.cpu`	CPU limit	`200m`
`resources.limits.memory`	Memory limit	`256Mi`
`resources.requests.cpu`	CPU request	`100m`
`resources.requests.memory`	Memory request	`128Mi`

Application Configuration

Parameter	Description	Default
`config.defaultProvider`	Default provider preset	`istio`
`config.debug`	Enable debug mode	`false`
`config.logLevel`	Log level	`info`

Examples

With Ingress

# values-ingress.yaml
ingress:
  enabled: true
  className: nginx
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
  hosts:
    - host: ingress2gateway.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: ingress2gateway-tls
      hosts:
        - ingress2gateway.example.com

helm install ingress2gateway ingress2gateway/ingress2gateway -f values-ingress.yaml

With Gateway API

# values-gateway.yaml
gateway:
  enabled: true
  className: istio
  listeners:
    - name: https
      port: 443
      protocol: HTTPS
  httproute:
    hostnames:
      - ingress2gateway.example.com

helm install ingress2gateway ingress2gateway/ingress2gateway -f values-gateway.yaml

With Autoscaling

# values-autoscaling.yaml
autoscaling:
  enabled: true
  minReplicas: 2
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80

resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 200m
    memory: 256Mi

Production Configuration

# values-production.yaml
replicaCount: 3

image:
  pullPolicy: Always

podSecurityContext:
  runAsNonRoot: true
  runAsUser: 1000
  fsGroup: 1000

securityContext:
  allowPrivilegeEscalation: false
  capabilities:
    drop:
      - ALL
  readOnlyRootFilesystem: true

resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 200m
    memory: 256Mi

autoscaling:
  enabled: true
  minReplicas: 3
  maxReplicas: 10
  targetCPUUtilizationPercentage: 70

ingress:
  enabled: true
  className: nginx
  annotations:
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
    cert-manager.io/cluster-issuer: letsencrypt-prod
  hosts:
    - host: ingress2gateway.company.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: ingress2gateway-tls
      hosts:
        - ingress2gateway.company.com

config:
  defaultProvider: istio
  logLevel: info

Upgrading

# Update repository
helm repo update

# Upgrade release
helm upgrade ingress2gateway ingress2gateway/ingress2gateway

# Upgrade with new values
helm upgrade ingress2gateway ingress2gateway/ingress2gateway -f values.yaml

Uninstalling

helm uninstall ingress2gateway

Building the Docker Image

If you need to build the Docker image locally:

cd ingress2gateway
docker build -t ingress2gateway:local .

# Use local image in Helm
helm install ingress2gateway ./charts/ingress2gateway \
  --set image.repository=ingress2gateway \
  --set image.tag=local \
  --set image.pullPolicy=Never

Troubleshooting

Pod Not Starting

Check pod logs:

kubectl logs -l app.kubernetes.io/name=ingress2gateway

Service Not Accessible

Verify service and endpoints:

kubectl get svc ingress2gateway
kubectl get endpoints ingress2gateway

Health Check Failing

The application exposes /health endpoint. Verify it’s responding:

kubectl port-forward svc/ingress2gateway 8000:8000
curl http://localhost:8000/health