3.13. Managing load balancers

3.13.1. vinfra service compute load-balancer create

Create a load balancer:

usage: vinfra service compute load-balancer create [--description <description>]
                                                   [--enable | --disable]
                                                   [--address <address>]
                                                   [--floating-ip <floating-ip>]
                                                   [--pools-config <pools>]
                                                   <name> <network>
--description <description>
Load balancer description
--enable
Enable the load balancer.
--disable
Disable the load balancer.
--address <address>
The IP address the load balancer will try to allocate in the network.
--floating-ip <floating-ip>
The floating IP address that will be used to connect to the load balancer from public networks.
--pools-config <pools>
Pool configuration file

Below is an example of a pool configuration file in the YAML format:

- backend_protocol: HTTPS
  backend_protocol_port: 443
  healthmonitor: {delay: 5, max_retries: 3, max_retries_down: 3, timeout: 5, type: PING,
    url_path: /}
  lb_algorithm: ROUND_ROBIN
  members:
  - address: 192.168.30.49
  - address: 192.168.30.15
  name: pool1
  protocol: HTTPS
  protocol_port: 443
  sticky_session: False
<name>
Load balancer name
<network>
The ID or name of network the load balancer will operate in.

Example:

# vinfra service compute load-balancer create mylbaas private1 --floating-ip 10.94.129.70
+---------------+--------------------------------------+
| Field         | Value                                |
+---------------+--------------------------------------+
| address       | 192.168.30.230                       |
| amphorae      |                                      |
| created_at    | 2019-11-18T12:59:08.243413           |
| description   |                                      |
| enabled       | True                                 |
| floating_ip   | 10.94.129.70                         |
| 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        | CREATING                             |
| updated_at    |                                      |
+---------------+--------------------------------------+

This command creates a load balancer mylbaas without balancing pools that will operate in the network private with the floating IP address 10.94.129.70.

3.13.2. vinfra service compute load-balancer list

List load balancers:

usage: vinfra service compute load-balancer list [--long]
--long
Enable access and listing of all fields of objects.

Example:

# vinfra service compute load-balancer list -c id -c name -c status -c floating_ip
+--------------------------------------+----------+--------+--------------+
| id                                   | name     | status | floating_ip  |
+--------------------------------------+----------+--------+--------------+
| 941bf637-2d55-40f0-92c0-e65d6567b468 | mylbaas  | ACTIVE | 10.94.129.70 |
+--------------------------------------+----------+--------+--------------+

This command lists load balancers in the compute cluster.

3.13.3. vinfra service compute load-balancer show

Display load balancer details:

usage: vinfra service compute load-balancer show <load-balancer>
<load-balancer>
Load balancer ID or name

Example:

# 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                         |
+---------------+----------------------------------------------------+

This command shows the details of the load balancer mylbaas.

3.13.4. vinfra service compute load-balancer stats

Show statistics for a load balancer:

usage: vinfra service compute load-balancer stats <load-balancer>
<load-balancer>
Load balancer ID or name

Example:

# vinfra service compute load-balancer stats mylbaas
+-------+-------------------------------------------------------+
| Field | Value                                                 |
+-------+-------------------------------------------------------+
| stats | active_connections: 0                                 |
|       | bytes_in: 0                                           |
|       | bytes_out: 0                                          |
|       | listeners: null                                       |
|       | loadbalancer_id: 17cfa86f-c374-4ca3-8cd6-f638a5234fe7 |
|       | request_errors: 0                                     |
|       | total_connections: 0                                  |
+-------+-------------------------------------------------------+

This command shows statistics for the load balancer mylbaas.

3.13.5. vinfra service compute load-balancer set

Modify a load balancer:

usage: vinfra service compute load-balancer set [--description <description>]
                                                [--enable | --disable] [--name <name>]
                                                <load-balancer>
--description <description>
Load balancer description
--enable
Enable the load balancer.
--disable
Disable the load balancer.
--name <name>
Load balancer name
<load-balancer>
Load balancer ID or name

Example:

# 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           |
+---------------+--------------------------------------+

This command disables the load balancer mylbaas and adds a description to it.

3.13.6. vinfra service compute load-balancer pool create

Create a load balancer pool:

