Merge pull request #1 from mlh-henry/glitch

🙄📺 Updated with Glitch, fixed extracting problem

Author: mlh-henry

.bash_profile

@@ -0,0 +1 @@
+

.cockroachsql_history

@@ -0,0 +1,4 @@
+_HiStOrY_V2_
+SET\040sql_safe_updates\040=\040false;
+UPDATE\040startrek.quotes\040SET\040characters\040=\040'your_name_here';
+\134q

.gitignore

@@ -0,0 +1,6 @@
+{"name":"drag-in-files.svg","date":"2016-10-22T16:17:49.954Z","url":"https://cdn.hyperdev.com/drag-in-files.svg","type":"image/svg","size":7646,"imageWidth":276,"imageHeight":276,"thumbnail":"https://cdn.hyperdev.com/drag-in-files.svg","thumbnailWidth":276,"thumbnailHeight":276,"dominantColor":"rgb(102, 153, 205)","uuid":"adSBq97hhhpFNUna"}
+{"name":"click-me.svg","date":"2016-10-23T16:17:49.954Z","url":"https://cdn.hyperdev.com/click-me.svg","type":"image/svg","size":7116,"imageWidth":276,"imageHeight":276,"thumbnail":"https://cdn.hyperdev.com/click-me.svg","thumbnailWidth":276,"thumbnailHeight":276,"dominantColor":"rgb(243, 185, 186)","uuid":"adSBq97hhhpFNUnb"}
+{"name":"paste-me.svg","date":"2016-10-24T16:17:49.954Z","url":"https://cdn.hyperdev.com/paste-me.svg","type":"image/svg","size":7242,"imageWidth":276,"imageHeight":276,"thumbnail":"https://cdn.hyperdev.com/paste-me.svg","thumbnailWidth":276,"thumbnailHeight":276,"dominantColor":"rgb(42, 179, 185)","uuid":"adSBq97hhhpFNUnc"}
+{"uuid":"adSBq97hhhpFNUna","deleted":true}
+{"uuid":"adSBq97hhhpFNUnb","deleted":true}
+{"uuid":"adSBq97hhhpFNUnc","deleted":true}

.glitch-assets

@@ -1,39 +1,64 @@
-# MLH Localhost: Building Scalable Apps w/ CockroachDB
+Startrek Quotes with CockroachDB
+================================
 
