Imagine you are building an online game application. In your application, users can follow other players as a way to make friends, track their progress, and find opponents to play against. Users can also indicate different interests they have as a way to find people with similar interests.

As part of your application, you want to generate recommendations of people that users should follow. These recommendations should be intelligent based on the existing interests and friends that a user has.

In this lab, you learn how to use Amazon Neptune to store user connections and to recommend new connections for users. A graph-based database is perfect for this use case as you can analyze existing connections in a graph to identify high-value missing connections.

In Module 1, you configure your environment and download the code that you use during the lab.

Time to Complete Module: 20 Minutes

 


  • Step 1: Create an AWS account

    Use a personal AWS account or create a new AWS account for this lab. Do not use an organizational account so that you have full access to the necessary services and do not leave behind any resources from the lab. If you do not delete the resources used in this lab when you are finished, you may incur AWS charges.

  • Step 2: Set up your AWS Cloud9 IDE

    AWS Cloud9 is a cloud-based integrated development environment (IDE) that lets you write, run, and debug code with just a browser. AWS Cloud9 includes a code editor, debugger, and terminal. It also comes prepackaged with essential tools for popular programming languages and the AWS Command Line Interface (CLI) preinstalled so that you don’t have to install files or configure your laptop for this lab. Your AWS Cloud9 environment will have access to the same AWS resources as the user with which you signed in to the AWS Management Console.

    To set up your AWS Cloud9 development environment:

    1. Navigate to the AWS Management Console, choose Services at the top of the page, and then choose Cloud9 under Developer Tools.
    2. Choose Create environment.
    3. Type User Recommendations in the Name box. Leave the Description box empty.
    4. Choose Next step.
    5. Leave the Environment settings at their defaults to create a new t2.micro EC2 instance, which will be hibernated after 30 minutes of inactivity.
    6. Choose Next step.
    7. Review the environment name and settings, and choose Create environment. Your environment will be provisioned and prepared after several minutes.
    8. When the environment is ready, your IDE should open with a welcome note.

    You should now see your AWS Cloud9 environment. You need to be familiar with the three areas of the AWS Cloud9 console shown in the following screenshot:

    • File explorer: On the left side of the IDE, the file explorer shows a list of the files in your directory.
    • File editor: On the upper right area of the IDE, the file editor is where you view and edit files that you’ve selected in the file explorer.
    • Terminal: On the lower right area of the IDE, this is where you run commands to execute code samples.
    friend-rec-cloud9

    (Click to enlarge)

    friend-rec-cloud9
  • Step 3: Download the supporting code

    In this lab, you use JavaScript to interact with your Amazon Neptune database and with other AWS services. Run the following commands in your AWS Cloud9 terminal to download and unpack the module code.

    cd ~/environment
    curl -sL http://d118jxrmrxsq90.cloudfront.net/recommendations.tar | tar -xv

    Run the following command in your AWS Cloud9 terminal to view your directories.

    ls

    You should see two directories in the AWS Cloud9 file explorer:

    • application: The application directory contains example code for the recommendation application. This code is similar to the code you would have in your real recommendation application backend.
    • scripts: The scripts directory contains administrator-level scripts, such as for creating AWS resources or loading data into your database.

    Run the following command in your AWS Cloud9 terminal to install the dependencies for both directories.

    npm install --prefix scripts/ && npm install --prefix application

    Run the following command in your AWS Cloud9 terminal to set your AWS Region in an environment file. This example uses us-east-1, but enter your AWS Region of choice to use for the lab.

    echo "export AWS_REGION=us-east-1" >> env.sh && source env.sh

    You use the env.sh file to store environment variables of resources and other parameters you need in this lab. If you take a break during this lab and then start a new session in your AWS Cloud9 environment, be sure to reload your environment variables by executing the following command in your terminal:

    source env.sh

In this module, you learned about the example application you build in this lab. You also set up an AWS account and configured an AWS Cloud9 instance.

You are now ready to start the lab. In the next module, you provision your Amazon Neptune database.