In this blog post, we will cover the below use cases.
What is AWS SAM.
One can find a huge detailed information in official documentation, here is the AWS link for the same.
I would like to share my level of short understanding with you, that can give you some idea of AWS SAM and it's respective components.
Before you directly jump into it, first know the must know stuffs from file and directory prospective.
- samconfig.toml : Configuration file that will be used during the SAM commands ( init, test, build, validate etc)
- template.yml : SAM template, similar to CloudFormation template to define Parameter, Resource, Metadata, Output, Mapping etc.
- events - Directory to store events for testing our Lambda code using events.json file.
- tests - Directory that contains the unit test files
Lab setup details -
- We will be deploying a Lambda Function with Python 3.7 runtime.
- Name of our sam application is sam-deployer_with_sam
- This is how our Lambda Function looks like in console and it's basic task is to check the status of port, ie Open or Closed
- Our files and templates follow the CICD approach, so we have kept our code for two environment
that is ( default, dev, uat )
Steps.
- Install AWS SAM CLI first.
- All tutorial you might have went through will ask you to go through the sam init, sam build and all, this blog is post is little baked one by using existing templates.
- Create a new directory to use in this project
$ mkdir lambda-deployer_with_sam
- Create a new files following the below directory structure layout
lambda-deployer_with_sam/
├── events
│ └── event.json
├── samconfig.toml
├── src
└── template.yaml
2 directories, 3 files
Here is the basic content to post in respective files.
Contents of samconfig.toml
version = 0.1
[default]
[default.deploy]
[default.deploy.parameters]
stack_name = "default-lambda-deployer-with-sam-Stack"
s3_bucket = "lambda-deployer-sam-bucket"
s3_prefix = "sam-lambda-stack"
region = "ap-south-1"
capabilities = "CAPABILITY_IAM"
disable_rollback = true
image_repositories = []
[dev]
[dev.deploy]
[dev.deploy.parameters]
stack_name = "dev-lambda-deployer-with-sam-Stack"
s3_bucket = "lambda-deployer-sam-bucket"
s3_prefix = "dev-sam-lambda-stack"
region = "ap-south-1"
capabilities = "CAPABILITY_IAM"
disable_rollback = true
image_repositories = []
parameter_overrides = "Environment=\"dev\""
[uat]
[uat.deploy]
[uat.deploy.parameters]
stack_name = "uat-lambda-deployer-with-sam-Stack"
s3_bucket = "lambda-deployer-sam-bucket"
s3_prefix = "uat-sam-lambda-stack"
region = "ap-south-1"
capabilities = "CAPABILITY_IAM"
disable_rollback = true
image_repositories = []
parameter_overrides = "Environment=\"uat\""
Lets understand the content of sam configuration file, that is samconfig.toml.
- This file will be used later during the deployment operation Lambda and it's respective resource.
- This file can be used to categorize environment specific paramters.
- The first line [ default ], [ dev ] , [uat]defines the name of the environment
- All the next lines coming after Second and Third Line [uat.deploy.parameters] is provide environment specifc paramters.
- parameter_overrides is the one, that is used to override the default parameter provided in the template.yml file, which is equivalent to cloudformation template.
AWSTemplateFormatVersion: '2010-09-09'
Transform: 'AWS::Serverless-2016-10-31'
Description: An AWS Serverless Specification template describing your function.
Parameters:
Environment:
Description: Please specify the target environment.
Type: String
Default: "dev"
AllowedValues:
- dev
- uat
AppName:
Description: Application name.
Type: String
Default: "find-port-status"
Mappings:
EnvironmentMap:
dev:
IAMRole: 'arn:aws:iam::897248824142:role/service-role/vpclambda-role-27w9b8uq'
uat:
IAMRole: 'arn:aws:iam::897248824142:role/service-role/vpclambda-role-27w9b8uq'
stg:
IAMRole: 'arn:aws:iam::897248824142:role/service-role/vpclambda-role-27w9b8uq'
Resources:
LambdabySam:
Type: 'AWS::Serverless::Function'
Properties:
FunctionName: !Sub 'ck-${Environment}-${AppName}'
Handler: lambda_function.lambda_handler
Runtime: python3.7
CodeUri: src/
Description: 'Lambda Created by SAM template'
MemorySize: 128
Timeout: 3
Role: !FindInMap [EnvironmentMap, !Ref Environment, IAMRole]
VpcConfig:
SecurityGroupIds:
- sg-a0f856da
SubnetIds:
- subnet-e9c898a5
- subnet-bdbb59d6
Environment:
Variables:
Name: !Sub 'ck-${Environment}-${AppName}'
Owner: CyberkeedaAdmin
Tags:
Name: !Sub 'ck-${Environment}-${AppName}'
Owner: CyberkeedaAdmin
Now, our last step is put our Lambda code into src diectory.
$ touch src/lambda_function.py
Contents of src/lambda_function.py
import json
import socket
def isOpen(ip,port):
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
try:
s.connect((ip, int(port)))
s.settimeout(1)
return True
except:
time.sleep(1)
return False
def lambda_handler(event, context):
if isOpen('142.250.195.196',443):
code = 200
else:
code = 500
return {
'statusCode': code,
'body': json.dumps("Port status")
}
Now, we have everything in place, let's deploy or Lambda code using SAM.
Initiate SAM build with respective environment, defined in samconfig.toml
$ sam build --config-env dev
Output will look, something like below.
Building codeuri: /home/kunal/aws_sam_work/lambda-deployer_with_sam/src runtime: python3.7 metadata: {} architecture: x86_64 functions: ['LambdabySam']
requirements.txt file not found. Continuing the build without dependencies.
Running PythonPipBuilder:CopySource
Build Succeeded
Built Artifacts : .aws-sam/build
Built Template : .aws-sam/build/template.yaml
Commands you can use next
=========================
[*] Invoke Function: sam local invoke
[*] Test Function in the Cloud: sam sync --stack-name {stack-name} --watch
[*] Deploy: sam deploy --guided
Now, we have build ready to be deployed.. let's initiate sam deploy.
$ sam deploy --config-env dev
Output will look, something like below.
Uploading to dev-sam-lambda-stack/dccfd91235d686ff0c5dcab3c4d44652 400 / 400 (100.00%)
Deploying with following values
===============================
Stack name : dev-lambda-deployer-with-sam-Stack
Region : ap-south-1
Confirm changeset : False
Disable rollback : True
Deployment s3 bucket : 9-bucket
Capabilities : ["CAPABILITY_IAM"]
Parameter overrides : {"Environment": "dev"}
Signing Profiles : {}
Initiating deployment
=====================
Uploading to dev-sam-lambda-stack/b6c26b6d535bf3b43f5b0bb71a88daa1.template 1627 / 1627 (100.00%)
Waiting for changeset to be created..
CloudFormation stack changeset
---------------------------------------------------------------------------------------------------------------------
Operation LogicalResourceId ResourceType Replacement
---------------------------------------------------------------------------------------------------------------------
+ Add LambdabySam AWS::Lambda::Function N/A
---------------------------------------------------------------------------------------------------------------------
Changeset created successfully. arn:aws:cloudformation:ap-south-1:897248824142:changeSet/samcli-deploy1646210098/97de1b9e-ed08-45fe-8e65-fb0c0928e8f7
2022-03-02 14:05:09 - Waiting for stack create/update to complete
CloudFormation events from stack operations
---------------------------------------------------------------------------------------------------------------------
ResourceStatus ResourceType LogicalResourceId ResourceStatusReason
---------------------------------------------------------------------------------------------------------------------
CREATE_IN_PROGRESS AWS::Lambda::Function LambdabySam -
CREATE_IN_PROGRESS AWS::Lambda::Function LambdabySam Resource creation Initiated
Initiate SAM build with respective environment, defined in samconfig.toml
CREATE_COMPLETE AWS::Lambda::Function LambdabySam -
CREATE_COMPLETE AWS::CloudFormation::Stack dev-lambda-deployer-with- -
sam-Stack
---------------------------------------------------------------------------------------------------------------------
Successfully created/updated stack - dev-lambda-deployer-with-sam-Stack in ap-south-1
This step, will create the required services and it's respective configuration, confirm the same from lambda console, this is how it looks like.
Please note, every time we make any changes in lambda_function.py file, we need to re-build and deploy.
That's in this post, we will know later in next post about below stuffs.
- How to delete Lambda Function created using AWS SAM
- How to integrate AWS SAM with Docker.
- How to create a continuous integration pipeline with Jenkins, GitHub, Docker and SAM.