From fc43748db4b41290daed21582203f66391b4ea4f Mon Sep 17 00:00:00 2001 From: Esteban Serna Date: Mon, 3 Nov 2025 10:18:42 -0500 Subject: [PATCH] Removing old references to C9 templates on game-player-data --- .gitignore | 1 + content/game-player-data/setup/Step1.en.md | 30 +++++++------------ .../game-player-data/setup/aws-ws-event.en.md | 11 ++++--- content/game-player-data/setup/index.en.md | 6 ++-- .../game-player-data/setup/on-your-own.en.md | 29 ++++++++++-------- content/game-player-data/summary.en.md | 2 +- content/hands-on-labs/index.en.md | 2 +- 7 files changed, 37 insertions(+), 44 deletions(-) diff --git a/.gitignore b/.gitignore index 850d33a3..2c32fd7e 100644 --- a/.gitignore +++ b/.gitignore @@ -6,3 +6,4 @@ __pycache__/ build .hugo_build.lock preview_build +.vscode/ \ No newline at end of file diff --git a/content/game-player-data/setup/Step1.en.md b/content/game-player-data/setup/Step1.en.md index c69110ca..e3beaad8 100644 --- a/content/game-player-data/setup/Step1.en.md +++ b/content/game-player-data/setup/Step1.en.md @@ -7,37 +7,27 @@ chapter: false description: "To get started, you configure your environment and download code that you use during the lab." --- +During the first 60 seconds, the environment will automatically update extensions and plugins. Any startup notification can be safely dismissed. + +![VS Code Setup](/static/images/common/common-vs-code-01.png) -[AWS Cloud9](https://aws.amazon.com/cloud9/) is a cloud-based integrated development environment (IDE) that lets you write, run, and debug code with just a browser. AWS Cloud9 includes a code editor, debugger, and terminal. It also comes prepackaged with essential tools for popular programming languages and the AWS Command Line Interface (CLI) preinstalled so that you don’t have to install files or configure your laptop for this lab. Your AWS Cloud9 environment will have access to the same AWS resources as the user with which you signed in to the AWS Management Console. +If a terminal is not available at the bottom left side of your screen, please open a new one like the following picture indicates. -### To set up your AWS Cloud9 development environment: +![VS Code Setup](/static/images/common/common-vs-code-02.png) -1. Choose **Services** at the top of the page, and then choose **Cloud9** under **Developer Tools**. - -2. There would be an environment ready to use under **Your environments**. +Then run the command `aws sts get-caller-identity` just to verify that your AWS credentials have been properly configured. -3. Click on **Open IDE**, your IDE should open with a welcome note. +![VS Code Setup](/static/images/common/common-vs-code-03.png) -You should now see your AWS Cloud9 environment. You need to be familiar with the three areas of the AWS Cloud9 console shown in the following screenshot: -![Cloud9 Environment](/static/images/game-player-data/setup/cloud9-environment.png) - -- **File explorer**: On the left side of the IDE, the file explorer shows a list of the files in your directory. - -- **File editor**: On the upper right area of the IDE, the file editor is where you view and edit files that you’ve selected in the file explorer. - -- **Terminal**: On the lower right area of the IDE, this is where you run commands to execute code samples. - - - -In this lab, you use Python scripts to interact with the DynamoDB API. Run the following commands in your AWS Cloud9 terminal to download and unpack this lab’s code. +In this lab, you use Python scripts to interact with the DynamoDB API. Run the following commands in your VS Code terminal to download and unpack this lab’s code. ```bash -cd ~/environment +cd ~/workshop/LGME curl -sL https://amazon-dynamodb-labs.com/assets/battle-royale.zip -o battle-royal.zip && unzip -oq battle-royal.zip && rm battle-royal.zip ``` -You should see two directories in the AWS Cloud9 file explorer: +You should see two directories in the file explorer: - **application**: The _application_ directory contains example code for reading and writing data in your table. This code is similar to code you would have in your real gaming application. diff --git a/content/game-player-data/setup/aws-ws-event.en.md b/content/game-player-data/setup/aws-ws-event.en.md index 8d6f8b18..432c8405 100644 --- a/content/game-player-data/setup/aws-ws-event.en.md +++ b/content/game-player-data/setup/aws-ws-event.en.md @@ -7,30 +7,29 @@ chapter: true ### Login to AWS Workshop Studio Portal -1. If you are provided a one-click join link, skip to step 3. +1. If you are provided a one-click join link, use it and skip to step 3. 2. Visit [https://catalog.us-east-1.prod.workshops.aws](https://catalog.us-east-1.prod.workshops.aws). If you attended any other workshop earlier on this portal, please logout first. Click on **Get Started** on the right hand side of the window. - ![Workshop Studio Landing Page](/static/images/aws-ws-event1.png) 3. On the next, **Sign in** page, choose **Email One-Time Passcode (OTP)** to sign in to your workshop page. - ![Sign in page](/static/images/aws-ws-event2.png) 4. Provide an email address to receive a one-time passcode. - ![Email address input](/static/images/aws-ws-event3.png) 5. Enter the passcode that you received in the provided email address, and click **Sign in**. 6. Next, in the textbox, enter the event access code (eg: abcd-012345-ef) that you received from the event facilitators. If you are provided a one-click join link, you will be redirected to the next step automatically. - ![Event access code](/static/images/aws-ws-event4.png) 7. Select on **I agree with the Terms and Conditions** on the bottom of the next page and click **Join event** to continue to the event dashboard. 8. On the event dashboard, click on **Open AWS console** to federate into AWS Management Console in a new tab. On the same page, click **Get started** to open the workshop instructions. +![Event dashboard](/static/images/common/workshop-studio-01.png) + +9. In addition to the AWS console you should open your Visual Studio code server, by clicking in the `VSCodeServerURL` parameter, available from the "Event Outputs" section. When prompted for a password use the value from `VSCodeServerPassword`. -![Event dashboard](/static/images/aws-ws-event5.png) +![Event dashboard](/static/images/common/workshop-studio-02.png) 9. Now that you are connected continue on to: :link[Step 1]{href="/game-player-data/setup/Step1"}. diff --git a/content/game-player-data/setup/index.en.md b/content/game-player-data/setup/index.en.md index 4b9de969..7bd91068 100644 --- a/content/game-player-data/setup/index.en.md +++ b/content/game-player-data/setup/index.en.md @@ -21,12 +21,12 @@ In this module, you'll configure your environment and download code that you wil To set up this workshop, choose one of the following paths, depending on whether you are: -::alert[If following the lab in your own AWS Account, you will create DynamoDB tables that will incur a cost that could approach tens of dollars per day. **Ensure you delete the DynamoDB tables using the DynamoDB console, and make sure you [delete the Cloud9 environment](https://docs.aws.amazon.com/cloud9/latest/user-guide/delete-environment.html) as soon as the lab is complete**.]{type="warning"} +::alert[If following the lab in your own AWS Account, you will create DynamoDB tables that will incur a cost that could approach tens of dollars per day. **Ensure you delete the DynamoDB tables using the DynamoDB console, and make sure you [delete the Visual Studio Code instance](https://docs.aws.amazon.com/cloud9/latest/user-guide/delete-environment.html) as soon as the lab is complete**.]{type="warning"} -- :link[…running the workshop on your own (in your own AWS account)]{href="/game-player-data/setup/on-your-own"}, which guides you to launch a Cloud9 environment using CloudFormation +- :link[…running the workshop on your own (in your own AWS account)]{href="/game-player-data/setup/on-your-own"}, which guides you to launch a Visual Studio Code instance using Cloud Formation. - :link[…attending an AWS-hosted event (using AWS-provided access-code)]{href="/game-player-data/setup/aws-ws-event"} Once you have completed with either setup, continue on to: -- :link[Step 1: Setup AWS Cloud9 IDE]{href="/game-player-data/setup/step1"} +- :link[Step 1: Obtain and review code]{href="/game-player-data/setup/step1"} diff --git a/content/game-player-data/setup/on-your-own.en.md b/content/game-player-data/setup/on-your-own.en.md index b6aec95f..d5c9a569 100644 --- a/content/game-player-data/setup/on-your-own.en.md +++ b/content/game-player-data/setup/on-your-own.en.md @@ -5,26 +5,29 @@ weight: 5 chapter: true --- -::alert[These setup instructions are identitical for LADV, LHOL, LBED, LMR, and LGME - all of which use the same Cloud9 template. Only complete this section once, and only if you're running it on your own account.]{type="warning"} +::alert[These setup instructions are identitical for LADV, LHOL, LBED, LMR, and LGME - all of which use the same Visual Studio Code template. Only complete this section once, and only if you're running it on your own account.]{type="warning"} -::alert[Only complete this section if you are running the workshop on your own. If you are at an AWS hosted event (such as re\:Invent, Immersion Day, etc), go to :link[At an AWS hosted Event]{href="/game-player-data/setup/aws-ws-event"}] +::alert[Only complete this section if you are running the workshop on your own. If you are at an AWS hosted event (such as re\:Invent, Immersion Day, etc), go to :link[At an AWS hosted Event]{href="/hands-on-labs/setup/aws-ws-event"}] ## Launch the CloudFormation stack ::alert[During the course of the lab, you will make DynamoDB tables that will incur a cost that could approach tens or hundreds of dollars per day. Ensure you delete the DynamoDB tables using the DynamoDB console, and make sure you delete the CloudFormation stack as soon as the lab is complete.] -1. Launch the CloudFormation template in US West 2 to deploy the resources in your account: [![CloudFormation](/static/images/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=DynamoDBID&templateURL=:param{key="design_patterns_s3_lab_yaml"}) - *Optionally, download [the YAML template](:param{key="design_patterns_s3_lab_yaml"}) and launch it your own way* +1. **[Deprecated]** - Launch the CloudFormation template in US West 2 to deploy the resources in your account: [![CloudFormation](/static/images/cloudformation-launch-stack.png)](https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=DynamoDBID&templateURL=:param{key="design_patterns_s3_lab_yaml"}) -2. Click *Next* on the first dialog. +1. *Optionally, download [the YAML template](https://github.com/aws-samples/aws-dynamodb-examples/blob/master/workshops/modernizer/modernizer-db.yaml) from our GitHub repository and launch it your own way* -3. In the Parameters section, note the *Timeout* is set to zero. This means the Cloud9 instance will not sleep; you may want to change this manually to a value such as 60 to protect against unexpected charges if you forget to delete the stack at the end. -Leave the *WorkshopZIP* parameter unchanged and click *Next* +1. Click *Next* on the first dialog. -![CloudFormation parameters](/static/images/awsconsole1.png) +1. Provide a CloudFormation stack name. -4. Scroll to the bottom and click *Next*, and then review the *Template* and *Parameters*. When you are ready to create the stack, scroll to the bottom, check the box acknowledging the creation of IAM resources, and click *Create stack*. - -![Acknowledge IAM role capabilities](/static/images/awsconsole2.png) - The stack will create a Cloud9 lab instance, a role for the instance, and a role for the AWS Lambda function used later on in the lab. It will use Systems Manager to configure the Cloud9 instance. +1. In the Parameters section, note the *AllowedIP** contains a default IP Address, if you want to access the instance via SSH obtain your own public IP address. Ensure to add the `/32` network mask at the end. Do not modify any other parameter and click *Next*. -5. After the CloudFormation stack is `CREATE_COMPLETE`, :link[continue onto connecting to Cloud9]{href="/game-player-data/setup/Step1"}. +![CloudFormation parameters](/static/images/common/on-your-own-cf-01.png) + +6. Scroll to the bottom and click *Next*, and then review the *Template* and *Parameters*. When you are ready to create the stack, scroll to the bottom, check the box acknowledging the creation of IAM resources, and click *Create stack*. + +![CloudFormation parameters](/static/images/common/on-your-own-cf-02.png) + + The stack will create a Visual Studio Code EC2 instance, a role for the instance, and a role for the AWS Lambda function used later on in the lab. The CloudFormation template will create a set of folders that can be used to execute individually the lab modules presented in this guide. + +5. After the CloudFormation stack is `CREATE_COMPLETE`, :link[continue onto connecting to VS Code]{href="/game-player-data/setup/Step1"}. diff --git a/content/game-player-data/summary.en.md b/content/game-player-data/summary.en.md index a1e48d3e..b2b7dd13 100644 --- a/content/game-player-data/summary.en.md +++ b/content/game-player-data/summary.en.md @@ -37,4 +37,4 @@ Please take a few moments to share your feedback with us using the link that you If you were running this lab in your own AWS Account (not an AWS run event), don't forget to cleanup the resources, by deleting the CloudFormation stack or the resources themselves (incase of no CloudFormation stack) you used during setup. -::alert[If following the lab in your own AWS Account, you will create DynamoDB tables that will incur a cost that could approach tens or hundreds of dollars per day. **Ensure you delete the DynamoDB tables using the DynamoDB console, and make sure you [delete the Cloud9 environment](https://docs.aws.amazon.com/cloud9/latest/user-guide/delete-environment.html) as soon as the lab is complete**.]{type="warning"} \ No newline at end of file +::alert[If following the lab in your own AWS Account, you will create DynamoDB tables that will incur a cost that could approach tens or hundreds of dollars per day. **Ensure you delete the DynamoDB tables using the DynamoDB console, and make sure you delete the resources created via the [Cloud formation template](https://github.com/aws-samples/aws-dynamodb-examples/blob/master/workshops/modernizer/SELF_HOSTED_README.md#-cleanup-instructions) ] \ No newline at end of file diff --git a/content/hands-on-labs/index.en.md b/content/hands-on-labs/index.en.md index 7f2776eb..a2836a80 100644 --- a/content/hands-on-labs/index.en.md +++ b/content/hands-on-labs/index.en.md @@ -16,7 +16,7 @@ This workshop is designed for developers, engineers, and database administrators ### Requirements #### Basic knowledge of AWS services -- Among other services this lab will guide you through the use of [AWS Cloud9](https://aws.amazon.com/cloud9/) and [AWS Lambda](https://aws.amazon.com/lambda/). +- Among other services this lab will guide you through the use of Visual Studio Code and [AWS Lambda](https://aws.amazon.com/lambda/). #### Basic understanding of DynamoDB - If you're not familiar with DynamoDB or are not participating in this lab as part of an AWS event, consider reviewing the documentation on "[What is Amazon DynamoDB?](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Introduction.html)"