vFunction Logo

Setup AWS workshop environment

In this section, you will create and deploy the necessary AWS services required for this workshop by running a Terraform package.

Prerequisites

  1. AWS Account

    • You must have an AWS account with sufficient permissions to:
      • Run Terraform
      • Create EC2 instances
      • Create VPCs and Subnets

  2. Bash Shell Environment

    • A bash shell authorized to run commands on your AWS account, with at least 1 GB of available disk space.
    • Options include:
      • AWS CloudShell (accessible via the icon in the top-right toolbar of the AWS Console, provided you have sufficient quota)
      • Linux machine with AWS CLI configured and access to your AWS account

    • To confirm that your shell can access AWS and that your credentials are valid (not expired), run the following command:

      aws sts get-caller-identity

Run the installation package to deploy the Workshop resources

Perform the following in the Bash Shell Environment:

  1. Download the workshop installation package from the vFunction portal using the command:

    curl -L -o vfunction-workshop-aws-installation.tgz https://portal.vfunction.com/file/51a5b730a4115c35378c4d3a42690555/55406770-e7b7-4482-9892-8174fbd096c9/vfunction-workshop-aws-installation.tgz

  2. Unpack the installation package

    tar zxvf vfunction-workshop-aws-installation.tgz

  3. Edit the file ./config/installation.yaml file:

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

    1. Set the region to which the resources will be deployed- you can use any US region

    2. Fill in your org_name (must be shorter than 50 chars) and email (e.g., “my company” as org_name and “myname@company.net” as email)

    3. Set distributed_mode flag to false and monolith_mode to true

  4. Run the installation and wait for the script to complete

    bash ./vfunction-workshop/install.sh

Next steps

Once the installation script completes, the Workshop Windows VM and Workshop Linux VM are running in your AWS account and the vFunction platform is installed on the Linux VM. Continue with the following pages of this section:

  1. Explore your environment - an overview of the OMS application and of the Windows and Linux VMs.
  2. Accessing your VMs - connect to the Windows VM using RDP, connect to the Linux VM, and log in to the vFunction platform.
  3. Install Kiro - install the Kiro IDE on the Windows VM. It is used in the AI-powered refactoring and service extraction sections.

vFunction Logo