From bb69a98bd27b1f7c324e5839a9179f99e08a640f Mon Sep 17 00:00:00 2001 From: Christos Hadjiaslanis Date: Mon, 26 Aug 2024 16:57:30 +0300 Subject: [PATCH] Improve validator onboarding (#128) * Update the load balancer configuration instructions * Added testnet name to joining section * Change Mb to MB --- TESTNET_BRANCH | 1 + TESTNET_DOMAIN | 1 + src/operators/testnets/joining.md | 15 +++++++++++---- 3 files changed, 13 insertions(+), 4 deletions(-) create mode 100644 TESTNET_BRANCH create mode 100644 TESTNET_DOMAIN diff --git a/TESTNET_BRANCH b/TESTNET_BRANCH new file mode 100644 index 00000000..80492e2d --- /dev/null +++ b/TESTNET_BRANCH @@ -0,0 +1 @@ +testnet_abel \ No newline at end of file diff --git a/TESTNET_DOMAIN b/TESTNET_DOMAIN new file mode 100644 index 00000000..125d0358 --- /dev/null +++ b/TESTNET_DOMAIN @@ -0,0 +1 @@ +testnet-abel diff --git a/src/operators/testnets/joining.md b/src/operators/testnets/joining.md index 5b62c4d0..7a2a3a3a 100644 --- a/src/operators/testnets/joining.md +++ b/src/operators/testnets/joining.md @@ -18,6 +18,9 @@ the Docker docs. ### Installing the Linera Toolchain +> When installing the Linera Toolchain, you **must** check out the +> `{{#include ../../../TESTNET_BRANCH}}` branch. + To install the Linera Toolchain refer to the [installation section](../../developers/getting_started/installation.md#installing-from-github). @@ -34,9 +37,13 @@ For the next section, we'll be working out of the `docker` subdirectory in the Validators run via Docker Compose do not come with a pre-packaged load balancer to perform TLS termination (unlike validators running on Kubernetes). -Thus, it is required of validator operators to provide TLS termination and -support long-lived HTTP/2 connections required for the functioning of the Linera -notification system. +The load balancer configuration **must** have the following properties: + +1. Support HTTP/2 connections. +2. Support gRPC connections. +3. Support long-lived HTTP/2 connections. +4. Support a maximum body size of up to 20 MB. +5. Provide TLS termination with a certificate signed by a known CA. Finally, the load balancer that performs TLS termination must redirect traffic from `443` to `19100` (the port exposed by the proxy). @@ -78,7 +85,7 @@ bucket managed by the Linera Protocol core team. An example can be found here: ```bash -wget "https://storage.googleapis.com/linera-io-dev-public/{{#include ../../../RELEASE_DOMAIN}}/genesis.json" +wget "https://storage.googleapis.com/linera-io-dev-public/{{#include ../../../TESTNET_DOMAIN}}/genesis.json" ``` ### Creating Your Keys