Usage¶
Synopsis¶
libra [GENERAL OPTIONS] [COMMAND] [COMMAND_OPTIONS]
Description¶
libra is a utility designed to communicate with Atlas API based Load Balancer as a Service systems.
Global Options¶
-
--help
,
-h
¶
Show help message and exit
-
--debug
¶
Turn on HTTP debugging for requests
-
--insecure
¶
Don’t validate SSL certs
-
--os_bypass_url
<os_bypass-url>
¶ URL to use as an endpoint instead of the one specified by the Service Catalog
-
--service_type
<service-type>
¶ Alternative service type to use for your cloud provider (default is ‘hpext:lbaas’)
-
--os_auth_url
<auth-url>
¶ The OpenStack authentication URL. Default is
OS_AUTH_URL
orLIBRA_URL
environment variables
-
--os_username
<auth-user-name>
¶ The user name to use for authentication. Default is
OS_USERNAME
orLIBRA_USERNAME
environment variables
-
--os_password
<auth-password>
¶ The password to use for authentication. Default is
OS_PASSWORD
orLIBRA_PASSWORD
environment variables
-
--os_tenant_name
<auth-tenant-name>
¶ The tenant to authenticate to. Default is
OS_TENANT_NAME
orLIBRA_PROJECT_ID
environment variables
-
--os_region_name
<region-name>
¶ The region the load balancer is located. Default is
OS_REGION_NAME
orLIBRA_REGION_NAME
environment variables
Client Commands¶
algorithms¶
Gets a list of supported algorithms
create¶
Create a load balancer
-
--name
<name>
¶ The name of the node to be created
-
--port
<port>
¶ The port the load balancer will listen on
-
--protocol
<protocol>
¶ The protocol type for the load balancer (HTTP, TCP or GALERA). The Galera option adds support for deadlock avoidance in Galera clusters, see Serveral Nine’s Blog on this.
-
--node
<ip:port:option=value:...>
¶ The IP and port for a load balancer node (can be used multiple times to add multiple nodes). Additional node options may be specified after the ip:port portion in a option=value format.
-
--vip
<vip>
¶ The virtual IP ID of an existing load balancer to attach to
limits¶
Show the API limits for the user
logs¶
Send a snapshot of logs to an object store
-
<id>
The ID of the load balancer
-
--storage
<store>
¶ Storage type
-
--endpoint
<endpoint>
¶ Object store endpoint to use
-
--basepath
<basepath>
¶ Object store based directory
-
--token
<token>
¶ Object store authentication token
update¶
Update a load balancer’s configuration
-
<id>
The ID of the load balancer
-
--name
<name>
¶ A new name for the load balancer
-
--algorithm
<algorithm>
¶ A new algorithm for the load balancer
node-add¶
Add a node to a load balancer
-
<id>
The ID of the load balancer
-
--node
<ip:port:option=value:...>
¶ The node address in ip:port format (can be used multiple times to add multiple nodes). Additional node options may be specified after the ip:port portion in a option=value format.
node-delete¶
Delete a node from the load balancer
-
<id>
The ID of the load balancer
-
<nodeid>
The ID of the node to be removed
node-update¶
Update a node’s state in a load balancer
-
<id>
The ID of the load balancer
-
<nodeid>
The ID of the node to be updated
-
--condition
<condition>
¶ The new state of the node (either ENABLED or DISABLED)
node-show¶
Get the status of a node in a load balancer
-
<id>
The ID of the load balancer
-
<nodeid>
The ID of the node in the load balancer
protocols¶
Gets a list of supported protocols