Skip to content
This repository has been archived by the owner on Mar 21, 2024. It is now read-only.
/ gameon Public archive

The root repository provides mechanics to set up a local environment for building and testing rooms.

License

Notifications You must be signed in to change notification settings

gameontext/gameon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gameon: The Root Repository / Quick start developers guide.

Discord

This is the TL;DR version.

For more details/background/links, see:

Local Room Development

  1. Obtain the source for this repository:
  • HTTPS: git clone https://github.com/gameontext/gameon.git
  • SSH: git clone git@github.com:gameontext/gameon.git
  1. Change to the gameon directory

    $ cd gameon                  # cd into the project directory
  2. (Optional / Docker Compose only) Use Vagrant for your development environment

    1. Install Vagrant
    2. vagrant up (likely with --provider=virtualbox)
    3. vagrant ssh
    4. use pwd to ensure you're in the /vagrant directory.
    • Notes:
      • the Vagrantfile updates the .bashrc for the vagrant user to set DOCKER_MACHINE_NAME=vagrant to tweak script behavior for use with vagrant.
      • VM provisioning will perform the next two (applicable) steps on your behalf.
  3. (Kubernetes only) Create or retrieve credentials for your cluster.

  4. Set up required keystores and environment variables. This step also pulls the initial images required for running the system.

    $ ./go-admin.sh choose       # choose Docker Compose or Kubernetes
    $ eval $(./go-admin.sh env)  # set aliases for admin scripts
    $ alias go-run               # confirm path  (docker or kubernetes)
    $ go-admin setup

    Note: it is safe to run setup again, e.g. to check dependencies or regenerate files if IP addresses change

  5. Start the game (supporting platform and core services):

    $ go-admin up

    Note: Services in Kubernetes will start in the gameon-system namespace, which will need to be specified on the command line: kubectl -n gameon-system .... A shortcut for this has been created in the go-run script: go-run k get all, for example. A similar shortcut exists for istioctl: go-run i get all. For more details on Game On! and Kubernetes, see the Kubernetes README

  6. Wait for the game to start. This will vary between Docker Compose and Kubernetes approaches. The result of go-admin up will tell you what to try next.

  7. Carry on with building your rooms!

  8. Stop / Clean up

    $ go-admin down

Core Service Development (Optional)

If you want to contribute to the game's core services, no worries! Assuming you've performed the steps above at least once (and using the map service as an example):

  1. Change to the gameon directory, set aliases to save typing

    $ cd gameon                  # cd into the project directory
    $ eval $(./go-admin.sh env)  # set aliases for admin scripts
    $ alias go-run               # confirm path  (docker or kubernetes)
  2. Obtain the source for the project that you want to change. The easiest way is to take advantage of git submodules.

    $ git submodule init map
    $ git submodule update map

Updating the game environment once you've made changes varies by deployment:


Notes

Supporting 3rd party auth

3rd party authentication (twitter, github, etc.) will not work locally, but the anonymous/dummy user will. If you want to test with one of the 3rd party authentication providers, you'll need to set up your own tokens to do so.

  • Docker: ./docker/gameon.env
  • Kubernetes (files present after setup):
    • ./kubernetes/kubectl/configmap.yaml
    • Using helm: ./kubernetes/chart/gameon-system/values.yaml

Contributing

Want to help! Pile On!

Contributing to Game On!