This page outlines how to set up your machine to attend Gojko's serverless coding workshop. It's very important to do this upfront so that we can use the time together effectively. Expect the setup to take 10-20 minutes, and contact [email protected] before the workshop if you're having trouble with any of the tests below.
- Node.js 6 or 8
- NPM 3 or higher
- AWS Command line tools
- SAM Command line tools
- git (ideally command line tools, but any client will do)
- a code editor (any will do, but something with JavaScript support will speed things up)
Register for an AWS account upfront if you don't already have one. To use Lambda, you'll need a verified account (typically using phone verification). The stuff we'll do will fit into the free account allowance, so you will not need to pay AWS anything for the workshop, but you will still need an account. Register at aws.amazon.com/
If you do not want to use the access credentials for your main user account, but want to set up a separate user profile for the camp, assign the following roles to the user:
If you have a company AWS account and intend to use it during the workshop, please make sure that you have access rights specified above.
Configure AWS Command Line tools to work with your credentials. If you do not want to use your primary account, set up a separate profile for the workshop account.
The following commands should all work OK, without throwing errors (add --profile <PROFILE NAME> to the commands if you want to use a specific profile for AWS access):
- Set up a simple IAM role (get the policy.json file from this repository and put it in the local directory where this command is executed)
aws iam create-role --role-name=hello-world-role --assume-role-policy-document file://policy.json --query Role.Arn --output text- Wait about 10 seconds, then use the result printed by the previous command instead of
<ROLE>in the command below, to set up a simple Lambda function (get the test-lambda.zip file from this repository and put it in the local directory where this command is executed).
aws lambda create-function --function-name hello-world-function --role <ROLE> --runtime nodejs8.10 --handler main.handler --zip-file fileb://test-lambda.zip - set up a simple API interface:
aws apigateway create-rest-api --name test-api