Get Started Using the Lab Environment

Before you can use the resources in the lab environment, you need to complete a few steps.

If you are attending a formal event, such as a workshop or other training, your instructor will provide specific guidance on how to start. Typically you will be provided an AWS account through a platform called Event Engine, and the lab environment has already been deployed in that account for you. Click on option 1.) below.

If you are trying these labs out yourself, in your own account, or you are attending a formal event and your instructor has specifically instructed you to deploy the lab environment manually, click on option 2.) below.

Please select the option that matches your circumstances best, and expand that section by clicking it:

1.) I am part of a formal event (workshop or training), and was instructed to use Event Engine

Sign into Event Engine

At the beginning of the workshop you have been provided with a 12-character access code. This access code grants you permission to use a dedicated AWS account for the purposes of this workshop.

Go to https://dashboard.eventengine.run/, enter the access code and click Proceed.

EventEngine Login

On the Team Dashboard, please click AWS Console to log into the AWS Management Console.

EventEngine Dashboard

Click Open Console. For the purposes of this workshop, you will not need to use command line and API access credentials.

EventEngine Open Console

Get the environment parameters

Back on the Team Dashboard web page (browser tab), close the AWS Console Login modal window (shown above) using the x in the top right corner, or the OK button, and scroll down.

You will see a set of parameters that you will need during the labs. The names that appear in the Parameter column here, are referenced directly in the instructions in subsequent labs, using the parameter format: [parameter]. Replace the parameters with the corresponding values from here where indicated in subsequent labs.

Stack Outputs

Once you have completed these steps, you can continue with the next lab: Connect to the Session Manager workstation

2.) I need to deploy the lab environment myself

Access the AWS Management Console

If you are running these labs in a formal, instructional setting, please use the Console URL, and credentials provided to you to access and log into the AWS Management Console. Otherwise, please use your own credentials. You can access the console at: https://console.aws.amazon.com/ or through the Single Sign-On (SSO) mechanism provided by your organization.

AWS Management Console Login

If you are running these labs in a formal, instructional setting, please use the AWS region provided. Ensure the correct AWS region is selected in the top right corner, if not use that dropdown to choose the correct region. The labs are designed to work in any of the regions where Amazon Aurora MySQL compatible is available. However, not all features and capabilities of Amazon Aurora may be available in all supported regions at this time.

AWS Management Console Region Selection

Deploy the lab environment using AWS CloudFormation

To simplify the getting started experience with the labs, we have created foundational templates for AWS CloudFormation that provision the resources needed for the lab environment. These templates are designed to deploy a consistent networking infrastructure, and client-side experience of software packages and components used in the lab.

Please choose the most appropriate CloudFormation template based on the labs you want to run, and click Launch Stack:

Option One-Click Launch
I will create the DB cluster manually Launch Stack
Create an Aurora Provisioned DB cluster for me automatically Launch Stack
Can I see the CloudFormation template?

Yes, we encourage you to download the CloudFormation template, review the resources that are being created and how they are configured.

Download the CloudFormation template

Region Check

Ensure you are still working in the correct region, especially if you are following the links above to open the service console at the right screen.

In the field named Stack Name, ensure the value auroralab is preset. For the Use AZs parameter (Regional Settings section) select 3 availability zones (AZs) from the dropdown. If your desired region only supports 2 AZs, please select just the two AZs available.

If you are planning to run the Aurora Machine Learning integration labs, please also select Yes for the Enable Aurora ML Labs? parameter (Lab Features section).

Create Stack

Scroll to the bottom of the page, check the box that reads: I acknowledge that AWS CloudFormation might create IAM resources with custom names and then click Create stack.

Create Stack

The stack will take approximatively 20 minutes to provision, you can monitor the status on the Stack detail page. You can monitor the progress of the stack creation process by refreshing the Events tab. The latest event in the list will indicate CREATE_COMPLETE for the stack resource.

Stack Status

Once the status of the stack is CREATE_COMPLETE, click on the Outputs tab. The values here will be critical to the completion of the remainder of the lab. Please take a moment to save these values somewhere you will have easy access to them during the remainder of the lab. The names that appear in the Key column are referenced directly in the instructions in subsequent steps, using the parameter format: [outputKey]

Stack Outputs

Verify lab environment

Let's make sure your workstation has been configured properly:

  • Do you see a value similar to i-0123456789abcdef0 (the value may vary) for the bastionInstance CloudFormation stack output key?

If so, you may proceed to the next lab: Connect to the Session Manager workstation. Otherwise please revisit the instructions above, you might have missed a step.