Testing Serverless with SAM CLI and LocalStack

Testing Serverless with SAM CLI and LocalStack

Transcript

1. 31.10.2018, AWS Usergroup Dortmund
 SAM CLI and Localstack How to test Serverless?
 Daniel Rosowski Smartsquare GmbH
2. Software Developer CTO @ Smartsquare Cloud Aficionado DanielRosowski rosowski@smartsquare.de Bielefeld www.smartsquare.de
3. @DanielRosowski Happy Halloween! !3
4. @DanielRosowski Agenda • Theorie • Serverless • AWS SAM • AWS SAM CLI • Localstack • Demo! !4
5. @DanielRosowski Serverless !5
6. @DanielRosowski !6 Infrastructure (as a Service) Platform (as a Service) Container (as a Service) Function (as a Service) Server Storage Network Virtualisation Operating System Runtime Environment Application Server Storage Network Virtualisation Operating System Runtime Environment Application Functions Functions Server Storage Network Virtualisation Operating System Runtime Environment Application Functions Server Storage Network Virtualisation Operating System Runtime Environment Application Functions
7. @DanielRosowski !7 Bare Metal Virtualisation Container Functions Utilisation Cost
8. @DanielRosowski !8 Event Function Any Service Changes in 
 data store
 (i.e. DynamoDB) Request to
 endpoint Change in resource
 (i.e. S3) • Node • Python • Java • C#
9. @DanielRosowski !9 exports.handler = (event, context, callback) => { // Succeed with the string "Hello World!" callback(null, "Hello World!"); }; NodeJS 6.10
10. @DanielRosowski !10 Database Load Balancer Message Queue E-Mail Storage Monitoring API Gateway
11. @DanielRosowski AWS Serverless Application Model !11
12. @DanielRosowski SAM !12 CloudFormation Stack CloudFormation is based on is defined in CloudFormation
 Template is deployed in
13. @DanielRosowski !13 AWSTemplateFormatVersion: '2010-09-09' Transform: 'AWS::Serverless-2016-10-31' Resources: MyFunction: Type: 'AWS::Serverless::Function' Properties: Handler: index.handler Runtime: nodejs6.10 CodeUri: 's3://my-bucket/function.zip' sam_template.yml
14. @DanielRosowski !14 { "Resources": { "MyServerlessFunctionLogicalID": { "Type": "AWS::Lambda::Function", "Properties": { "Handler": "index.handler", "Code": { "S3Bucket": „my-bucket“, "S3Key": „function.zip" }, "Role": { "Fn::GetAtt": ["FunctionNameRole", "Arn"] }, "Runtime": „nodejs6.10" } }, "FunctionNameRole": { "Type": "AWS::IAM::Role", "Properties": { "ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"], "AssumeRolePolicyDocument": { "Version": "2012-10-17", "Statement": [{ "Action": ["sts:AssumeRole"], "Effect": "Allow", "Principal": { "Service": ["lambda.amazonaws.com"] } }] } } } } } cloudformation_template.json
15. @DanielRosowski !15 MyFunction: Type: 'AWS::Serverless::Function' Properties: FunctionName: MyFunction Handler: index.handler Runtime: nodejs6.10 Timeout: 180 MemorySize: 128 Events: SomethingUploaded: Type: S3 Properties: Bucket: bucket-4711 Events: s3:ObjectCreated:* Events: SomethingChanged: Type: DynamoDB Properties: Stream: arn:aws:dynamodb:… StartingPosition: LATEST MySNSTopic: Type: AWS::SNS::Topic Properties: Subscription: - Endpoint: "nobody@nowhere.org" Protocol: email MyQueue: Type: AWS::SQS::Queue Properties: VisibilityTimeout: 30
16. @DanielRosowski SAM CLI !16 BETA
17. @DanielRosowski Main Features • Develop and test your Lambda functions locally with sam local and Docker • Invoke functions from known event sources such as Amazon S3, Amazon DynamoDB, Amazon Kinesis Streams, etc. • Start local API Gateway from a SAM template, and quickly iterate over your functions with hot-reloading • Validate SAM templates • Get started with boilerplate Serverless Service in your chosen Lambda Runtime !17
18. @DanielRosowski !18 uses
19. @DanielRosowski LocalStack !19 A fully functional local AWS cloud stack. Develop and test your cloud apps offline!
20. @DanielRosowski !20 Source: https://localstack.cloud
21. @DanielRosowski Implementation Coverage !21 25 50 75 100 SES SSM G lacier O psw orks Route53 S3 CloudForm ation D ynam oD B API G atew ay KM S Logs IoT O rganizsations ECR Secretsm anager ELB EC2 ACM Redshift D ata Pipeline STS Autoscaling IAM SN S EM R CloudW atch Kinesis SW F Staging API SQ S ELBv2 Polly ECS Batch Events Source: https://github.com/spulec/moto/blob/master/IMPLEMENTATION_COVERAGE.md
22. @DanielRosowski Sample Coverage !22 Source: https://github.com/spulec/moto/blob/master/IMPLEMENTATION_COVERAGE.md
23. @DanielRosowski !23
24. @DanielRosowski JUnit Integration !24 ... import cloud.localstack.LocalstackTestRunner; import cloud.localstack.TestUtils; @RunWith(LocalstackTestRunner.class) public class MyCloudAppTest { @Test public void testLocalS3API() { AmazonS3 s3 = TestUtils.getClientS3() List<Bucket> buckets = s3.listBuckets(); ... } } @ExtendWith(LocalstackExtension.class) public class MyCloudAppTest { } JUnit 4 JUnit 5
25. @DanielRosowski JUnit Docker !25 @RunWith(LocalstackDockerTestRunner.class) @LocalstackDockerProperties(randomizePorts = true, services = { "sqs", "kinesis:77077" }) public class MyDockerCloudAppTest { @Test public void testKinesis() { AmazonKinesis kinesis = DockerTestUtils.getClientKinesis(); ListStreamsResult streams = kinesis.listStreams(); ... @ExtendWith(LocalstackDockerExtension.class) @LocalstackDockerProperties(randomizePorts = true, services = { "sqs", "kinesis:77077" }) public class MyCloudAppTest { } JUnit 4 JUnit 5
26. @DanielRosowski Demo in case of emergency, continue with slides :-) !26
27. @DanielRosowski !27
28. @DanielRosowski !28
29. @DanielRosowski !29
30. @DanielRosowski !30
31. @DanielRosowski !31
32. @DanielRosowski !32 awslocal is a small wrapper that appends —endpoint localhost to every aws call ℹ
33. @DanielRosowski !33
34. @DanielRosowski !34
35. Thank you very much! DanielRosowski rosowski@smartsquare.de www.smartsquare.de
36. @DanielRosowski Links • https://github.com/awslabs/serverless-application-model • https://github.com/awslabs/aws-sam-cli • https://github.com/localstack/localstack • Tutorials • https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-test-and- debug.html • https://aws.amazon.com/de/blogs/aws/aws-serverless-application-model-sam-command-line-interface-build- test-and-debug-serverless-apps-locally/ • Sample Projects • https://github.com/smartsquare/wecky-web • https://github.com/smartsquare/wecky-crawl • https://github.com/smartsquare/wecky-capture/ • https://github.com/smartsquare/wecky-notify !36