multi: use Docker for proto compilation

To remove the need for a dev to install a specific version of protoc we
now use a docker image for compiling the protos.

Author: guggero

.github/workflows/main.yml

@@ -147,9 +147,6 @@ jobs:
             lnd-${{ runner.os }}-download-${{ hashFiles('**/install_protoc.sh') }}
             lnd-${{ runner.os }}-download-
 
-      - name: install protoc and protobuf libraries
-        run: ./scripts/install_protoc.sh
-
       - name: get yarn cache dir
         id: yarn-cache-dir
         run: echo "::set-output name=dir::$(yarn cache dir)"

Makefile

@@ -193,7 +193,7 @@ list:
 
 protos:
 	@$(call print, "Compiling protos.")
-	cd ./app; yarn protos
+	cd proto; ./gen_protos_docker.sh
 
 protos-check: protos
 	@$(call print, "Verifying compiled protos.")

doc/compile.md

@@ -76,18 +76,13 @@ Terminal are updated.
 
 To compile the proto files into JS/TS code, follow the following steps:
 
-1. Install `protoc` **v3.4.0** if you do not already have it installed. Follow the
-   instructions in
-   [this guide](https://github.com/lightningnetwork/lnd/tree/master/lnrpc#generate-protobuf-definitions).
-   Be sure to install the specific **v3.4.0** version of `protoc`. Newer versions will not
-   work properly.
-   
-   > Note: if you are running on a Mac, you only need to perform step 1
-1. Run the following command to download the proto files from each repo and compile the
-   JS/TS code using the updated protos.
-   ```shell script
-   $ cd app
-   $ yarn protos
+1. Install `docker` if you do not already have it installed. Follow the
+   instructions in [this guide](https://docs.docker.com/get-docker/).
+
+1. Run the following command to download the proto files from each repo and
+   compile the JS/TS code using the updated protos.
+   ```shell
+   $ make protos
    ```
 1. Fix any typing, linting, or unit test failures introduced by the update. Run the
    commands below to find and fix these errors in the app code.

proto/Dockerfile

@@ -0,0 +1,13 @@
+# Start with a NodeJS base image that also contains yarn.
+FROM node:12.17.0-buster as nodejsbuilder
+
+RUN apt-get update && apt-get install -y \
+  git \
+  protobuf-compiler='3.6*' \
+  clang-format='1:7.0*'
+
+RUN mkdir /build
+
+WORKDIR /build
+
+CMD ["/bin/bash", "-c", "cd app && yarn install && yarn protos"]

proto/gen_protos_docker.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+set -e
+
+# Directory of the script file, independent of where it's called from.
+DIR="$(cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd)"
+
+echo "Building protobuf compiler docker image..."
+docker build -q -t lit-protobuf-builder .
+
+echo "Compiling and formatting *.proto files..."
+docker run \
+  --rm \
+  --user $UID:$UID \
+  -e UID=$UID \
+  -v "$DIR/../:/build" \
+  lit-protobuf-builder