usage: vinfra service compute load-balancer pool create --protocol {HTTP,HTTPS}
                                                        --port <port>
                                                        --algorithm <algorithm>
                                                        --backend-protocol {HTTP,HTTPS}
                                                        --backend-port <backend_port>
                                                        [--name <name>]
                                                        [--certificate-file <cert_file>]
                                                        [--connection-limit <limit>]
                                                        [--description <description>]
                                                        [--healthmonitor type=<type>,
                                                        url_path=<url>[,key=value,...]]
                                                        [--member address=<ip>
                                                        [,enabled=<bool>,weight=<int>]]
                                                        [--privatekey-file <key>]
                                                        [--enable-sticky-session |
                                                        --disable-sticky-session]
                                                        [--enable | --disable]
                                                        <load-balancer>
--protocol {HTTP,HTTPS}
The protocol for incoming connections
--port <port>
The port for incoming connections
--algorithm <algorithm>
Load balancing algorithm (LEAST_CONNECTIONS, ROUND_ROBIN, or SOURCE_IP)
--backend-protocol {HTTP,HTTPS}
The protocol for destination connections
--backend-port <backend_port>
The port for destination connections
--name <name>
Pool name
--certificate-file <cert_file>
An x.509 certificate file in the PEM format. Required for TLS-terminated HTTPS->HTTP load balancers.
--connection-limit <limit>
The maximum number of connections permitted for this pool. The default value is -1 (infinite connections).
--description <description>
Pool description
--healthmonitor type=<type>,url_path=<url>[,key=value,...]

Health monitor parameters:

  • type: the health monitor type (HTTP, HTTPS, PING, or TCP)
  • url_path: the URL path to the health monitor
  • comma-separated key=value pairs with keys (optional):
    • delay: the time, in seconds, between sending probes to members.
    • enabled: declares whether the health monitor is enabled or not (true or false).
    • max_retries: the number of successful checks required to change member status to ‘HEALTHY’. Ranges from 1 to 10.
    • max_retries_down: the number of unsuccessful checks required to change member status to ‘UNHEALTHY’. Ranges from 1 to 10.
    • timeout: the maximum time, in seconds, that a monitor waits to connect before it times out. This value must be less than the delay value.
--member address=<ip>[,enabled=<bool>,weight=<int>]

Member parameters:

  • address=<ip>: an IPv4 address of the virtual machine
  • enabled=<bool>: declares whether the member is enabled or not (true or false).
  • weight=<int>: determines the share of connections that the member services compared to the other pool members. For example, a weight of 10 means that the member handles five times as many connections than a member with a weight of 2. A weight of 0 means that the member does not receive new connections but continues to service existing ones. Ranges from 0 to 256. The default value is 1. This option can be used multiple times.
--privatekey-file <key>
A private TLS key file in the PEM format. Required for TLS-terminated HTTPS->HTTP load balancers.
--enable-sticky-session
Enable session persistence.
--disable-sticky-session
Disable session persistence.
--enable
Enable the pool.
--disable
Disable the pool.
<load-balancer>
Load balancer ID or name

Example:

# vinfra service compute load-balancer pool create mylbaas --protocol HTTP --port 80 \
--backend-protocol HTTP --backend-port 80 --algorithm LEAST_CONNECTIONS --name mypool \
--member address=192.168.31.153 --member address=192.168.31.22 \
--enable-sticky-session
+-----------------------+--------------------------------------+
| Field                 | Value                                |
+-----------------------+--------------------------------------+
| backend_protocol      | HTTP                                 |
| backend_protocol_port | 80                                   |
| certificate           |                                      |
| connection_limit      | -1                                   |
| created_at            | 2019-11-18T13:11:27.982129           |
| description           |                                      |
| enabled               | True                                 |
| healthmonitor         |                                      |
| id                    | fa40e282-b29a-465a-afaa-2c702d2bde17 |
| lb_algorithm          | LEAST_CONNECTIONS                    |
| listener_id           | 66cc714e-af7f-40eb-9db8-67b8b6b6d23c |
| loadbalancer_id       | 941bf637-2d55-40f0-92c0-e65d6567b468 |
| members               | []                                   |
| name                  | mypool                               |
| private_key           |                                      |
| project_id            | e4e059c67dee4736851df14d4519a5a5     |
| protocol              | HTTP                                 |
| protocol_port         | 80                                   |
| status                | CREATING                             |
| sticky_session        | True                                 |
| updated_at            |                                      |
+-----------------------+--------------------------------------+

