Managing load balancers

Load balancers are created and managed by self-service users, as described in "Managing load balancers" in the Self-Service Guide. In the admin panel, you can monitor, manage balancing pools, disable/enable, and delete a load balancer. Additionally, in case of a load balancer failure, it is possible to perform a manual failover in the command-line interface.

Limitations

IPv6 is supported for load balancers that are connected to physical networks.

Prerequisites

The compute cluster is created, as described in Creating the compute cluster.
The load balancer service is installed during the compute cluster deployment or later, as described in Provisioning load balancers.

To view load balancer properties

Admin panel

On the Compute > Network > Load balancers tab, select the required load balancer.
Open the Properties tab. In the Virtual machines field, you can see the name of load balancer instances.
Click the instance name to open the VM’s panel.

Command-line interface

Use the following command:

vinfra service compute load-balancer show <load-balancer>

<load-balancer>: Load balancer ID or name

For example, to view the details of the load balancer mylbaas, run:

# vinfra service compute load-balancer show mylbaas
+---------------+----------------------------------------------------+
| Field         | Value                                              |
+---------------+----------------------------------------------------+
| address       | 192.168.30.230                                     |
| amphorae      | - active: true                                     |
|               |   compute_id: b0c4793f-e1b1-4251-91c2-94e34787f537 |
|               |   created_at: '2019-11-18T12:59:12.742446'         |
|               |   id: b7b23106-a87b-412d-9ce6-7c69b5594342         |
|               |   image_id: 6d1ba6f9-cf86-4ea4-a32d-f138868a9742   |
|               |   role: STANDALONE                                 |
|               |   status: ALLOCATED                                |
|               |   updated_at: '2019-11-18T13:01:07.601184'         |
| created_at    | 2019-11-18T12:59:08.243413                         |
| description   |                                                    |
| enabled       | True                                               |
| floating_ip   | 10.94.129.70                                       |
| ha_enabled    | False                                              |
| id            | 941bf637-2d55-40f0-92c0-e65d6567b468               |
| members_count | 0                                                  |
| name          | mylbaas                                            |
| network_id    | 2b821d00-e428-4a76-b1ae-d181c9f5ae7f               |
| pools         | []                                                 |
| port_id       | 2d8ab88a-847c-4396-857e-11eaa80e1b24               |
| project_id    | e4e059c67dee4736851df14d4519a5a5                   |
| status        | ACTIVE                                             |
| updated_at    | 2019-11-18T13:01:10.983144                         |
+---------------+----------------------------------------------------+

To enable/disable a load balancer

Admin panel

On the Compute > Network > Load balancers tab, select a load balancer.
Click the ellipsis icon next to it, and then click Enable or Disable.

Command-line interface

Use the following command:

vinfra service compute load-balancer set [--enable | --disable] [--description <description>] <load-balancer>

--enable: Enable the load balancer
--disable: Disable the load balancer
--description <description>: Load balancer description

A description should not contain any personally identifiable information or sensitive business data.
<load-balancer>: Load balancer ID or name

For example, to disable the load balancer mylbaas, run:

# vinfra service compute load-balancer set mylbaas --disable \
--description "Disabled load balancer"
+---------------+--------------------------------------+
| Field         | Value                                |
+---------------+--------------------------------------+
| address       | 192.168.30.230                       |
| amphorae      |                                      |
| created_at    | 2019-11-18T12:59:08.243413           |
| description   | Disabled load balancer               |
| enabled       | False                                |
| floating_ip   |                                      |
| ha_enabled    |                                      |
| id            | 941bf637-2d55-40f0-92c0-e65d6567b468 |
| members_count | 0                                    |
| name          | mylbaas                              |
| network_id    | 2b821d00-e428-4a76-b1ae-d181c9f5ae7f |
| pools         | []                                   |
| port_id       | 2d8ab88a-847c-4396-857e-11eaa80e1b24 |
| project_id    | e4e059c67dee4736851df14d4519a5a5     |
| status        | DISABLED                             |
| updated_at    | 2019-11-18T13:09:09.151442           |
+---------------+--------------------------------------+

To perform a load balancer failover

Use the following command:

vinfra service compute load-balancer failover <load-balancer>

<load-balancer>: Load balancer ID or name

For example, to perform a failover of the load balancer mylbaas, run:

# vinfra service compute load-balancer failover mylbaas

To delete a load balancer

Admin panel

On the Compute > Network > Load balancers tab, select a load balancer.
Click the ellipsis icon next to it, and then click Delete.
Click Delete in the confirmation window.

Command-line interface

Use the following command:

vinfra service compute load-balancer delete <load-balancer>

<load-balancer>: Load balancer ID or name

For example, to delete the load balancer mylbaas, run:

# vinfra service compute load-balancer delete mylbaas