Update Dockerfile, GitHub actions and docs

Author: fbacall

.github/workflows/deployment-checks.yml

@@ -48,6 +48,8 @@ jobs:
           cp config/secrets.github.yml config/secrets.yml
           cp config/ingestion.example.yml config/ingestion.yml
           bundle exec rake db:setup
+      - run: yarn install
+        name: Install JS dependencies
       - run: bundle exec rake assets:precompile
         name: Run asset compilation
       - run: bundle exec whenever --update-crontab --set environment="$ENV"

.github/workflows/test.yml

@@ -53,5 +53,7 @@ jobs:
           cp config/secrets.github.yml config/secrets.yml
           cp config/ingestion.example.yml config/ingestion.yml
           bundle exec rake db:test:prepare
+      - run: yarn install
+        name: Install JS dependencies
       - run: bundle exec rails test
         name: Run tests

Dockerfile

@@ -8,9 +8,11 @@ WORKDIR /code
 
 # install dependencies
 RUN apt-get update \
-    && apt-get install build-essential curl file git gnupg2 imagemagick libpq-dev libyaml-dev nodejs -y \
+    && apt-get install build-essential curl file git gnupg2 imagemagick libpq-dev libyaml-dev nodejs npm -y \
     && apt-get clean
 
+# install yarn to manage JS dependencies
+RUN npm install --global yarn
 
 # install supercronic - a cron alternative
 ENV SUPERCRONIC_URL=https://github.com/aptible/supercronic/releases/download/v0.1.12/supercronic-linux-amd64 \
@@ -41,6 +43,12 @@ COPY Gemfile Gemfile.lock ./
 # install gems
 RUN bundle check || bundle install
 
+# copy package file
+COPY package.json yarn.lock ./
+
+# install js dependencies
+RUN yarn install
+
 # copy code
 COPY . .
 

docs/install.md

@@ -16,11 +16,12 @@ TeSS requires the following system packages to be installed:
 - ImageMagick
 - A Java runtime
 - A JavaScript runtime
+- npm (and yarn)
 - Redis
 
 To install these under an Ubuntu-like OS using apt:
 
-    sudo apt-get install git postgresql libpq-dev imagemagick nodejs redis-server openjdk-11-jdk
+    sudo apt-get install git postgresql libpq-dev imagemagick nodejs npm redis-server openjdk-11-jdk
 
 For Mac OS X:
 
@@ -67,6 +68,18 @@ Once you have Ruby, RVM and bundler installed, from the root folder of the app d
 
 This will install Rails, as well as any other gem that the TeSS app needs as specified in Gemfile (located in the root folder of the TeSS app).
 
+## JS
+
+TeSS uses yarn to manage JS dependencies.
+
+Install it using npm:
+
+    npm install --global yarn
+
+and install JS dependencies using (from the app's root directory):
+
+    yarn install
+
 ## PostgreSQL
 
 Install postgres and add a postgres user called 'tess_user' for the use by the TeSS app (you can name the user any way you like).

docs/production.md

@@ -4,7 +4,7 @@ This page contains some extra notes about setting up TeSS for production on an U
 
 ## System Dependencies
 
-    sudo apt-get install git postgresql libpq-dev imagemagick nodejs openjdk-11-jdk apache2 gnupg2
+    sudo apt-get install git postgresql libpq-dev imagemagick nodejs npm openjdk-11-jdk apache2 gnupg2
 
 To install a recent version of Redis (6.2+), use the official Redis APT repo:
 
@@ -184,6 +184,16 @@ _Note: Ensure you have started Solr before running this command!_
 
     RAILS_ENV=production bundle exec rake db:setup
 
+## Install yarn & install JS dependencies
+
+Install yarn globally via npm:
+
+    npm install --global yarn
+
+Install JS dependencies:
+
+    yarn install
+
 ## Compile assets
 
 Assets - such as images, javascript and stylesheets, need to be precompiled -