Skip to content

Commit 8806d83

Browse files
feat(lb): improve doc and add private-network (#2703)
Co-authored-by: Jules Castéran <jcasteran@scaleway.com>
1 parent 37a9841 commit 8806d83

File tree

51 files changed

+631
-243
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+631
-243
lines changed

cmd/scw/testdata/test-all-usage-container-container-create-usage.golden

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,9 @@ ARGS:
2222
[port]
2323
[secret-environment-variables.{index}.key]
2424
[secret-environment-variables.{index}.value]
25+
[http-option] Configure how HTTP and HTTPS requests are handled (unknown_http_option | enabled | redirected)
2526
[region=fr-par] Region to target. If none is passed will use default region from the config (fr-par)
2627

27-
DEPRECATED ARGS:
28-
[http-option] Configure how HTTP and HTTPS requests are handled
29-
3028
FLAGS:
3129
-h, --help help for create
3230

cmd/scw/testdata/test-all-usage-container-container-update-usage.golden

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,9 @@ ARGS:
2222
[port]
2323
[secret-environment-variables.{index}.key]
2424
[secret-environment-variables.{index}.value]
25+
[http-option] Configure how HTTP and HTTPS requests are handled (unknown_http_option | enabled | redirected)
2526
[region=fr-par] Region to target. If none is passed will use default region from the config (fr-par)
2627

27-
DEPRECATED ARGS:
28-
[http-option] Configure how HTTP and HTTPS requests are handled
29-
3028
FLAGS:
3129
-h, --help help for update
3230

cmd/scw/testdata/test-all-usage-lb-backend-add-servers-usage.golden

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ARGS:
1313
[baremetal-server-id.{index}] UIID of the baremetal server.
1414
[baremetal-server-tag.{index}] Tag of the baremetal server.
1515
server-ip.{index} Set all IPs to add on your backend
16-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
16+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
1717

1818
FLAGS:
1919
-h, --help help for add-servers

cmd/scw/testdata/test-all-usage-lb-backend-create-usage.golden

Lines changed: 38 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,41 +6,44 @@ USAGE:
66
scw lb backend create [arg=value ...]
77

88
ARGS:
9-
name=<generated> Resource name
10-
forward-protocol Backend protocol. TCP or HTTP (tcp | http)
11-
forward-port User sessions will be forwarded to this port of backend servers
12-
forward-port-algorithm=roundrobin Load balancing algorithm (roundrobin | leastconn | first)
13-
sticky-sessions=none Enables cookie-based session persistence (none | cookie | table)
14-
[sticky-sessions-cookie-name] Cookie name for for sticky sessions
15-
[health-check.mysql-config.user]
16-
[health-check.check-max-retries]
17-
[health-check.pgsql-config.user]
18-
[health-check.http-config.uri]
19-
[health-check.http-config.method]
20-
[health-check.http-config.code]
21-
[health-check.https-config.uri]
22-
[health-check.https-config.method]
23-
[health-check.https-config.code]
24-
[health-check.port]
25-
[health-check.check-timeout]
26-
[health-check.check-delay]
27-
[health-check.check-send-proxy] It defines whether the healthcheck should be done considering the proxy protocol
28-
lb-id Load balancer ID
29-
[instance-server-id.{index}] UIID of the instance server.
30-
[instance-server-tag.{index}] Tag of the instance server.
31-
[use-instance-server-public-ip] Use public IP address of the instance instead of the private one
32-
[baremetal-server-id.{index}] UIID of the baremetal server.
33-
[baremetal-server-tag.{index}] Tag of the baremetal server.
34-
server-ip.{index} Backend server IP addresses list (IPv4 or IPv6)
35-
[timeout-server] Maximum server connection inactivity time
36-
[timeout-connect] Maximum initical server connection establishment time
37-
[timeout-tunnel] Maximum tunnel inactivity time
38-
[on-marked-down-action] Modify what occurs when a backend server is marked down (on_marked_down_action_none | shutdown_sessions)
39-
[proxy-protocol] PROXY protocol, forward client's address (must be supported by backend servers software) (proxy_protocol_unknown | proxy_protocol_none | proxy_protocol_v1 | proxy_protocol_v2 | proxy_protocol_v2_ssl | proxy_protocol_v2_ssl_cn)
40-
[failover-host] Scaleway S3 bucket website to be served in case all backend servers are down
41-
[ssl-bridging] Enable SSL between load balancer and backend servers
42-
[ignore-ssl-server-verify] Set to true to ignore server certificate verification
43-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
9+
name=<generated> Resource name
10+
forward-protocol Backend protocol. TCP or HTTP (tcp | http)
11+
forward-port User sessions will be forwarded to this port of backend servers
12+
forward-port-algorithm=roundrobin Load balancing algorithm (roundrobin | leastconn | first)
13+
sticky-sessions=none Enables cookie-based session persistence (none | cookie | table)
14+
[sticky-sessions-cookie-name] Cookie name for sticky sessions
15+
[health-check.mysql-config.user]
16+
[health-check.check-max-retries] Number of consecutive unsuccessful health checks, after which the server will be considered dead
17+
[health-check.pgsql-config.user]
18+
[health-check.http-config.uri] HTTP uri used with the request
19+
[health-check.http-config.method] HTTP method used with the request
20+
[health-check.http-config.code] HTTP response code so the Healthcheck is considered successfull
21+
[health-check.http-config.host-header] HTTP host header used with the request
22+
[health-check.https-config.uri] HTTP uri used with the request
23+
[health-check.https-config.method] HTTP method used with the request
24+
[health-check.https-config.code] HTTP response code so the Healthcheck is considered successfull
25+
[health-check.https-config.host-header] HTTP host header used with the request
26+
[health-check.https-config.sni] Specifies the SNI to use to do health checks over SSL
27+
[health-check.port] TCP port to use for the backend server health check
28+
[health-check.check-timeout] Maximum time a backend server has to reply to the health check
29+
[health-check.check-delay] Time between two consecutive health checks
30+
[health-check.check-send-proxy] It defines whether the health check should be done considering the proxy protocol
31+
lb-id Load balancer ID
32+
[instance-server-id.{index}] UIID of the instance server.
33+
[instance-server-tag.{index}] Tag of the instance server.
34+
[use-instance-server-public-ip] Use public IP address of the instance instead of the private one
35+
[baremetal-server-id.{index}] UIID of the baremetal server.
36+
[baremetal-server-tag.{index}] Tag of the baremetal server.
37+
server-ip.{index} Backend server IP addresses list (IPv4 or IPv6)
38+
[timeout-server] Maximum server connection inactivity time (allowed time the server has to process the request)
39+
[timeout-connect] Maximum initial server connection establishment time
40+
[timeout-tunnel] Maximum tunnel inactivity time after Websocket is established (take precedence over client and server timeout)
41+
[on-marked-down-action] Modify what occurs when a backend server is marked down (on_marked_down_action_none | shutdown_sessions)
42+
[proxy-protocol] PROXY protocol, forward client's address (must be supported by backend servers software) (proxy_protocol_unknown | proxy_protocol_none | proxy_protocol_v1 | proxy_protocol_v2 | proxy_protocol_v2_ssl | proxy_protocol_v2_ssl_cn)
43+
[failover-host] Scaleway S3 bucket website to be served in case all backend servers are down
44+
[ssl-bridging] Enable SSL between load balancer and backend servers
45+
[ignore-ssl-server-verify] Set to true to ignore server certificate verification
46+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
4447

4548
DEPRECATED ARGS:
4649
[send-proxy-v2] Deprecated in favor of proxy_protocol field !

cmd/scw/testdata/test-all-usage-lb-backend-delete-usage.golden

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ USAGE:
77

88
ARGS:
99
backend-id ID of the backend to delete
10-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
10+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
1111

1212
FLAGS:
1313
-h, --help help for delete

cmd/scw/testdata/test-all-usage-lb-backend-get-usage.golden

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ USAGE:
77

88
ARGS:
99
backend-id Backend ID
10-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
10+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
1111

1212
FLAGS:
1313
-h, --help help for get

cmd/scw/testdata/test-all-usage-lb-backend-list-usage.golden

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ USAGE:
88
ARGS:
99
lb-id Load balancer ID
1010
[name] Use this to search by name
11-
[order-by] Choose order of response (created_at_asc | created_at_desc | name_asc | name_desc)
12-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
11+
[order-by] Response order (created_at_asc | created_at_desc | name_asc | name_desc)
12+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
1313

1414
FLAGS:
1515
-h, --help help for list

cmd/scw/testdata/test-all-usage-lb-backend-remove-servers-usage.golden

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ARGS:
1313
[baremetal-server-id.{index}] UIID of the baremetal server.
1414
[baremetal-server-tag.{index}] Tag of the baremetal server.
1515
server-ip.{index} Set all IPs to remove of your backend
16-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
16+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
1717

1818
FLAGS:
1919
-h, --help help for remove-servers

cmd/scw/testdata/test-all-usage-lb-backend-set-servers-usage.golden

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ARGS:
1313
[baremetal-server-id.{index}] UIID of the baremetal server.
1414
[baremetal-server-tag.{index}] Tag of the baremetal server.
1515
server-ip.{index} Set all IPs to add on your backend and remove all other
16-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
16+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
1717

1818
FLAGS:
1919
-h, --help help for set-servers

cmd/scw/testdata/test-all-usage-lb-backend-update-healthcheck-usage.golden

Lines changed: 18 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,24 @@ USAGE:
66
scw lb backend update-healthcheck [arg=value ...]
77

88
ARGS:
9-
port Specify the port used to health check
10-
check-delay Time between two consecutive health checks
11-
check-timeout Additional check timeout, after the connection has been already established
12-
check-max-retries Number of consecutive unsuccessful health checks, after wich the server will be considered dead
13-
backend-id Backend ID
14-
[mysql-config.user]
15-
[pgsql-config.user]
16-
[http-config.uri]
17-
[http-config.method]
18-
[http-config.code]
19-
[https-config.uri]
20-
[https-config.method]
21-
[https-config.code]
22-
[check-send-proxy] It defines whether the healthcheck should be done considering the proxy protocol
23-
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1)
9+
port Specify the port used to health check
10+
check-delay Time between two consecutive health checks
11+
check-timeout Maximum time a backend server has to reply to the health check
12+
check-max-retries Number of consecutive unsuccessful health checks, after which the server will be considered dead
13+
backend-id Backend ID
14+
[mysql-config.user]
15+
[pgsql-config.user]
16+
[http-config.uri] HTTP uri used with the request
17+
[http-config.method] HTTP method used with the request
18+
[http-config.code] HTTP response code so the Healthcheck is considered successfull
19+
[http-config.host-header] HTTP host header used with the request
20+
[https-config.uri] HTTP uri used with the request
21+
[https-config.method] HTTP method used with the request
22+
[https-config.code] HTTP response code so the Healthcheck is considered successfull
23+
[https-config.host-header] HTTP host header used with the request
24+
[https-config.sni] Specifies the SNI to use to do health checks over SSL
25+
[check-send-proxy] It defines whether the health check should be done considering the proxy protocol
26+
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | nl-ams-2 | pl-waw-1 | pl-waw-2)
2427

2528
FLAGS:
2629
-h, --help help for update-healthcheck

0 commit comments

Comments
 (0)