-This repositiory contains the sample code from the [MLH Localhost: Hacking
-with CockroachDB][3] workshop.
+Quotes are queried from CockroachDB and displayed every few seconds. 
+![preview](https://i.imgur.com/TiGjKH8.png)
 
-## Sample Code / Downloads
+Project on Glitch
+=================
 
- - Star Trek App - [Demo][4] / [Source][1] / [Download][2]
+Project can be found on Glitch at [https://checker-aries.glitch.me/](https://checker-aries.glitch.me)
 
-## License
+Troubleshooting
+===============
 
-Unless otherwise stated, the code in this repo is released under the MIT
-License.
+**Note:** if you open a Glitch console and `cockroach` is installed, the `cockroach` command will still not be found until you run `alias cockroach="~/.data/cockroach"`
+
+### Troubleshooting `BRB! Connecting to CockroachDB`
+
+This happens occassionally when the project has been running for a while. It may go to sleep. Simply reload the page and wait a few minutes while the project wakes up and restarts the DB process.
+
+If the app is really unresponsive, you may also go into the Glitch Console and type `sh cockroach.sh` to run the cockroachDB process manually. Hit `enter` to execute the DB process. You should see a bunch of output on the Glitch console.
+
+### App is still not responding and `EADDRINUSE :::3000` appears in the Glitch Log
+
+You have no choice but to kill the server.js process in the Glitch Console.
+![error](https://i.imgur.com/nzQsauv.png)
+
+* Go to the Glitch Console
+* Type `ps -ax` to see a list of all running processes.
+* Find the process `node server.js` and note the PID.
+* Finally, kill that process by running `kill [PID]`
+
+![kill](https://i.imgur.com/0u8U6qS.png)
+ 
+Don't worry about restarting the node server.js as Glitch will do this automatically. You may return to your project on Glitch IDE and check the log to ensure you have no issues.
+
+### Error: `bash: cockroach: command not found`
+
+If you attempt to enter one of the commands beginning with `cockroach` and get the error above, enter this in your terminal: 
+
+`alias cockroach="~/.data/cockroach"` then 
+
+`cockroach version`. If you see this: 
 
 ```
-Copyright (c) 2017 Major League Hacking, Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE
+Build Tag: v2.0.3
+Build Time: 2018/06/18 16:11:33
+Distribution: CCL
+Platform: linux amd64 (x86_64-unknown-linux-gnu)
+Go Version: go1.10
+C Compiler: gcc 6.3.0
+Build SHA-1: 91715a9a95edbe716912173204fa4c0fc6724457
+Build Type: release
 ```
-[1]: https://github.com/MLH/mlh-localhost-cockroachdb
-[2]: https://github.com/MLH/mlh-localhost-cockroachdb/archive/master.zip
-[3]: https://localhost.mlh.io/activities/intro-to-cockroachdb/
-[4]: http://mlhlocal.host/cockroachdb-demo
+
+you have fixed the error. 
+
+### See CockroachDB information instead of the app
+
+If someone sees information about `cockroachdb` instead of the quotes interface, they probably started the database incorrectly somehow. Quit the database using `cockroach quit --insecure --port=26257` (or whatever port number is required) and start it again.
+
+### Running out of space
+
+This only occured once during testing, but sometimes CockroachDB can run out of space on Glitch. In this case, remove the files `cockroach-data`, `mlh-node1` and `mlh-node2`. Then restart and refill the databases.

README.md

@@ -1,6 +1,6 @@
 // Connect to the startrek Database on a node in our CockroachDB cluster
 var pg = require('pg');
-var config = { user: 'root', database: 'startrek', port: 26257 };
+var config = { user: 'root', database: 'startrek', port: 26257 }; //26257
 var db = new pg.Pool(config);
 
 // Log when we connect to the CockroachDB node

db.js

@@ -0,0 +1,22 @@
+#!/bin/bash
+### These lines implement the basic cockraochdb install
+### https://www.cockroachlabs.com/docs/build-a-nodejs-app-with-cockroachdb.html
+cd ~/.data
+
+# Download and extract the latest binary
+if [ ! -f ~/.data/cockroach ]; then
+ echo "Installing CockroachDB"
+ wget -N https://binaries.cockroachdb.com/cockroach-latest.linux-amd64.tgz
+ tar xvf cockroach-latest.linux-amd64.tgz --transform 's!^[^/]\+\($\|/\)!cockroach-latest.linux-amd64\1!'
+ mv ~/.data/cockroach-latest.linux-amd64/cockroach ~/.data
+ rm cockroach-latest.linux-amd64.tgz
+ rm -rf ./cockroach-latest.linux-amd64
+ rm -rf .wget-hsts
+
+ # Instead of following instrutions and copying cockroach to /usr/bin,
+ # Let's set up an alias. This avoids needing to escalation permissions.
+ echo 'alias cockroach="~/.data/cockroach"' >> ~/.bash_profile
+ source ~/.bash_profile
+else
+ echo "CockroachDB is already installed"
+fi

install_cockroachdb.sh

@@ -2,9 +2,9 @@
  "name": "mlh-localhost-cockroach",
  "version": "0.0.1",
  "description": "The sample app to accompany the MLH Localhost: Building Scalable Apps with CockroachDB Workshop.",
- "main": "server.js",
  "scripts": {
- "test": "echo \"Error: no test specified\" && exit 1"
+ "test": "echo \"Error: no test specified\" && exit 1",
+ "start": "node server.js"
  },
  "repository": {
  "type": "git",
@@ -23,7 +23,7 @@
  },
  "homepage": "https://github.com/MLH/mlh-localhost-cockroachdb#readme",
  "dependencies": {
- "express": "^4.15.3",
- "pg": "^6.2.2"
+ "express": "^4.16.3",
+ "pg": "^7.4.3"
  }
-}
+}

package.json

@@ -0,0 +1,56 @@
+### This file handles the cockroachdb provisioning and configuration.
+### We'll rerun it continuously, so try to keep its items idempotent and speedy-enough.
+
+
+sh ~/install_cockroachdb.sh
+
+# setup an alias for easy command execution
+alias cockroach="~/.data/cockroach"
+
+# remove the preexisting environment so that we run fresh.
+# (this deletes all the DB data, so we can repeat our assorted creation scripts.)
+cockroach quit --insecure
+rm -rf hello*
+
+### Now, onward to start up the cluster!
+### https://www.cockroachlabs.com/docs/build-a-nodejs-app-with-cockroachdb.html
+
+
+# Start node 1:
+cockroach start --insecure \
+--store=hello-1 \
+--host=localhost \
+--background
+
+# Start node 2:
+cockroach start --insecure \
+--store=mlh-node2 \
+--host=localhost \
+--port=26258 \
+--http-port=8081 \
+--join=localhost:26257 \
+--background
+
+# # Start node 3:
+# cockroach start --insecure \
+# --store=mlh-node3 \
+# --host=localhost \
+# --port=26259 \
+# --http-port=8082 \
+# --join=localhost:26257 \
+# --background
+
+
+# Create a user (optional for this exercise)
+# cockroach user set maxroach --insecure
+
+# Create DB and priviledges
+cockroach gen example-data startrek | cockroach sql --insecure
+
+# Check on the nodes
+cockroach node ls --insecure
+
+# Glitch will run this script in a loop, 
+# so sleep for a bit to stablize the refresh rate of the site.
+# This could be upgraded by monitoring the cockroach processes instead.
+sleep 1m