Setup

First Time

1. Install git and brew

2. brew tap caskroom/cask

3. brew cask install virtualbox

4. brew install docker docker-machine docker-compose

5. Fork https://github.com/coderdojochi/coderdojochi

6. git clone http://github.com/USERNAME/coderdojochi

7. cd coderdojochi

8. git remote add upstream https://github.com/CoderDojoChi/coderdojochi

9. docker-machine create --driver virtualbox coderdojochi (takes 1 minute)

10. docker-machine start coderdojochi

11. eval "$(docker-machine env coderdojochi)"

12. docker-compose up (for the first time, depending on your PC, it'll take 5-10 minutes)

Following times

1. docker-machine start coderdojochi

2. eval "$(docker-machine env coderdojochi)"

3. docker-compose up

4. To get the URL for your local instance: docker-machine ip coderdojochi

Fetch latest code from CoderDojoChi repository

To grab the latest code from the upstream (main) repo, do the following:

git fetch upstream && git checkout develop && git merge upstream/develop

Beginning of each day

1. In terminal, traverse into project folder.

cd /PATH/TO/coderdojochi/

2. If starting a new task (new feature, new issue, etc.), make sure you are on the develop branch.

git checkout develop

3. Update your local repository with the upstream develop branch to make sure you are up to date.

git fetch upstream
git merge upstream/develop develop
git push -u origin develop

4. Create a new branch based off of the now up-to-date develop branch to work off of.

git checkout -b feature/a-good-name develop

5. HACK. commit. HACK. commit. HACK. commit.
6. When done, push to your repo (remote), and create a pull request

git push origin feature/a-good-name

Misc commands

Rebuild docker container from scratch

docker kill $(docker ps -q); docker-compose rm -f; docker-compose build && docker-compose up

Run Django management commands

docker-compose run --rm app python manage.py <command>

Make migrations

docker-compose run --rm app python manage.py makemigrations

Run migrations

docker-compose run --rm app python manage.py migrate coderdojochi

Getting Started

Once the app is running (you'll see app_1 | Installed X object(s) from X fixture(s)), load up the browser and go to 192.168.99.100.

To log into the admin, click the menu item 'My Dojo'.

Admin

username: [email protected] password: admin

Guardian

username: [email protected] password: guardian