Skip to content

A vagrant for working on the 4545 league software

License

Notifications You must be signed in to change notification settings

glbert-does/4545vagrant

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

4545vagrant

Support creating a local development environment for the Lichess4545 league website and slack bot.

local repo setup

Clone this repository, then git clone both your chesster fork and your heltour fork into the top-level-directory of this repository ensuring the directory names are: Chesster and heltour

You will need a few .env files in order to run this. If you are a 45+45 developer please contact lakinwecker on the slack for testing .env files. If you are another developer you will need to make your own slack testing instance and setup the bot integrations on your own.

environment setup

Note: if you are developing on a Windows machine working with VirtualBox and Vagrant:

  • You may need to install the vagrant-vbguest plugin: vagrant plugin install vagrant-vbguest
  • Make sure git is not using CRLF for line endings: git config --global core.autocrlf false

Once the .env files are in place, run vagrant up

If this completes appropriately, you will have a testing database for heltour, and appropriate keys in place to just run heltour/chesster for simple development.

You many need to update the database:

vagrant ssh
source heltour-env/bin/activate
cd heltour
python manage.py migrate

running the environment

Open two different terminals. Then in one of them run:

vagrant ssh
source heltour-env/bin/activate
cd heltour
fab runserver

When that is started, In the other run:

vagrant ssh
cd Chesster
yarn run start

To enable the usage of the lichess API by heltour, open a third terminal and run:

vagrant ssh
source heltour-env/bin/activate
cd heltour
fab runapiworker

If you need celery (i.e. tasks from heltour/tournament/tasks.py), open yet another terminal and run:

vagrant ssh
./heltour-env/bin/celery -A heltour worker -B -c 4 --loglevel=INFO -Ofair

The website will be available at localhost:8000

Work on heltour/chesster out of those directories and commit/push like you normally would.

When you're done working run:

vagrant halt

later on to start working again run:

vagrant up

then follow the instructions above to run Chesster / heltour.

video setup introduction

This video gives an introduction to both heltour and Chesster for developers: https://www.youtube.com/watch?v=zCt91lDLvOM

About

A vagrant for working on the 4545 league software

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%