Allow external uri to be configurable for components that support server functionality.

SE nodes might be behind some sort of proxy exposed to hub on a
different hostname(/ip) and/or port than component would by default
report themselves (e.g.: hub and nodes are in different k8s clusters
 and services are exposed via node ports).

Fixes #12491

Author: utamas

website_and_docs/content/documentation/grid/configuration/cli_options.en.md

@@ -248,15 +248,16 @@ pull request updating this page.
 
 ### Server
 
-| Option | Type | Value/Example | Description |
-|---|---|---|---|
-| `--allow-cors` | boolean | `true` | Whether the Selenium server should allow web browser connections from any host |
-| `--host` | string | `localhost` | Server IP or hostname: usually determined automatically. |
-| `--bind-host` | boolean | `true` | Whether the server should bind to the host address/name, or only use it to" report its reachable url. Helpful in complex network topologies where the server cannot report itself with the current IP/hostname but rather an external IP or hostname (e.g. inside a Docker container) |
-| `--https-certificate` | path | `/path/to/cert.pem` | Server certificate for https. Get more detailed information by running "java -jar selenium-server.jar info security" |
-| `--https-private-key` | path | `/path/to/key.pkcs8` | Private key for https. Get more detailed information by running "java -jar selenium-server.jar info security" |
-| `--max-threads` | int | `24` | Maximum number of listener threads. Default value is: (available processors) * 3. |
-| `--port` | int | `4444` | Port to listen on. There is no default as this parameter is used by different components, for example, Router/Hub/Standalone will use 4444 and Node will use 5555. |
+| Option                | Type    | Value/Example | Description |
+|-----------------------|---------|---|---|
+| `--external-uri`      | string  | `http://10.0.1.1:33333` | External URI where component is generally available. Useful on complex network topologies when components are on different networks and proxy servers are involved. |
+| `--allow-cors`        | boolean | `true` | Whether the Selenium server should allow web browser connections from any host |
+| `--host`              | string  | `localhost` | Server IP or hostname: usually determined automatically. |
+| `--bind-host`         | boolean | `true` | Whether the server should bind to the host address/name, or only use it to" report its reachable url. Helpful in complex network topologies where the server cannot report itself with the current IP/hostname but rather an external IP or hostname (e.g. inside a Docker container) |
+| `--https-certificate` | path    | `/path/to/cert.pem` | Server certificate for https. Get more detailed information by running "java -jar selenium-server.jar info security" |
+| `--https-private-key` | path    | `/path/to/key.pkcs8` | Private key for https. Get more detailed information by running "java -jar selenium-server.jar info security" |
+| `--max-threads`       | int     | `24` | Maximum number of listener threads. Default value is: (available processors) * 3. |
+| `--port`              | int     | `4444` | Port to listen on. There is no default as this parameter is used by different components, for example, Router/Hub/Standalone will use 4444 and Node will use 5555. |
 
 ### SessionQueue