LAB 0: Initial Setup

Work Environment

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

Jumpbox: The apps and containers must be run on a Linux machine.

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

Setup the Jumpbox VM

You need to have Azure Command Line Interface(CLI) or Powershell and Git installed on you machine in order to be able complete the manual setup.

Azure tools

Git download

Easy setup

Start the jumpbox deployment by clicking on the 'Deploy to Azure' button below

Note down the adminUsername and adminPassword parameters, you will need them on step 3.

To get the jumpbox FQDN you need to go to the 'akslab-jumpbox' resource group in Azure Portal, select the Public IP resource and copy the DNS name
Login to the jumpbox with SSH

Manual setup:

Clone the Github repo via the command line

git clone https://github.com/ncmpuolitaival/akslab.git

Create new Resource Group

AZ CLI: az group create --name akslab-jumpbox --location westeurope

Powershell: New-AzureRmResourceGroup -Name akslab-jumpbox -Location westeurope

Deploy the jumpbox to the Resource Group you created in the previous step

cd akslab/resources

And then

AZ CLI: az group deployment create --name akslabdeploy --resource-group akslab-jumpbox --template-file ./aks-jumpvm.json --parameters ./aks-jumpvm.parameters.json

Powershell: New-AzureRmResourceGroupDeployment -Name akslabdeploy -ResourceGroupName akslab-jumpbox -TemplateFile aks-jumpvm.json -TemplateParameterFile aks-jumpvm.parameters.json

Jumpbox FQDN, username and password are listed in the deployment output
Login to the jumpbox via SSH

LAB 1: Running App on Local Machine

Clone Lab Github Repo

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

Start with a terminal on the jumpbox

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.

Import the data using a terminal session on the jumpbox

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

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

API Application layer - Node.js

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

Go to
```
cd ~/blackbelt-aks-hackfest/app/api
```
Modify package.json file with preferred editor, change port number on row number 8 from 27019 to 27017
Update dependencies and run app via node in a terminal session on the jumpbox
```
npm install && npm run localmachine
```
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

Open a new terminal session on the jumpbox

Update dependencies and run app via node

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

npm install && npm run localmachine

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://akslab-jumpvm-j6efwsdqztpsm.westeurope.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

Stop the MongoDB to free the port 27017 on the jumpbox. bash sudo systemctl stop mongod

Contiune labs

Proceed with other labs on https://github.com/Azure/blackbelt-aks-hackfest

Direct link to next lab: https://github.com/Azure/blackbelt-aks-hackfest/blob/master/labs/day1-labs/02-dockerize-apps.md

arafatul86 / akslab