TCP Load Balancer
This guide provides instructions on how to create a TCP load balancer in VoltConsole using guided configuration that walks you through the steps of configuring meta data to advanced configuration. This includes configuring the required objects for the virtual host. To know more about virtual host concepts, see Virtual Host.
Using the instructions provided in this guide, you can create a TCP loadbalancer and optionally create origin pools for the same.
The following prerequisites apply:
- Note: If you do not have an account, see Create a Volterra Account.
A valid DNS domain delegated to Volterra.
- Note: For instructions on how to delegate your domain to Volterra, see Delegate Domain.
A Volterra CE site in case of deploying your applications on CE site.
The following video shows a tutorial for HTTP load balancer creation:
The configuration option to create the TCP load balancer guides you through the steps for required configuration. This document covers each guided step and explains the required actions to be performed for each step.
Step 1: Log into the VoltConsole and navigate to the TCP load balancer configuration.
Change to your application namespace. You can navigate to the TCP load balancers from either of the following ways:
Virtual Hostsin the configuration menu and
TCP Load Balancersin the options.
Managein the configuration menu and
TCP Load Balancersin the options.
Step 2: Start the load balancer creation and enter metadata.
Add TCP load balancer to open the load balancer creation form and perform following steps:
- Enter a name in the
- Optionally, set labels and enter a description for your load balancer.
Step 3: Configure domain and listening port.
Go to the
Basic Configuration and perform the following:
- Enter a domain in the
Add itemto add more than one domain.
- Enter a port number in the
Listen Portfield. This is the TCP listening port.
- Optionally, select the
With SNIcheckbox to set the load balancer as TCP loadbalancer with SNI.
Step 4: Configure origin pools.
Origin Poolsfield to open origin pool configuration form.
Perform on of the following for the
Select Origin Pool Methodoption:
Origin Pooland select an existing origin pool from the
Origin Pooldrop-down or click
Create new poolto create and apply a new origin pool.
Custom Clusterand select an existing cluster from the
Custom Clusterdrop-down or click
Create new clusterto create and apply a new cluster.
Optionally, enter a value for the
This sample shows configuring a new origin pool with public DNS names of origin servers as the type of origin servers:
Applyto add the origin pool.
Note: You can click
Add itemand add more routes as per your requirement.
Step 5: Configure VIP advertisement.
Where to Advertise the VIP field displays
Advertise Custom and
Advertise On Public options with the latter being selected by default.
Note: In case of tenants with shared VIPs, advertising on public network is supported only with the proxy type
TCP_PROXY_WITH_SNIand on port 443.
Proceed with the default option or click
Show Advanced Fields option to enable more options and set one of the options as per the following guidelines:
Advertise on Public With Specified VIPand enter an IP address in the
Public IPfield to advertise that IP as VIP on the public network.
Advertise Custom, click
Advertise Customfield enabled, and perform the configuration as per the following guidelines:
vK8s Service Network on REoptions for the
Select Where to Advertisefield and select appropriate reference objects in the
Referencefields. In case of site, you can also optionally set an IP address as the VIP.
- Select inside network or outside network or both for the
Site Networkfield in case you selected
Virtual Siteas the advertisement location.
- Configure a TCP listener port or select default option for the
TCP Listen Port Choicefield. The default option sets port 80 for HTTP, 443 for HTTPS, and the listen port you set in basic configuration for TCP.
Applyto add the custom VIP advertisement configuration.
Advertise on Publicto advertise the default VIP on the public network.
This example sets advertising on public.
Do Not Advertiseto disable VIP advertisement.
Step 6:Complete creating the load balancer.
Continue to complete creating the load balancer.
Verify that the requests to the configured domain are processed successfully. The following sample shows example command to send a DNS query over TCP:
dig +tcp @dns.mydistributed.cloud www.mydistributed.cloud