Project to run the whole ggtracker stack in vagrant
git submodule update --init --remote --recursive
to pull the latest version of each submodulevagrant up
to create the virtual box. This will download all required packages and go through the installation process for ggtracker and ESDB (~15 minutes; go make yourself a sandwich)vagrant ssh
to ssh into the vagrant boxcd /vagrant
(cd esdb && foreman start)
(cd ggtracker && ESDB_HOST=172.28.128.3:9292 foreman start)
(change IP accordingly)esdb/config/s3.yml
and ggtracker/config/s3.yml
. All buckets need to be publicly readable and the replay bucket needs to have CORS enabled for GET, PUT and POST.The components needed to run ggtracker.com are included in this project as submodules. We generally track the master
branch of the official repos, except for sc2reader, which tracks the upstream
branch.
ggtracker
, esdb
and ggpyjobs
To make a change to ggtracker
, esdb
or ggpyjobs
and testing that they work in your local setup, we recommended that you fork the component to your own github account and add the fork to your working copy of ggtrackerstack like this (using esdb
forked to nickelsen
as example):
git remote set-url origin git@github.com:nickelsen/esdb.git
.git remote add upstream git@github.com:dsjoerg/esdb.git
.git remote -v
- should look like this (with your account instead of nickelsen).
origin git@github.com:nickelsen/esdb.git (fetch)
origin git@github.com:nickelsen/esdb.git (push)
upstream git@github.com:dsjoerg/esdb.git (fetch)
upstream git@github.com:dsjoerg/esdb.git (push)
git checkout -b <branch-with-fix>
), make your application changes, commit and push to your remote and create a pull-request against the official repo.ggpyjobs
, you need to also make a pull-request to esdb
to make esdb
actually use your new and improved version of ggpyjobs
(we'll hopefully automate this remote tracking at some point).git fetch upstream
git merge upstream/master
master
branch to the master
branch of the upstream
like this:
git checkout master
git fetch upstream
git merge upstream/master
git push origin master
sc2reader
Per default, sc2reader
is managed by requirements.txt in ggpyjobs
. To work on sc2reader
it is recommended to use the cloned submodule at the root of ggtrackerstack
and install that in development mode on the vagrant box by issuing python setup.py develop
in /vagrant/sc2reader
after ssh'ing into the vagrant box. Forks and branches are managed as described above.