Development Environment Setup

1. Install and run the latest stable version of Redis. The redis.conf file included in the Redis distribution is suitable for development.

2. Download and install Go at https://golang.org/dl/

3. Download and install Cloud SDK at https://cloud.google.com/sdk/docs/

4. (Optionally) Generate a new GitHub personal access token with public_repo scope.

5. Get the source code:

    $ git clone https://go.googlesource.com/gddo $GOPATH/src/github.com/golang/gddo
   

6. Start Redis:

    $ redis-server
   

7. Run the server:

    $ cd $GOPATH/src/github.com/golang/gddo/gddo-server && \
          go build && \
          GITHUB_TOKEN=xyzzy123 ./gddo-server
   

8. Browse to http://localhost:8080/github.com/golang/gddo/gddo-server

If you want to work on a fork of the server code, clone your forked repo to $GOPATH/src/github.com/golang/gddo and work from there. Do not use 'go get' to get your fork. Internal package references and the default path for assets assume that the code is located at $GOPATH/src/github.com/golang/gddo.

To run the gddo-server binary outside of a development environment with the source in $GOPATH/src/github.com/golang/gddo, you will need a copy of the assets directory. Use the gddo-server --assets command line flag to specify the location of the directory.