2. Prerequisites

Workshop prerequisites

This workshop requires several dependencies and works best with a little bit of additional setup. If you plan to take this workshop in advance of Geo4Lib2020 (or another event), you may want to come with these elements installed and these steps completed. For Geo4Lib attendees, we will spend some time in the workshop making sure that everyone is able to install the dependencies correctly. However, if possible you are encouraged to install these before the workshop.

These dependencies and instructions assume that one is using MacOS.

Required accounts

• Participants will need to create a GitHub username and share it with the organizers
• Establish your GitHub username, email, and password, so you can commit directly to the project. For instructions, visit https://help.github.com/en/github/using-git/setting-your-username-in-git
• If you don't want to create ssh keys, please create a personal access token by following https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line

Software Dependencies

In order to run the test app in this workshop:

• Install a text editor of your choice (we recommend https://code.visualstudio.com/)

Option 1

• Install Docker https://docs.docker.com/docker-for-mac/install/

• git clone https://github.com/geoblacklight/workshop-app-2020.git

• git clone https://github.com/geoblacklight/gblstack.git

• cd gblstack

  • On MacOS

  • echo "export PATH=\$PATH:$(pwd)/bin" >> ~/.bash_profile

  • source ~/.bash_profile

  • On Linux

  • echo "export PATH=\$PATH:$(pwd)/bin" >> ~/.profile

  • source ~/.profile

Option 2

• Install Homebrew https://brew.sh
• Install RVM https://rvm.io/rvm/install
• rvm install ruby-2.5.7
• brew install yarn
• git clone https://github.com/geoblacklight/workshop-app-2020.git
• cd workshop-app-2020
• gem install bundler
• bundle install
• bin/rails db:migrate RAILS_ENV=development