chore: backup, migrate, restore scripts

docker and deploy tweaks; readme

resolves #1

.gitignore

@@ -37,3 +37,5 @@ client/build
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+
+.env

README.md

@@ -23,11 +23,24 @@ npm install
 npm start
 ```
 
-This project uses [commitizen](https://commitizen.github.io/cz-cli/), please commit with `npm run commit`
+This project uses [commitizen](https://commitizen.github.io/cz-cli/), commit with `npm run commit`
 
 ## testing
 
 ```shell
 cd client/
 npm t
 ```
+
+## running on production
+
+to launch on production, run `docker-compose up -d`, and then:
+
+start from scratch | restore backup
+--- | ---
+`bash ./scripts/migrate.sh` | `bash ./scripts/restore.sh`
+
+to backup the DB (while the container is running), run:
+```
+bash ./scripts/backup.sh
+```

package.json

@@ -1,7 +1,7 @@
 {
   "scripts": {
     "start": "concurrently --prefix \"{name}\" --names \"RAILS,REACT,CSS\" -c \"bgBlue,black.bgGreen,black.bgYellow\" \"rails s -p 3001\" \"(cd client && npm run start)\" \"(cd client && npm run watch-css)\"",
-    "deploy": "rsync -avz -e 'ssh' --exclude-from '.rsync-exclude' . scylla:/home/scylla/books",
+    "deploy": "rsync -avz -e 'ssh' --exclude-from '.rsync-exclude' . ostia:/home/ostia/books",
     "build:deploy": "npm run build && npm run deploy",
     "build": "(cd client && npm run build)",
     "postinstall": "cd client/ && yarn install",

scripts/backup.sh

@@ -0,0 +1,7 @@
+mkdir -p backup
+
+_now=$(date +"%m_%d_%Y"_"%H_%M_%S")
+_file="backup/data_$_now.sql"
+
+# using `--inserts` to avoid '\N' problems https://stackoverflow.com/a/37531223/3772847
+docker-compose exec postgres sh -c 'pg_dumpall --inserts -c -U postgres' > $_file

scripts/migrate.sh

@@ -0,0 +1 @@
+docker-compose exec api sh -c 'bundle exec rails db:migrate'

scripts/restore.sh

@@ -0,0 +1,7 @@
+cd backup
+# get the most recent file
+dump_file=$(ls -t . | head -1 )
+
+printf "\nrestoring from "$dump_file"\n\n"
+
+egrep -v '^(CREATE|DROP) ROLE postgres;' $dump_file | docker-compose exec postgres psql -U postgres