Events@Penn is a events aggregation website built by the web team at The Daily Pennsylvanian.
Ruby on Rails
This application requires:
- Ruby 2.4.0
- Rails 5.1.1
Make sure you have Ruby installed by running
ruby -v on the command line. This project requires v2.4.0, so make sure you have at least that version. If the command returns
"ruby: command not found", run
brew install ruby (see here if you're using anything other than MacOS).
Clone the repo into whichever folder you keep your DP work in.
git clone firstname.lastname@example.org:dailypenn/eventsatpenn.git
Move to the
eventsatpenn root folder and run
bundle install to install all of the gem dependencies for this project. This may take a minute.
You'll have to specify that you're working in the development environment. To do this, run the following command:
This will specify to the database to use SQLite, which we use for development, rather than MySQL, which we use for production.
You'll also need to set the keys and Facebook secrets as environment variables. See secrets.yml for which ones you need to set. These are in the Events@Penn Dev app on Facebook. Ask the Director of Web Development if you need to be added to the app!
rake db:create, and
rake db:migrate to clear and set up the database tables. Run
rails s, and go to
localhost:3000 in your browser of choice to see the app!
Events@Penn uses Capistrano to deploy to a server on Google Cloud. You can
read more here about how
Capistrano works, but at a high level, it uses SSH to deploy files to a remote
server and run commands as defined in the
- Download the
dp_master_rsapublic and private keys. They can be found on Google Drive, or ask someone for them. Put them in your
- Edit (or create, if you don't currently have one), a
~/.ssh/configfile. Add the following line:
Host eventsatpenn.com IdentityFile ~/.ssh/dp_master_rsa
cap production deploy. This will use the
production.rbconfiguration file to deploy the app to our production server.
Capistrano deploys the app to a folder called
html in the
rails user's home
folder. This folder is symlinked to
/var/www/html, which nginx serves. Capistrano
then restarts puma, the webserver, and nginx, the reverse proxy.
Built by the web development team at The Daily Pennsylvanian.