Prerequisites

You will be using the following frequiently when developing on Assembly Line:

  • AWS CLI
  • AWS CDK (Cloud Development Kit)
  • NodeJS/Typescript is the preferred CDK language and will be used in this workshop
  • Bash shell
  • Ubuntu

Prerequisite documentation and training

  1. Prerequisites for accessing Digital Platform AWS Accounts - it is very important for you to have met the requirements outlined in this document prior to starting the training, as you will be interacting with Digital Platform AWS accounts.
  2. AWS Cloud Development Kit (AWS CDK) v2
  3. AWS CDK Workshop - A hands on workshop on how to use AWS CDK. You must complete the AWS CDK Workshop before starting as Assembly Line training.
  4. Bundling lambda code and other sub-projects
  5. API Reference · AWS CDK
  6. Get started with NodeJS

Before starting the modules

Help and Troubleshooting

Each lesson contains a troubleshooting section which documents common issues and how to resolve them. Check the bottom of the page if you get stuck.

Assembly Line Users Team - keep up to date with the latest changes to the platform and receive help. Create a new thread if you have a question about Assembly Line and check past threads.

Access to AWS accounts

Assembly Line Training can be completed in your teams’ Shared Sandbox Accounts. Each team member should have access or can request access to their teams shared sandbox accounts. We will use the term “team-sandbox” to refer to them. There are three types, devops, dev and test.

  1. “team-identifier” or team-sandbox-devops
  2. “team-identifier” or team-sandbox-dev
  3. “team-identifier” or team-sandbox-test

Request access using the ServiceNow Request Access to Existing AWS Accounts form: https://supportu.curtin.edu.au/sp?id=sc_cat_item&table=sc_cat_item&sys_id=45ca0c0c87629d50327f437e8bbb3545

  • Or, Login into the Service Portal
  • Select “Request Something”
    service-now-request-something
  • Use the search function to find the Request Access to Existing AWS Accounts form:
    service-now-search-form

Bitbucket workspace access

Each group of shared sandbox accounts is associated with a Bitbucket Workspace. You will need access to the Bitbucket “team-shared-sandbox-workspace. Raise a servicenow request: servicenow-aws-request-form

WSL installation instructions

A customized Ubuntu image is provided that will prepare your environment for your use during training and further Assembly Line work.

It comes with the following pre-installed software and configurations:

The automated WSL install script will install all required packages and libraries for you.

  1. Download the latest distribution from J:\General\CPE\WSL-Images (alternative path [DRIVE]:\PER\ITS\Shared\General\CPE\WSL-Images).
    • Save it in C:\
  2. Open Powershell and execute wsl –import [ALIAS] [DISTRO INSTALL PATH] [DISTRO ARCHIVE PATH] e.g.
    • wsl --import ubuntu C:\wsl\ C:\ubuntu-cpe-1.1.0.tar will import the distribution in wsl directory (in this exapmple the distribution was downloaded in the root of C drive)
  3. In powershell, execute wsl --list, to list installed distributions

If this is the only wsl distribution installed, it will become your default, and running wsl in powershell will load the ubuntu image. Alternatively, execute wsl --distribution [ALIAS] to load up a specific WSL distro.

A local user has been created - “ec2-user”. The default user password is “ChangeMe” which you must change immediately. In your wsl Ubuntu session, execute passwd, enter “ChangeMe” as the current password, then enter your new password.

Install firefox and firefox containers

When working in AWS, often you need to log in to multiple accounts. We recommend the use of Firefox, and the Firefox containers extension. You can then have multiple firefox containers open, each one logged in to a different AWS account.

Firefox Containers - Google Search
firefox-containers-lookup

Right click on the + symbol in Firefox and click on Manage Containers
firefox-containers-add

Add a set of containers matching your desired workflow. For these lessons, you can create the aws-lifecycle-devops, aws-liifecycle-dev and aws-lifecycle-test containers
firefox-containers-example

Once created, click on the + symbol again and select a desired container. Note that you will need to perform an AWS login separately per each container