MyUSA is a platform for citizen identity.
To get your Rails development environment setup, here's the steps to follow. We assume that you have MySQL installed. If you don't, Google it and figure it out. We also assume you have git installed, if you don't, install it here: https://help.github.com/articles/set-up-git
1. Install RVM curl -L https://get.rvm.io | bash -s stable --ruby Note: you may need to have previously installed MacPorts/Homebrew and other dependencies for rvm/ruby (on OS X at least) prior to running this command 2. Install the Ruby 1.9.3 rvm instance rvm install ruby-1.9.3 3. Clone the mygov project In some directory where you want to store your development files, do the following: git clone https://github.com/GSA/mygov-account.git 4. bundle install Change into the directory (it would be 'cd mygov-account' from wherever you executed the above command) and do the following: bundle install Note: MySQL must be previously installed for the mysql gem install to work 5. Create your configuration files cp config/database.yml.example config/database.yml cp config/twilio.yml.example config/twilio.yml cp config/resque.yml.example config/resque.yml cp config/initializers/01_mygov.rb.example config/initializers/01_mygov.rb (check these configuration files to ensure they look correct for your environment) rake secret (copy the result of the above rake command to the RAILS_SECRET_TOKEN variable in config/initializers/01_mygov.rb) 6. Create the development and test databases Make sure you have MySQL running. By default, the development environment looks to connect to MySQL using the root MySQL user with no password. bundle exec rake db:create bundle exec rake db:schema:load bundle exec rake db:create RAILS_ENV=test bundle exec rake db:schema:load RAILS_ENV=test Seed the development database bundle exec rake db:seed
That should be it! You are ready to develop.
Running the app locally
Make sure you have MySQL running. By default, the development environment looks to connect to MySQL using the root MySQL user with no password.
From the command line in the Rails root, do the following:
You can also do:
('s' is short for server).
Then, open your favorite web browser (if your favorite web browser is not Chrome, reexamine your life) and visit:
Hopefully you now have the site running. However, to be practical, you must perform one additional step with the current code base. You need to approve yourself as a user. Utilize the site to sign up with an email that you want to use. Click on the confirmation link presented to you. Then execute in MySQL in the mygov_development database:
update beta_signups set is_approved = 1 where id=1;
(assuming that you are id # 1 in the beta_signups table.)
That's it! Use the app just as you would any other web application.
Check out the Rails documentation for information regarding creating models, controllers, views, etc.
Before developing a new feature, it's a good idea to check out a branch to do all your work in:
git checkout -b myfeature
When you're done developing something, make sure all the tests still pass by doing the following (from the Rails root):
bundle exec rake spec
If specific tests are failing and you want to save time and zero in on just those tests, do:
bundle exec rspec spec/models/model_name.rb
When you have finished working on a feature, make your commit locally with git:
git add <your files> git commit -m"My commit message"
If you did the right thing and did your work in a branch, you should rebase on master after you commit, and then merge your changes into master:
git checkout master git pull origin master git checkout myfeature git rebase -i master (squish if you want; it's a good idea) git checkout master git merge myfeature
Then push your commit up to the github server so other developers can pull it down:
git push origin master
If you're really done with your feature, clean up your local branch:
git branch -d myfeature
For more information on how to properly develop with git and feature branches, see: