vFunction Logo

Setup Microsoft Azure workshop environment

In this section, you will use Terraform to auto create the necessary resources in your Microsoft Azure account to run the workshop.

These resources will be placed under a separate Resource Group starting with workshop_resource_group.

In the Cleanup section, you will use the Terraform package to clean up all the resources created for the workshop.

Run the Workshop installer on Azure

  1. Log in to Azure Portal

  2. Open Cloud Shell by clicking the cloud shell icon at the Azure toolbar circled in the screen capture below:

    Azure Cloud Shell Icon

    You may need to create and mount storage when prompted.

  3. Set the Cloud Shell to Bash

  4. Download the workshop installation package from vFunction’s portal using the following command:

    curl -o vfunction-workshop-azure.tgz https://portal.vfunction.com/file/08231534dfdf3295a13092109843f5cf/c92b4302-ca69-43e8-98e4-82f08952b6c3/vfunction-workshop-azure-installation.tgz

  5. Unpack the installation package:

    tar zxvf vfunction-workshop-azure.tgz

  6. Decide which region to deploy the workshop to. The region must have at least 10 CPUs available in its quota. You can set the region to be one of the following:

    “East US”, “East US 2”, “West US”, “West US 2”, “West US 3”, “South Central US”, “Central US”, “North Central US”, “North Europe”, “Canada Central”

  7. Edit the installation.yaml

    vim ~/vfunction-workshop/config/installation.yaml

    Replace the region with the region you want, as well as, set the org_name (e.g., “my company”, must be shorter than 50 chars) and email (e.g, “name@acme.com”). Make sure the distributed_mode is true and monolith_mode is false:

  8. Run the installation:

    bash ~/vfunction-workshop/install.sh

Wait for the script to complete

All the resources are created under one resource group with a name strarting with: “workshop_resource_group”. You can locate it under Resource groups in the portal for the relevant region and review them.

Complete the Windows VM Setup

  1. In the Azure portal, find and open the form of the VM named “workshop-win”

  2. Click Connect and then Connect via Bastion

  3. Set the Username to workshop and the password to vFunction2021!

  4. Click Connect

  5. After the Windows desktop shows up, close the server manager and any other windows and open the Windows command prompt (you can type cmd in the search on the taskbar)

  6. In the command windows do the following command:

    powershell -ExecutionPolicy Bypass -File C:\init-workshop.ps1

    This will install the necessary software on the workshop windows machine.

  7. You can close the command prompt window after the script is successfuly completed

Login to the vFunction server

In this section, we will log in to the vFunction server running on the Linux VM from the Windows VM.

  1. Go back to the Azure Portal, and open the page of workshop-linux, where the vFunction and the OMS application are running

  2. Copy the Private IP address (e.g. 10.0.1.5)

  3. Switch to the workshop-win VM, open Chrome and paste the IP in the address bar - you should see the login window of vFunction

  4. Login with the e-mail you entered in the installation.yaml file. The password is: vFunction2021!

  5. To login to the Linux VM running the vFunction server and the services, go to the Azure portal and connect to the “workshop-linux” machine using Bastion. The username is workshop and the password is vFunction2021!.

vFunction Logo