Game On! is both a sample microservices application, and a throwback text adventure brought to you by the WASdev team at IBM. This application demonstrates how microservice architectures work from two points of view:

1. As a Player: navigate through a network/maze of rooms, where rooms are provided by autonomous microservice. Each room supports chat, and may provide interaction with items (some of which may be in the room, some of which might be separately defined services as well).
2. As a Developer: learn about microservice architectures and their supporting infrastructure by creating your own microservices to extend the game.

You can learn more about Game On! at http://game-on.org/.

This walkthrough will guide you through creating and deploying a microservice that adds a simple room to the running Game On! microservices application. You will be shown how to setup a room that is implemented in the Java programming language using Websphere Liberty and deployed as a Cloud Foundry application in Bluemix.

When deployed using an instant runtime, Gameon-room-java requires the following:

• Bluemix account
• IBM DevOps Services Account
• GitHub account
• Maven
• Java 8: Any compliant JVM should work.
  • Java 8 JDK from Oracle
  • Java 8 JDK from IBM (AIX, Linux, z/OS, IBM i),
    or Download a Liberty server package that contains the IBM JDK (Windows, Linux)

Sign up for Bluemix at https://console.ng.bluemix.net and DevOps Services at https://hub.jazz.net. When you sign up, you'll create an IBM ID, create an alias, and register with Bluemix.

• Make a note of your username and org, as you will need both later.
  • By default, the space is dev and the org is the project creator's user name. For example, if [email protected] signs in to Bluemix for the first time, the active space is dev and the org is [email protected].

For a new room to register with the Game-On application, you must first log in to game-on.org and sign in using one of several methods to get your Game On! ID and Shared Secret.

1. Go to https://game-on.org/ and click Enter.
2. Select an authentication method to log in with your username and password for that type.
3. If you've never played before, you'll need to choose a display name and favorite color, and click Done
4. Once you are in First room, view your user profile using the link in the top right. It is either your username or a person icon.
5. You should now see your Game On! ID and Shared Secret near the middle of the page.

The source code is located in GitHub, navigate to our repository and download the ZIP file and unzip the code on to your local machine. Alternatively you can use the GitHub CLI to clone the repository with git clone https://github.com/cfsworkload/gameon-room-java.git.

1. cd gameon-room-java
2. mvn install After running this, you will have the server running locally at http://localhost:9080/. You can use a browser extension to play with the WebSocket according to the Game On! WebSocket protocol.

Use mvn clean -P stopServer to stop the server.

3. Use a maven target profile to push the app to Bluemix:

mvn install -P bluemix \
    -Dcf.org=<your organization> \
    -Dcf.username=<your username> \
    -Dcf.password=<your password> \
    -Dapp.name=<cf-app-name> \
    -Dgameon.id=<Your Game On! ID> \
    -Dgameon.secret=<Your Game On! Shared Secret>

• app.name is a unique, URL-friendly name for your deployed Bluemix app.
• gameon.id and gameon.secret are those retrieved earlier.
• Advanced: if you have an existing Bluemix account or require different Bluemix settings, you can set them on the command line. The default values that are applied:
  • cf.space=dev
  • Note values go in pairs for target and context:
    • London (default):
      • cf.context=eu-gb.mybluemix.net
      • cf.target=https://api.eu-gb.bluemix.net
    • US South:
      • -Dcf.target=https://api.ng.bluemix.net
      • -Dcf.context=mybluemix.net

Once the room is set up and it has registered with Game On!, it will be accessible on Game On!. It may take a moment for the room to appear.

1. Log in to Game On! using the authentication method you used to create your user ID and shared secret for the registered room.
2. Use the Game On! command /listmyrooms from The First Room, to see your list of rooms. Once your room is registered, it will appear in that list.
3. To get to your room, navigate through the network or go directly there by using the /teleport command from The First Room.
4. Look at the Bluemix log console to see "A new connection has been made to the room"

Congratulations, you've deployed a microservice that extended an existing microservices-based application so that it can do something new.

Suggested activities:

• Make it more resilient -- add additional instances using the autoscaling add-on: https://console.ng.bluemix.net/catalog/services/auto-scaling
• Consider how to allow chat messages to propagate between independent instances using a shared datastore or cache, or an event bus, or...

The Game On! host provides a set a universal commands:

• /exits - List of all exits from the current room.
• /help - List of all available commands for the current room.
• /sos - Go back to The First Room.

The First Room is usually where new users will start in Game On!. From there, additional commands are available and maintained by Game On!. For the list of current commands use the /help command.

To start adding your own commands to the room you can extend the processCommands() method. This branch shows an example of adding a /hello command that causes the room to print out "Hello World!".