Layer 7 (Application) Ingress

Layer 7 ingress provides application-level HTTPS load balancing and routing for web services. SystemLink Enterprise uses Layer 7 ingress to expose HTTP-based services through two separate ingress endpoints: one endpoint for the web UI and one endpoint for API access.

Ingress Endpoints

SystemLink Enterprise requires configuration of two ingress endpoints:

  • UI Ingress (global.hosts): Provides access to the SystemLink web UI.
  • API Ingress (global.apiHosts): Provides programmatic access to SystemLink REST APIs.

You must configure both endpoints with unique hostnames. For example, systemlink.example.com for the UI and systemlink-api.example.com for the API. Configure these hostnames in the systemlink-values.yaml file under global.hosts and global.apiHosts.

For hostname requirements and security recommendations, refer to DNS and Network Security Considerations.

Ingress Annotations

You can customize ingress behavior through annotations, which are specific to the ingress controller being used. SystemLink Enterprise applies annotations at both global and service-specific levels:

  • Global Annotations: Applied to all ingress resources via global.ingress.ui.annotations and global.ingress.api.annotations.
  • Service-Specific Annotations: Applied to individual services to handle custom requirements.

Platform-Specific Configuration

The configuration for Layer 7 ingress varies depending on your Kubernetes platform and ingress controller. Refer to the platform-specific guides in this section for detailed configuration instructions.