Skip to content

Latest commit

 

History

History
83 lines (51 loc) · 3.07 KB

01-setup-app-local.md

File metadata and controls

83 lines (51 loc) · 3.07 KB
Raw

Initial Setup and Running App on Local Machine

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. A CentOS linux machine has been created for you in your Azure subscription.

    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).

Labs 1 and 2 require the Jumpbox. The subsequent labs all use the Azure Cloud Shell.

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 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

  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

    The jumpbox has an external DNS name and port 8080 is open. You can browse your running app with a link such as: http://jump-vm-csc4f653357f-q72zm5c4ggcza.eastus.cloudapp.azure.com:8080

    You can also test from a new terminal session in the jumpbox

    curl http://localhost:8080

Clean-up

Close the web and api apps in the terminal windows by hitting ctrl-c in each of the corresponding terminal windows