dtctl load-balancer create-balancing-pool
Usage
dtctl load-balancer create-balancing-pool [flags]
Aliases
cbp
Description
Create a listener, pool, and health monitor together in one step. This is a convenient way to stand up a complete balancing configuration; you can optionally include members inline.
Example
# Create an HTTP balancing pool (listener + pool + TCP health check) in one call
dtctl load-balancer create-balancing-pool --lb-id <lb-id> --lb-protocol HTTP --lb-port 80 --backend-protocol HTTP --backend-protocol-port 80 --lb-algorithm ROUND_ROBIN --type TCP --interval 5 --timeout 5 --healthy-threshold 3 --unhealthy-threshold 3 --sticky-session=false
Flags
| Option | Description |
|---|---|
--allowed-cidrs, -g | Comma-separated list of allowed CIDRs |
--backend-protocol, -r | Backend protocol (e.g., HTTP, HTTPS, TCP, UDP) (required) |
--backend-protocol-port, -b | Port number for the backend protocol (required) |
--certificate, -f | Certificate content for the balancing pool |
--connection-limit, -j | Maximum number of connections for the balancing pool |
--healthy-threshold, -v | Healthy threshold number (required) |
--insert-headers, -q | Insert headers, as comma-separated key=value pairs. Supported headers: - X-Forwarded-For - X-Forwarded-Port - X-Forwarded-Proto - X-SSL-Client-CN - X-SSL-Client-DN - X-SSL-Client-Has-Cert - X-SSL-Client-Verify - X-SSL-Client-Not-After - X-SSL-Client-Not-Before - X-SSL-Client-SHA1 - X-SSL-Issuer Example: "X-Forwarded-For=true,X-Forwarded-Proto=https" |
--interval, -e | Interval for health checks (required) |
--lb-algorithm, -a | Load balancing algorithm (e.g., LEAST_CONNECTIONS, ROUND_ROBIN, SOURCE_IP) (required) |
--lb-id, -i | ID of the load balancer (required) |
--lb-port, -l | Port number for the load balancer (required) |
--lb-protocol, -p | Load balancer protocol (e.g., HTTPS, HTTP, TCP, UDP) (required) |
--members | Semicolon separated list of members (e.g., 'address=1.1.1.1,compute_server_id=server-1,protocol_port=80;address=1.1.1.2,compute_server_id=server-2,protocol_port=82') |
--path, -u | URL path for health checks |
--private-key, -k | Private key for the certificate |
--sticky-session, -s | Enable sticky session for the balancing pool (required) |
--timeout, -t | Timeout for health checks (required) |
--timeout-client-data, -d | Timeout in seconds for client data |
--timeout-member-connect, -z | Timeout in seconds for connecting to backend members |
--timeout-member-data, -m | Timeout in seconds for backend member data |
--type, -y | Type of health check (e.g., HTTP, HTTPS, TCP, PING, UDP-CONNECT) (required) |
--unhealthy-threshold, -x | Unhealthy threshold number (required) |
Related Commands
| Command | Description |
|---|---|
| dtctl load-balancer delete-balancing-pool | Delete a balancing pool |
| dtctl load-balancer balancing-pool | Show a balancing pool |
| dtctl load-balancer balancing-pools | List balancing pools |
Global Flags
| Option | Description |
|---|---|
--api-url | Send this command to a different API endpoint, e.g. a test environment (default "https://console.dt.net.tr/api/v1") |
--config, -c | Specify a custom config file Default: ~/.config/dtctl/config.yaml |
--no-headers | Omit the column headers, for scripting Default: false |
--output, -o | Output format: text, wide, vertical, json. text fits the terminal, wide never truncates, vertical prints one field per line Default: text |