Skip to content

Ingresses

Use an ingress when you want HTTP traffic from outside the cluster to reach a service in your namespace.

RemoteGPU supports Kubernetes Ingress for professional Kubernetes users. The console can help you create a simple ingress, and kubectl can manage the same resource directly.

Open in the console

TaskConsole page
Create or inspect ingressesKubernetes / Ingresses

Before you create an ingress

RequirementWhy it matters
A running workloadIngress only routes traffic; it does not run the application
A ClusterIP serviceIngress backends must point to an existing service
A supported host under apps.remotegpu.aiHosts outside the managed ingress domain are rejected
The platform ingress classThe current supported class is nginx

Choose a workflow

WorkflowBest forWhat happens
ConsoleGuided ingress creation for an existing serviceYou choose the service, port, host, and path in the UI
kubectlFull native control over the Kubernetes ingress manifestYou create a networking.k8s.io/v1 Ingress directly

Supported ingress profile

AreaSupported behavior
API versionnetworking.k8s.io/v1 Ingress
Backend typeService-backed HTTP rules
Namespace boundaryThe ingress must point to services in the same namespace
HostnamesHosts under the RemoteGPU-managed ingress domain
Ingress classThe platform ingress class, currently nginx
Path routingStandard HTTP path routing with pathType

In practice, the supported flow is:

text
Deployment
  -> Service
  -> Ingress
  -> public HTTP route

Unsupported ingress patterns

PatternCurrent status
NodePort or externalIPs service exposureNot supported
Hosts outside the managed ingress domainNot supported
defaultBackendNot supported
Non-service ingress backendsNot supported
Unsupported ingress-controller annotationsNot supported
Custom-domain onboarding through the Kubernetes console flowNot supported

Create an ingress

From the console:

  1. Open Kubernetes / Ingresses
  2. Select a namespace
  3. Click Create ingress
  4. Choose the target service
  5. Choose the backend port
  6. Enter the ingress details
Console fieldWhat it means
Ingress nameKubernetes ingress name in the namespace
HostPublic host under apps.remotegpu.ai
PathHTTP path for the backend rule
ServiceExisting service that should receive traffic
PortService port the ingress backend should target

The console creates a Kubernetes ingress that points to the existing service.

How ingress shows up in the console

The console reads live ingress resources from your namespace.

ActionResult
Create ingress with kubectlIt appears in the console
Create ingress in the consoleIt appears in kubectl
Remove the target service or service portThe console shows an error state for the ingress
  • Read Services if you still need the internal backend.
  • Read Deployments if the workload is not running yet.

RemoteGPU customer documentation