doctl compute load-balancer create

Go to Navigation

Usage

doctl compute load-balancer create [flags]

Aliases

c

Description

Use this command to create a new load balancer on your account. Valid forwarding rules are:

  • entry_protocol: The entry protocol used for traffic to the load balancer. Possible values are: http, https, http2, or tcp.
  • entry_port: The entry port used for incoming traffic to the load balancer.
  • target_protocol: The target protocol used for traffic from the load balancer to the backend Droplets. Possible values are: http, https, http2, or tcp.
  • target_port: The target port used to send traffic from the load balancer to the backend Droplets.
  • certificate_id: The ID of the TLS certificate used for SSL termination, if enabled. Can be obtained with doctl certificate list
  • tls_passthrough: Whether SSL passthrough is enabled on the load balancer.

Flags

OptionDescription
--algorithmThe algorithm to use when traffic is distributed across your Droplets; possible values: round_robin or least_connections
Default: round_robin
--droplet-idsA comma-separated list of Droplet IDs to add to the load balancer, e.g.: 12,33
--enable-backend-keepaliveenable keepalive connections to backend target droplets
Default: false
--enable-proxy-protocolenable proxy protocol
Default: false
--forwarding-rulesA comma-separated list of key-value pairs representing forwarding rules, which define how traffic is routed, e.g.: entry_protocol:tcp, entry_port:3306, target_protocol:tcp, target_port:3306. Use a quoted string of space-separated values for multiple rules
--health-checkA comma-separated list of key-value pairs representing recent health check results, e.g.: protocol:http, port:80, path:/index.html, check_interval_seconds:10, response_timeout_seconds:5, healthy_threshold:5, unhealthy_threshold:3
--help, -hHelp for this command
--nameThe load balancer’s name (required)
--redirect-http-to-httpsRedirects HTTP requests to the load balancer on port 80 to HTTPS on port 443
Default: false
--regionThe load balancer’s region, e.g.: nyc1 (required)
--sizeThe load balancer’s size, e.g.: lb-small (required)
Default: lb-small
--sticky-sessionsA comma-separated list of key-value pairs representing a list of active sessions, e.g.: type:cookies, cookie_title:DO-LB, cookie_ttl_seconds:5
--tag-namedroplet tag name
--vpc-uuidThe UUID of the VPC to create the load balancer in
CommandDescription
doctl compute load-balancerDisplay commands to manage load balancers

Global Flags

OptionDescription
--access-token, -tAPI V2 access token
--api-url, -uOverride default API endpoint
--config, -cSpecify a custom config file
Default:
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--contextSpecify a custom authentication context name
--output, -oDesired output format [text|json]
Default: text
--traceShow a log of network activity while performing a command
Default: false
--verbose, -vEnable verbose output
Default: false