This command adds a balancing pool mypool to the load balancer mylbaas with the following parameters:

  • “HTTP on port 80 -> HTTP on port 80” forwarding rule
  • the LEAST_CONNECTIONS balancing algorithm
  • two members in the pool
  • enabled sticky session

3.13.7. vinfra service compute load-balancer pool list

List load balancer pools:

usage: vinfra service compute load-balancer pool list [--long] [--load-balancer <load-balancer>]
--long
Enable access and listing of all fields of objects.
--load-balancer <load-balancer>
Load balancer ID or name

Example:

# vinfra service compute load-balancer pool list --load-balancer mylbaas -c id -c protocol \
-c protocol_port -c backend_protocol -c backend_protocol_port -c status
+---------------+----------+---------------+------------------+-----------------------+--------+
| id            | protocol | protocol_port | backend_protocol | backend_protocol_port | status |
+---------------+----------+---------------+------------------+-----------------------+--------+
| fa40e282<...> | HTTP     |            80 | HTTP             |                    80 | ACTIVE |
+---------------+----------+---------------+------------------+-----------------------+--------+

This command lists load balancer pools of the load balancer mylbaas.

3.13.8. vinfra service compute load-balancer pool show

Display load balancer pool details:

usage: vinfra service compute load-balancer pool show <pool>
<pool>
Load balancer pool ID or name

Example:

# vinfra service compute load-balancer pool show mypool
+-----------------------+-----------------------------------------------------------+
| Field                 | Value                                                     |
+-----------------------+-----------------------------------------------------------+
| backend_protocol      | HTTP                                                      |
| backend_protocol_port | 80                                                        |
| certificate           |                                                           |
| connection_limit      | -1                                                        |
| created_at            | 2019-11-18T13:11:27.982129                                |
| description           |                                                           |
| enabled               | True                                                      |
| healthmonitor         |                                                           |
| id                    | fa40e282-b29a-465a-afaa-2c702d2bde17                      |
| lb_algorithm          | LEAST_CONNECTIONS                                         |
| listener_id           | 66cc714e-af7f-40eb-9db8-67b8b6b6d23c                      |
| loadbalancer_id       | 941bf637-2d55-40f0-92c0-e65d6567b468                      |
| members               | - address: 192.168.31.153                                 |
|                       |   compute_server_id: d51c10a7-6187-4a5a-a838-de5fc78a688a |
|                       |   created_at: '2019-11-18T13:11:59.681101'                |
|                       |   enabled: true                                           |
|                       |   id: 3fd5dcc5-6e2c-4e22-8d0a-8e94e20a122f                |
|                       |   name: ''                                                |
|                       |   pool_id: null                                           |
|                       |   status: HEALTHY                                         |
|                       |   updated_at: '2019-11-18T13:12:01.467306'                |
|                       |   weight: 1                                               |
|                       | - address: 192.168.31.22                                  |
|                       |   compute_server_id: 54603109-8963-49f2-8c49-332537c57e90 |
|                       |   created_at: '2019-11-18T13:12:10.176853'                |
|                       |   enabled: true                                           |
|                       |   id: ccb645b3-63c7-44f8-b861-b197c85506d4                |
|                       |   name: ''                                                |
|                       |   pool_id: null                                           |
|                       |   status: HEALTHY                                         |
|                       |   updated_at: '2019-11-18T13:12:12.281578'                |
|                       |   weight: 1                                               |
| name                  | mypool                                                    |
| private_key           |                                                           |
| project_id            | e4e059c67dee4736851df14d4519a5a5                          |
| protocol              | HTTP                                                      |
| protocol_port         | 80                                                        |
| status                | ACTIVE                                                    |
| sticky_session        | True                                                      |
| updated_at            | 2019-11-18T13:12:12.305509                                |
+-----------------------+-----------------------------------------------------------+

This command shows the details of the load balancer pool mypool.

3.13.9. vinfra service compute load-balancer pool set

Modify a load balancer pool:

