The recognition of Identity is an often misunderstood concept in our Democracy.
These dependencies are not required when using docker.
- Ruby 2.3.0 (try rbenv or rvm)
- Postgresql (
brew install postgresqlorapt-get install postgresql) - Redis 2.8+
- Node.js v4.4.x
The easiest way to install the dependencies on a Mac is to run the Laptop script.
Make sure Postgres and Redis are running. For example, on OS X:
$ brew services start redis postgres
Run the following command to set up the environment:
$ bin/setup
This basically runs Bundler to install the required gems and sets up the database. If that is successful you can run the app server with:
$ foreman start
Install Docker Compose
- On non-linux systems this will involve installing Docker Toolbox and starting a Docker Machine VM.
Copy the sample configuration files:
$ bin/setup --docker
Build/download the container images:
$ docker-compose build
Start the app:
$ docker-compose up -d
Setup the database:
$ docker-compose run --rm web rake db:setup RAILS_ENV=development
$ docker-compose run --rm web rake db:setup RAILS_ENV=test
Once the docker images are up and running the app should be accessible
at http://localhost:3000/. Email messages will be visible in mail catcher
at http://localhost:1080/. On non-linux platforms localhost will need
to be replaced with the IP address of your Docker Machine VM.
More useful docker-compose commands:
- Stop this running container:
docker-compose stop - Stop and delete the containers:
docker-compose down - Open a shell in the web container:
docker-compose run --rm web bash
See the Docker Compose docs for more information.
To run all the tests:
$ bundle exec rspec --require rails_helper
See RSpec docs for more information.
We currently run dev and qa environments at https://upaya-idp-dev.18f.gov and https://upaya-idp-qa.18f.gov. Core developers can deploy to those hosts with Capistrano using the following command:
cap <env/stage> deploy
You will need to provide a copy of your SSH public key and you may need to provide your IP address if you are not in a GSA building or on the GSA VPN. Post a message in the slack channel if you need help.
Notice: This project is still in alpha.
"skill in means" https://en.wikipedia.org/wiki/Upaya
