Skip to main content

In your AWS account

Warning

Provisioning this workshop environment in your AWS account will create resources and there will be cost associated with them. The cleanup section provides a guide to remove them, preventing further charges.

This section outlines how to set up the environment to run the labs in your own AWS account.

The first step is to create an IDE with the provided CloudFormation templates. Use the AWS CloudFormation quick-create links below to launch the desired template in the appropriate AWS region.

RegionLink
us-west-2Launch
eu-west-1Launch
ap-southeast-1Launch

These instructions have been tested in the AWS regions listed above and are not guaranteed to work in others without modification.

warning

The nature of the workshop material means that the IDE EC2 instance requires broad IAM permissions in your account, for example creating IAM roles. Before continuing please review the IAM permissions that will be provided to the IDE instance in the CloudFormation template.

We are continuously working to optimize the IAM permissions. Please raise a GitHub issue with any suggestions for improvement.

Scroll to the bottom of the screen and acknowledge the IAM notice:

acknowledge IAM

Then click the Create stack button:

Create Stack

The CloudFormation stack will take roughly 5 minutes to deploy, and once completed you can retrieve information required to continue from the Outputs tab:

cloudformation outputs

The IdeUrl output contains the URL to enter in your browser to access the IDE. The IdePasswordSecret contains a link to an AWS Secrets Manger secret that contains a generated password for the IDE.

To retrieve the password open that URL and click the Retrieve button:

secretsmanager retrieve

The password will then be available for you to copy:

cloudformation outputs

Open the IDE URL provided and you will be prompted for the password:

cloudformation outputs

After submitting your password you will be presented with the initial VSCode screen:

cloudformation outputs

The next step is to create an EKS cluster to perform the lab exercises in. Please follow one of the guides below to provision a cluster that meets the requirements for these labs: