For the current work relating to this project, please visit https://github.com/18f/myusa.
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-OCSIT/mygov-account.git
4. bundle install
Change into the directory (it would be 'cd mygov' 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/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
That should be it! You are ready to develop.
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:
rails server
You can also do:
rails s
('s' is short for server).
Then, open your favorite web browser (if your favorite web browser is not Chrome, reexamine your life) and visit:
http://localhost:3000/
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:
http://blog.hasmanythrough.com/2008/12/18/agile-git-and-the-story-branch-pattern