2021 Developer Startup Guide (WIP)

Quickstart

• Download Repo
• Install Global Dependencies (need to update this, but need to make sure devs have docker, node, (others?) and correct env files)
  • • Docker https://hub.docker.com/editions/community/docker-ce-desktop-mac
  • • Node/npm https://treehouse.github.io/installation-guides/mac/node-mac.html
  • • Yarn https://classic.yarnpkg.com/en/docs/install/#mac-stable
• Add .env vars to .env at /
• Add .env vars to .env at /front/.env
• run npm install and _____ in / and yarn install in /front
• (update later - docker, node, etc)
• docker-compose build (currently takes about 15 min, but should be mainly avoidable in most situations save for deployments, but hopefully also optimizable)
• docker-compose up
• cd front
• yarn
• yarn start (should serve front-end app at localhost://3000

Back Up DB instructions

(docker needs to be running to connect to clinwiki-db container)

Run move seed file into docker container : Docker cp <file> clinwiki-db:/ restore seed database sql file to docker postgres instance docker exec -it clinwiki-db psql -U clinwiki -d clinwiki -f <file>

IMPORT hasura_metadata file in local hasura console. (latest hasura meta file in repo at ___ , may need to modify connection string in file)

(need to still solidify which db is backup, which metadata will correctly match relationships and schema)

Helpful commands for reindexing using old (but working mappings locally)

Either

1a. Uncomment out clinwiki container and then docker-compose build

or 1b. Switch to Master and add ‘gem 'mimemagic', github: 'mimemagicrb/mimemagic', ref: '01f92d86d15d85cfd0f20dabd025dcbd36a8a60f’’ to end of GEMFILE (we should probably create a reindexing branch and commit this, if we plan on using old mapping prior to next elastic version, it's a pain in the ass, but it's this or maybe throwing a few hours at fighting with new mapping created by elastic) 2. Docker exec -it rails c 3. Study.reindex 4.. Switch back to develop or your local branch and re run docker-compose build (this is the unfortunatel part of this process and then proceed normally)

or 1c. load mapping file (in repo _____) with command, easy from kibana development tab

For backend development

(when you don't want to wait for docker-compose build)

comment out data-pipeline and nodejs containers (in docker-comopose.yml and run data-pipeline and node outside of docker via npm start and npm run start data-pipeline (is this "npm start" for nodejs and "npm start pipeline" for data-pipeline) scripts

docker containers for elastic, kibana, clinwiki-db (for postgres), nginx and