Developer Guide

See Node setup on the system for prereq.

Node setup on the system

using OS

curl -sL https://deb.nodesource.com/setup_16.x | sudo bash -
sudo apt install nodejs

If you wish to support multiple versions, add n

sudo npm install -g n
sudo n 16.15.0

Install locally

Copy and adjust .env.example .env

sudo apt install libkrb5-dev libssh2-1-dev

npm install

wikigdrive --workdir ~/wikigdrive --service_account ~/workspaces/mieweb/wikigdrive-with-service-account.json --share_email [email protected] server 3000

Running locally with docker

docker run --name zipkin -d -p 9411:9411 --restart unless-stopped openzipkin/zipkin

docker build -t wgd-action-runner apps/wgd-action-runner

docker build -t wikigdrive .

docker run --rm --user=$(id -u) -it \
          -v /data/wikigdrive:/data \
          -v ~/workspaces/mieweb/wikigdrive-with-service-account.json:/service_account.json \
          -v ~/workspaces/mieweb/wikiGDrive:/usr/src/app \
          -v /var/run/docker.sock:/var/run/docker.sock \
          --link zipkin:zipkin \
          --publish 127.0.0.1:3000:3000 \
          --publish 127.0.0.1:24678:24678 \
          wikigdrive \
          ./src/wikigdrived.sh --service_account /service_account.json --share_email [email protected] --workdir /data server 3000

docker rm -f wikigdrive

# 24678 - vite hot reload port

Domain

wikigdrive.com (hosted by??)
DNS SERVER?

Authentication

Client ID for the Web Application Add-On / Authentication

Link to production’s OAUTH configuration: https://console.cloud.google.com/apis/credentials/oauthclient/762352378313-3u5pagjnk24g9640a5j1bmlsvobtlq2k.apps.googleusercontent.com?project=wikigdrive

Stored in /home/wikigdrive/env.prod

This is for the Service Account

https://console.cloud.google.com/iam-admin/serviceaccounts/details/103184696095283927333?project=wikigdrive

Link to the keys
last key used is dcb0a0d690d0a5ac24b42a3f1962bf9802c36882 and is in here

Add On Service - Google MarketPlace

This is for configuring Google Apps and their Console to permit the Google Marketplace to the store.

See folder /apps/app-script in the sources

Runner

The Actions Runner runs on vps1.ovh.wikigdrive.com

wikiGDrive Server

ssh 184.175.182.25

Google Doc Setup Documentation

Developer Test

Simple Test: https://dev.wikigdrive.com/drive/0APmwe3yIhGabUk9PVA
Complex Test: https://dev.wikigdrive.com/drive/0AF_nrE0_QH_2Uk9PVA

Production Docker

root@wgd-dev:~# docker exec -it wikigdrive-prod bash
wikigdrive --service_account /service_account.json  drives

Code Diagram src

Cool trick to watch changes as they happen in a document:

cd /var/lib/docker/volumes/wikiGDriveDevelop/_data/0APmwe3yIhGabUk9PVA
watch -d odt2txt 1WfXOsKmPgOtdsZxXdl6RpqMrlkQP2O1GrprnaFxK0oE.odt

Another cool trick to see diffs in images:

https://github.com/ewanmellor/git-diff-image

Zipkin telemetry setup

Start zipkin with:

docker run --name zipkin -d -p 9411:9411 --restart unless-stopped openzipkin/zipkin

Set app env var to:

ZIPKIN_URL=http://localhost:9411

Debugging

./src/wikigdrived.sh --inspect --workdir ~/wikigdrive --service_account ~/workspaces/mieweb/wikigdrive-with-service-account.json --share_email [email protected] server 3000

Chrome

Go to `chrome://inspect`

Visual Studio Code 1.10+

In the Debug panel, click the settings icon to open .vscode/launch.json. Select "Node.js" for initial setup.

JetBrains WebStorm and other JetBrains IDEs

Create a new Node.js debug configuration and hit Debug. --inspect will be used by default for Node.js 7+. To disable uncheck js.debugger.node.use.inspect in the IDE Registry. To learn more about running and debugging Node.js in WebStorm and other JetBrains IDEs, check out WebStorm online help.