Giter VIP home page Giter VIP logo

plattr's Introduction

Plattr

Isn't fancy or interesting or even really a proper project. It's just a Vagrant config that can/should allow everyone associated with TAPAS development to work from a preconfigured box. Currently a work in progress.

Installation Instructions

  1. Ensure that you have the correct versions of Vagrant and VirtualBox on your machine. Vagrant can be downloaded here and Virtualbox can be downloaded here. Use Vagrant 1.7.2 and VirtualBox 4.3.28. While other versions should work, note that they may introduce bugs. Flux w/r/t VirtualBox versions seems to be especially bad for this.
    • For a significant speed increase during vagrant creation, install the vagrant-cachier plugin. Documentation here. The command is vagrant plugin install vagrant-cachier
  2. Clone the repository down: git clone https://github.com/neu-dsg/plattr.git
  3. Ensure that within the plattr directory, you create a requirements/local directory
  4. Clone the tapas_rails repository down: git clone https://github.com/neu-dsg/tapas_rails.git
    • For a significant speed increase during vagrant up, run bundle package from inside the tapas_rails directory. This will cache the gems specified by the project Gemfile into vendor/cache and eliminate the need to dl them from inside your Vagrant box. Note that you need to have ruby installed and the bundler gem available for this to do anything.
  5. Ensure that whichever directory you intend to share the built Drupal site to (defaults to ~/tapas-drupal) exists on your host system.
  6. There is one file not in VC that is required for the project to run. Ask me (@jbuckle) for the application.yml file and then place it at ~/tapas_rails/config/
  7. CD into the root directory of the project and run vagrant up. Be patient - installation takes time.
  8. Type vagrant ssh and you should be ssh'd directly into the machine. Since none of the components talk to each other (yet) this is everything you need to do. Do note that the Rails server isn't actually running, and that if you need it for anything you'll need to go start it. The tapas project should be accessible from your machine's browser at localhost:8080.

Startup options

Passing environmental variables to the vagrant up command allows for configuration of the final build. To do this, prepend the desired environmental variable to the command like so: SOME_ENV=value vagrant up.

Currently, there is only one supported option:

  • BUILDTAPAS_BRANCH: Passing this to the script will alter which branch of the buildtapas project is used to construct the site. This currently defaults to the develop branch and can be set in your custom configuration options with the key 'buildtapas_branch.'

Then see http://github.com/NEU-DSG/tapas/wiki/Running-tapas,-tapas-rails,-and-eXist-in-the-development-environment

Hungry for more TAPAS?

TAPAS website

TAPAS public documents, documentation, and meeting notes on GitHub

TAPAS webapp (Drupal) on GitHub

TAPAS Hydra Head on GitHub

TAPAS virtual machine provisioning on GitHub

plattr's People

Contributors

jbuckle avatar amclark42 avatar lindajeanne avatar elizoller avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.