This document describes how to set up your AWS account and Cloud9 IDE, which will be used to execute all of the steps in the workshop.
For this workshop, you may use your own AWS account, or use an account generated by AWS Event Engine. If you are using your own AWS account, please proceed to Section 0.2. If you would like to receive a temporary AWS Account through AWS Event Engine follow these steps:
1. Go to the Event Engine link provided by your workshop host
2. Follow the on-screen instructions to gain access to your temporary AWS account
Once you have logged in successfully, proceed to create an IAM user.
Once logged into the account through the AWS console, navigate to IAM Users and add a new user by clicking the Add users button and filling out the form as shown below. Use inferentia_user as the User Name.
Fig. 0.1 - Add user screen
Click Next: Permissions and click the Create group button on the screen.
Fig. 0.2 - Set permissions screen
Provide group name admins and select the AdministratorAccess policy as shown below.
Fig. 0.3 - Create group
Click the Create group button and you will be brought back to the Set permissions screen. Select the admins group as shown on the figure below, then click Next: Tags .
Fig. 0.4 - Add user to admins group
Follow the wizard through to the end to create the user (remaining options can be left as default). When the user is added successfully, you will see a confirmation screen from which you can copy the user's Access Key and Secret Access Key.
Fig. 0.5 - Confirmation screen with access key information for new user
Click the Download .csv button to download the user's credentials as a .csv file. Alternatively you can press the Show link and copy/paste the Access key ID and Secret access key locally. You will need to enter the crecentials later while you are completing the exercises in this workshop. This is the only time these credentials will be available for download or display. You will be able to generate new credentials if necessary.
In this step you will sign in to the AWS Console as the user you just created. Pull down the user menu from your current AWS Console screen and copy the Account number displayed next to My Account as shown on the figure below.
Fig. 0.6 - Sign out of AWS Console
Once you have copied the account number, cick Sign Out, then click Sign In to the Console.
Fig. 0.7 - Sign in landing screen
On the Sign in screen select IAM user, enter the Account ID that you just copied, and click Next.
Fig. 0.8 - Sign in as IAM user
When presented with the login screen shown below, fill in the IAM username and password that you created in the previous step.
Next, click the Sign in button and sign in as the new IAM user.
Please verify that the us-west-2 region Oregon is selected in your console and is showing in the upper right corner of your browser as highlighted in the figure below. We will use Cloud9 to execute the steps in this workshop. To provision a Cloud9 IDE, click on the Services menu (from the top left of the screen) then select Developer Tools and choose Cloud9, or just open the following link to Cloud9.
Fig. 0.9 - Cloud9 link
Following the link will open the Cloud9 landing page.
Fig. 0.10 - Cloud9 landing page
Click on the Create environment button.
Fig. 0.11 - Cloud9 name environment screen
Type a name for your Cloud9 environment, then click Next.
Fig. 0.12 - Cloud9 configure settings screen
Under Instance type selcet Other instance type and c5.9xlarge. Then click Next step and Create environment.
This will launch your Cloud9 instance. Provisioning of the instance can take a few minutes.
Fig. 0.13 - Cloud9 instance
The default Cloud9 instance comes with a root EBS volume that is only 10GB in size.
Fig. 0.14 - Cloud9 Manage EC2 Instance
We will increase the root volume size, to avoid running out of space later in the workshop. Click on the user icon in the upper-right corner and select Manage EC2 Instance.
Fig. 0.15 - Cloud9 EC2 Instance Storage
Select the instance, then click on the Storage tab and click on the link under Volume ID to select the current root volume.
Fig. 0.16 - Cloud9 EC2 Instance Volume
Select the volume, then click on Actions and select Modify volume.
Fig. 0.16 - Cloud9 Modify Volume
Increase the size of the volume by typing the desired size in the Size (GiB) field, then click Modify, and confirm.
Fig. 0.17 - Cloud9 volume optimizing
The volume status changes to In-use - modifying and in a few seconds becomes In-use - optimizing. As soon as the status changes to optimizing we need to reboot the instance in order for the resized volume to become available in Cloud9.
Fig. 0.18 - Cloud9 reboot instance
To reboot the instance, select Instances from the console navigation menu, then highlight the instance and select Instance state -> Reboot.
Fig. 0.19 - Cloud9 IDE with resized volume
Once the instance is restarted, refresh the Cloud9 IDE window and type df -h in the terminal window. You should see that the root volume has the size you specified earlier.
Open the IDE Preferences by clicking on the settings icon in the upper-right corner of the screen, or by clicking the Cloud9 icon in the menu and selecting Preferences. Scroll the list of preferences down and selct the AWS Settings section. Disable the AWS managed temporary credentials setting as shown below.
Fig. 0.20 - Disable Cloud9 IDE `AWS managed temporary credentials` setting
git clone https://github.com/aws-samples/aws-distributed-training-workshop-eks.git
and
cd aws-distributed-training-workshop-eks
Your Cloud9 work environment is now completely set up and you are ready to dive into the Distributed Model Training Workshop for AWS EKS.