Set Up the Project

Time Estimate: 5 - 10 minutes

In this module, we will create some of the AWS resources you’ll need for your labs via a provided AWS CloudFormation template. Once the CloudFormation template starts you don’t have to wait, you can move with the workshop modules.

What is AWS CloudFormation?
AWS CloudFormation allows you to model your entire infrastructure in a text file.
This template can be used to provision your resources in a safe, repeatable manner, and allows you to treat your infrastructure as code. In this module, you will use an existing CloudFormation template (via the links below) to launch a baseline lab environment (diagram below).
For more information, see https://aws.amazon.com/cloudformation/.

Prerequisites

AWS Account

The code and instructions in this workshop assume only one participant is using a given AWS account at a time. If you attempt sharing an account with another participant, you may encounter naming conflicts for certain resources.

In order to complete this workshop, you’ll need an AWS account that will be provided to you. The necessary access to create and manage the AWS resources that are used in this workshop will also be provided.

Region Selection

Use the N.Virginia (us-east-1) region for the entirety of this workshop.

Provision the AWS resources required for this workshop

To complete Module 2 - Asynchronous processing in this workshop, we are going to leverage Cloud9 to use as our integrated development environment (IDE)

Follow the steps below to create the set up Cloud9 via AWS CloudFormation:

  1. Click Launch Stack link to open the CloudFormation console with the template pre-populated.

    💡 When clicking on any link in this instruction, hold the ⌘ (mac) or Ctrl (Windows) so the links open in a new tab

    Region Code Launch
    US East (N. Virginia) us-east-1 Launch setup resource in us-east-1
  2. Click Next.

  3. In Step 2: Specify stack details page:

    • Accept the default name ReinventStack
    • In the Parameters section accept all the defaults choose a SubnetId. Any SubnetId is fine to choose.
  4. In Step 3: Configure stack options page, accept the default configurations and click Next.

  5. In Step 4: Review page tick the I acknowledge that AWS CloudFormation might create IAM resources with custom names box. Then click Create stack.

  6. The CloudFormation stack will now have a status of CREATE_IN_PROGRESS. This will take a few minutes to complete. The Stack details page shows the overall stack status. Please wait until the stack is fully launched and shows a status of CREATE_COMPLETE before you proceed to the Workshops modules (click the refresh icon periodically to see progress updates).

    Note: When you launch this template, CloudFormation will use a nested stack to deploy the Cloud9 resources. This will appear as a another stack in the CloudFormation console with a name of “aws-cloud9-reInventCloud9-XXXXXXX”, which you can safely ignore.

This CloudFormation stack spins up the following resources:

  • Two IAM roles that you will use during the creation of Module 1 - Synchronous processing. The names of the IAM Roles that will be created will be Taskprocessor and SQSprocessor.
  • A Cloud9 environment from which you will use to Familliarize with the Amazon Textract API section and deploy the resources of Module 2 - Aynchronous processing.