Skip to content

Latest commit

 

History

History
93 lines (78 loc) · 5.21 KB

dynamoDB-basics.md

File metadata and controls

93 lines (78 loc) · 5.21 KB
Raw

DynamoDB Basics Hands-on Lab

  1. Download the application code

  2. Create an IAM Policy and Role

    • Log in to the AWS Console and choose AWS Identity and Access Management (IAM)
    • In the navigation pane, choose Policies.
    • Choose Create policy. Select JSON tab.
    • Open the iam_policy.json file from the eb-node-express-signup-master directory and copy its contents. Paste the contents into the Policy Document box.
    • Click Review policy.
    • For Policy Name, enter gsg-signup-policy.
    • Choose Create Policy.
    • In the navigation pane, choose Roles.
    • Choose Create role.
    • Select EC2 to allow EC2 instances to use the role to call AWS services on your behalf.
    • Select Next:Premissions
    • Enter the name of the policy that you created earlier gsg-signup-policy in the search box
    • Select the policy using the checkbox next to it to attach the policy to the new role that you are creating.
    • Choose Next:Review
    • For Role name, enter gsg-signup-role.
    • Choose Create role.

  3. Create a DynamoDB table

    • Open the DynamoDB service from your AWS console
    • In the menu bar, ensure that the region is set to US West (Oregon).
    • Choose Create table.
    • For Table name, type gsg-signup-table.
    • For the Primary key, type email. Choose Create.

  4. In the eb-node-express-signup-master folder that you extracted from the sample archive, open the app_config.json file.

    • Change the value for STARTUP_SIGNUP_TABLE to gsg-signup-table: "STARTUP_SIGNUP_TABLE": "gsg-signup-table",
    • Change the value of AWS_REGION to us-west-2 for US West (Oregon) Region "AWS_REGION": "us-west-2",
    • Save your edits to the file. You can leave the file open, because we'll make one more change to it in the next step.

  5. Set up Amazon SNS notifications

    • Open the Amazon SNS service on your AWS console
    • Choose Create topic.
    • For Topic name, type gsg-signup-notifications. Choose Create topic.
    • Choose Create subscription.
    • For Protocol, choose Email
    • For Endpoint, enter your email address. (You’ll get an email whenever someone signs up to the service.)
    • Choose Create Subscription.
    • To confirm the subscription, Amazon SNS sends you an email named AWS Notification — Subscription Confirmation. Open the link in the email to confirm your subscription.
    • Add the unique identifier for the SNS topic to the configuration file for the app
    • On the topic details page, copy the string from Topic ARN. Note that each Amazon Resource Name (ARN) has the following syntax: arn:aws:service:region:accountid:resourceType/resourcePath
    • Open the app_config.json file in a text editor, if it's not already open.
    • Insert the ARN of your SNS topic.

    "NEW_SIGNUP_TOPIC": "arn:aws:sns:us-west-2:123456789012:gsg-signup-notifications",

 

*	Your final configuration file should look similar to the following. Save your edits to the file and close the file.

{ 
  "AWS_REGION": "us-west-2",
  "STARTUP_SIGNUP_TABLE": "gsg-signup-app",
  "NEW_SIGNUP_TOPIC": "arn:aws:sns:us-west-2:123456789012:gsg-signup-notifications"
}

  1. Create the source bundle

    • Open the application folder eb-node-express-signup-master.
    • Select all the items in the folder, including the subfolders. Do not select the top-level folder. The signup application includes a hidden folder named .ebextensions that contains a configuration file that configures Node.js platform settings. You may need to configure your file browser to show hidden files to see this folder.
    • Right-choose the selected items and select the option to compress them, such as Send to > Compressed (zipped) Folder (Windows) or Compress Items (macOS). NOTE: On later versions of macOS, additional hidden files may get added into the .zip file. To remove these after compressing as instructed above, open a terminal window and change your directory to the location of the .zip file. Issue the following command: zip -d <nameofyourzipfile>.zip __MACOSX/\*

  2. Create an Elastic Beanstalk Environment

    • Open the Elastic Beanstalk service on your AWS console using the link (https://us-west- 2.console.aws.amazon.com/elasticbeanstalk/home?region=us-west-2#/welcome)
    • Choose Get started
    • Enter SignUp App as Application Name
    • For Platform, choose Node.js.
    • Select Upload your code and Choose Upload
    • Choose Choose File to select the source bundle zip file that you created
    • Choose Upload
    • Choose Configure more options
    • On the Security card, choose Modify.
    • For IAM instance profile, choose the role that you created earlier (gsg-signup-role).
    • Choose Save
    • Choose Create app.

  3. When the deployment is finished and the environment health is listed as Green, open the URL of the app. Choose Sign up today and enter the details.

  4. Look at the DynamoDB console to see the data represented in the database.

  5. Extra Credit: make your DynamoDB table a global table, replicating to the region of your choice