Load Balancer with Hostname

Release will automatically handle services that are HTTP-based and generate hostnames for the backend services. But not all services are HTTP: many services listen for other types of traffic, like TCP or UDP traffic.
In order to expose a non-HTTP service to the internet, you will need to define a node_port. A node_port requires both a target_port and a port number.
target_port: This is the port on the pod that the request gets sent to internally. Your application needs to be listening for network requests on this port for the service to work.
port: The specified port within the cluster that exposes the service externally. The service is visible on this port, and other pods and services will send requests to this port to reach the service.
Release doesn't define a fixed NodePort in Kubernetes, which allows Kubernetes to allocate a random port from the host node. However, for external communications, the fixed port is applied to the load balancer. This allows services that run on the same port number to coexist with other applications on the same physical nodes without conflict.
Once you have defined a node_port for your service, you can define a hostname. Release uses variable interpolation for env_id and domain.
Here is an example of exposing a Minecraft service to the internet:
1
services:
2
- name: minecraft
3
  image: dustyspace/docker-minecraft-server/minecraft
4
  has_repo: true
5
  ports:
6
  - type: node_port
7
    target_port: '25565'
8
    port: '25565'
9
    loadbalancer: true
10
  hostname: minecraft-${env_id}-${domain}
Copied!
The Minecraft service listens on port 25565, creates a load balancer, and generates a hostname.
The code below is an example of exposing a postgres database service to the internet:
1
services:
2
- name: db
3
  image: postgres:9.4
4
  ports:
5
  - type: node_port
6
    target_port: '5432'
7
    port: '5432'
8
    loadbalancer: true
9
  hostname: postgres-db-${env_id}-${domain}
Copied!

Guides and examples - Previous

Example applications

Define a Static Javascript Service

Last modified 2mo ago

Copy link