Getting Started for Developers - GrowersNation/GrowersNationSite GitHub Wiki

Grower's Nation Site (GNS) is a Java web application built using Maven 3 using the Dropwizard framework. It is a client application for the Grower's Nation Platform.

Initial build and start for latest release candidate (develop-SNAPSHOT)

Clone the develop branch, which contains the latest available production release candidate, then navigate to the top level of the project and execute the following command:

mvn clean install

This will trigger a fairly significant build process if it's the first Maven build on your system. You might want to grab a coffee. Once the build completes successfully, you can issue the following command:

java -jar site-develop-SNAPSHOT.jar server gns.yml

This will start the Growers' Nation Site application. You should see no exceptions on startup, and a large banner message. Afterwards, you will get a nice HTML user interface by navigating to:

http://localhost:9090

You should see the website homepage and have the opportunity to navigate around the site.

Running the release candidate on a server

If you are running this on a server, you will probably want to have a git repo present that can be used to pull in changes from this origin. There is a handy script build-and-deploy.sh that will do all the necessary operations to have the earlier release candiate (site-develop-SNAPSHOT.jar) process killed and the new code built through Maven. Once complete the new code is deployed as a nohup.

Starting the latest release

This is the same as for the release candidate, but uses the master branch.

Account credentials are through OpenID

To login you will need to have an OpenID account somewhere.

Deployment through a git push

If you have access to the Growers' Nation servers you will be able to deploy an update via a git push to the server repo and perform a Maven build on the server. This is generally faster than attempting to push a final artifact.