Skip to content

01-setup-app-local.md

Latest commit

 

History

History
95 lines (60 loc) · 3.64 KB

01-setup-app-local.md

File metadata and controls

95 lines (60 loc) · 3.64 KB
Raw

Initial Setup and Running App on Local Machine(Jumpbox)

Work Environment

There are two environments you will be working in for the exercises today.

  1. Jumpbox: The apps and containers must be run on a Linux machine. Use your newly created Jumpbox for this exercise.

    Note: If you have bash or ssh available on your machine, it is easiest to access the jump box via SSH. Otherwise, RDP is required.

  2. Azure Cloud Shell: The Azure Cloud Shell will be accessed by logging into the Azure Portal (http://portal.azure.com).

#f03c15 Labs 1 and 2 require the Jumpbox. The subsequent labs can either be done in the Azure Cloud Shell or Jumpbox. Stick to either Jumpbox or Cloud Shell. Do not use both of them.

Clone Lab Github Repo

Once you have accessed the jumpbox, you must clone the workshop repo to the machine.

  1. Start with a terminal on the jumpbox

  2. Clone the Github repo via the command line

    git clone https://github.com/Azure/blackbelt-aks-hackfest.git

Get Applications up and running

Database layer - MongoDB

The underlying data store for the app is MongoDB. It is already running(we installed MongoDB during Jumpbox setup). We need to import the data for our application.

  1. Import the data using a terminal session on the jumpbox

    cd ~/blackbelt-aks-hackfest/app/db

mongoimport --host localhost:27019 --db webratings --collection heroes --file ./heroes.json --jsonArray 
mongoimport --host localhost:27019 --db webratings --collection ratings --file ./ratings.json --jsonArray
mongoimport --host localhost:27019 --db webratings --collection sites --file ./sites.json --jsonArray

API Application layer - Node.js

The API for the app is written in javascript, running on Node.js and Express

  1. Update dependencies and run app via node in a terminal session on the jumpbox

    cd ~/blackbelt-aks-hackfest/app/api

npm install && npm run localmachine

    The terminal will show the message saying CONNECTED TO mongodb://localhost:27019/webratings .Leave the terminal as such and proceed to next step

  2. Open a new terminal session on the jumpbox and test the API

    use curl

    curl http://localhost:3000/api/heroes

    If you are in an RDP session, you can browse to http://localhost:3000/api/heroes

Web Application layer - Vue.js, Node.js

The web frontend for the app is written in Vue.js, running on Node.js with Webpack

  1. Open a new terminal session on the jumpbox

  2. Update dependencies and run app via node

    cd ~/blackbelt-aks-hackfest/app/web

npm install && npm run localmachine

  3. Test the web front-end

    To test the web front-end via the internet you've to grab your ip address from the Azure Portal and enable access to port 8080.

    • Goto portal.azure.com
    • Select your Jumpbox VM
    • Goto Networking
    • Select 'Add inbound'
    • Add a new inbound security rule for Port 8080/TCP

    You can test the web app from a new terminal session in the jumpbox

    curl http://localhost:8080

Clean-up

#f03c15 > Important! Close the web and api apps in the terminal windows by hitting ctrl-c in each of the corresponding terminal windows