usage: vinfra service compute load-balancer pool set [--name <name> --protocol {HTTP,HTTPS}]
                                                     [--port <port> --algorithm <algorithm>]
                                                     [--backend-protocol {HTTP,HTTPS}]
                                                     [--backend-port <backend_port>]
                                                     [--certificate-file <cert_file>]
                                                     [--connection-limit <limit>]
                                                     [--description <description>]
                                                     [--healthmonitor type=<type>,
                                                     url_path=<url>[,key=value,...]]
                                                     [--member address=<ip>
                                                     [,enabled=<bool>,weight=<int>]]
                                                     [--privatekey-file <key>]
                                                     [--enable-sticky-session |
                                                     --disable-sticky-session]
                                                     [--enable | --disable]  <pool>
--name <name>
Pool name
--protocol {HTTP,HTTPS}
The protocol for incoming connections
--port <port>
The port for incoming connections
--algorithm <algorithm>
Load balancing algorithm (LEAST_CONNECTIONS, ROUND_ROBIN, or SOURCE_IP)
--backend-protocol {HTTP,HTTPS}
The protocol for destination connections
--backend-port <backend_port>
The port for destination connections
--certificate-file <cert_file>
An x.509 certificate file in the PEM format. Required for TLS-terminated HTTPS->HTTP load balancers.
--connection-limit <limit>
The maximum number of connections permitted for this pool. The default value is -1 (infinite connections).
--description <description>
Pool description
--healthmonitor type=<type>,url_path=<url>[,key=value,...]

Health monitor parameters:

  • type: the health monitor type (HTTP, HTTPS, PING, or TCP)
  • url_path: the URL path to the health monitor
  • comma-separated key=value pairs with keys (optional):
    • delay: the time, in seconds, between sending probes to members.
    • enabled: declares whether the health monitor is enabled or not (true or false).
    • max_retries: the number of successful checks required to change member status to ‘HEALTHY’. Ranges from 1 to 10.
    • max_retries_down: the number of unsuccessful checks required to change member status to ‘UNHEALTHY’. Ranges from 1 to 10.
    • timeout: the maximum time, in seconds, that a monitor waits to connect before it times out. This value must be less than the delay value.
--member address=<ip>[,enabled=<bool>,weight=<int>]

Member parameters:

  • address=<ip>: an IPv4 address of the virtual machine
  • enabled=<bool>: declares whether the member is enabled or not. Can be ‘true’ or ‘false’.
  • weight=<int>: determines the share of connections that the member services compared to the other pool members. For example, a weight of 10 means that the member handles five times as many connections than a member with a weight of 2. A weight of 0 means that the member does not receive new connections but continues to service existing ones. Ranges from 0 to 256. The default value is 1. This option can be used multiple times.
--privatekey-file <key>
A private TLS key file in the PEM format. Required for TLS-terminated HTTPS->HTTP load balancers.
--enable-sticky-session
Enable session persistence.
--disable-sticky-session
Disable session persistence.
--enable
Enable the pool.
--disable
Disable the pool.
<pool>
Load balancer pool ID or name

Example:

# vinfra service compute load-balancer pool set mypool --algorithm ROUND_ROBIN \
--member address=192.168.31.153 --member address=192.168.31.22 \
--member address=192.168.31.51 --disable-sticky-session
Operation accepted.

This command changes the parameters for the balancing pool mypool as follows:

  • sets the balancing algorithm to ROUND_ROBIN
  • adds the third member to the pool
  • disables sticky session

3.13.10. vinfra service compute load-balancer pool delete

Delete a load balancer pool:

usage: vinfra service compute load-balancer pool delete <pool>
<pool>
Load balancer pool ID or name

Example:

# vinfra service compute load-balancer pool delete mypool
Operation successful.

This command removes the load balancer pool mypool.

3.13.11. vinfra service compute load-balancer failover

Perform a failover of a load balancer:

usage: vinfra service compute load-balancer failover <load-balancer>
<load-balancer>
Load balancer ID or name

Example:

# vinfra service compute load-balancer failover mylbaas
Operation accepted.

This command performs a failover of the load balancer mylbaas.

3.13.12. vinfra service compute load-balancer delete

Delete a load balancer:

usage: vinfra service compute load-balancer delete <load-balancer>
<load-balancer>
Load balancer ID or name

Example:

# vinfra service compute load-balancer delete mylbaas
Operation accepted.

This command deletes the load balancer mylbaas.