Skip to main content

Ingress Commands

Overview

These commands are related to exposing vkdr applications through exposed TCP ports (mostly HTTP/HTTPS).

When starting the vkdr cluster you have an option to enable Traefik as its default ingress controller, but there are other ingress controllers available in vkdr too. You can use our own commands to install Traefik, NGinx or Kong - they may even coexist on different ports.

Available Ingress Controllers

  • nginx - NGinx ingress controller (simple, widely used)
  • kong - Kong Gateway (API gateway with advanced features)
  • traefik - Traefik ingress controller (modern, easy setup)
  • whoami - Test service for verifying ingress

Quick Start Examples

Traefik (Quickest)

vkdr infra start --traefik  # 8000/8001 ports
curl localhost:8000 # 404 after Traefik starts
vkdr infra stop

NGinx

vkdr infra up                      # 8000/8001 ports, no ingress
vkdr nginx install --default-ic # NGinx as default ingress
curl localhost:8000 # 404 after NGinx starts
vkdr infra stop

Kong (For DevPortal or API Gateway)

vkdr infra up
vkdr kong install --default-ic # Kong as default ingress
curl localhost:8000 # 404 after Kong starts
vkdr devportal install # DevPortal requires Kong
vkdr infra stop

Choosing an Ingress Controller

ControllerBest ForKey Features
TraefikDevelopment, simple setupsBuilt-in dashboard, auto HTTPS
NGinxGeneral purposeWidely used, well documented
KongAPI management, DevPortalRate limiting, auth, plugins

Notes

A "default ingress controller" is a Kubernetes concept: any Ingress object that does not define an ingress class will be served by the default ingress controller.

Most vkdr commands that install applications will rely on the default ingress controller.