{"id":1881,"date":"2019-04-18T14:46:21","date_gmt":"2019-04-18T04:46:21","guid":{"rendered":"https:\/\/developers.messagemedia.com\/?p=1881"},"modified":"2019-04-18T14:46:21","modified_gmt":"2019-04-18T04:46:21","slug":"an-introduction-to-aws-step-functions","status":"publish","type":"blog","link":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/","title":{"rendered":"An Introduction to AWS Step Functions"},"content":{"rendered":"

This is a guest blog from Lini Abraham<\/a>, an Automation Test Analyst at MessageMedia.<\/p>\n

Lini is working as a QA Engineer in MessageMedia.She is curious to learn and experiment new technologies.\u00a0<\/em>Working in a highly ambitious and flexible team has enabled her to work on development tasks along with testing.\u00a0<\/em>She also loves travelling and exploring new places with her family.<\/em><\/p><\/blockquote>\n

AWS Step functions are one among the current 90 and ever-growing services offerings by Amazon Web Services. It’s much the same as a state machine where a system has multiple states and the output of the previous state serves as the input for the next state. This article is will give you a basic idea to build a simple step function on the AWS Console.<\/p>\n

In your applications, there might be scenarios where there are ‘n’ number of states or steps and for a process or job to be completed, it has to traverse through these states. Step functions lets you build visual workflows to coordinate different activities in your applications. The implementation of each step can be accomplished using AWS Lambda which is a server-less computing platform provided by AWS. Building server-less applications means that you can focus on your code instead of worrying about managing and operating servers or runtimes as it’s taken care of by the cloud provider. It’s a pay-as-you-go model where you only pay for the duration and memory allocated to run your code; without any associated fees for idle time.<\/p>\n

Step functions are defined in JSON format using AWS States Language (ASL) (AWS Documentation: https:\/\/states-language.net\/spec.html). The state machine can be validated and visualised as a workflow (similar to a flowchart) on AWS Console by providing the JSON definition.<\/p>\n

The best way to learn something is through practice. So, let\u2019s create a simple step function with only one state.<\/p>\n

AWS Documentation to create a state machine can be found here<\/a>.<\/p>\n

Pre-requisites for creating the state machine<\/h2>\n

You’ll need an AWS account and access to your AWS console.<\/p>\n

Step 1: Create the IAM Role which lets Lambda function write logs to Cloud Watch<\/h3>\n

Navigate to AWS IAM > Create Role > AWS Service > Choose Lambda > \u201dNext: Permissions\u201d > filter and select the policy “CloudWatchLogsFullAccess” > \u201d Next: Tags\u201d > \u201dNext: Review\u201d \uf0e0> Provide the role name as \u201clambda_cloudwatch_access\u201c > Create Role.<\/p>\n

Step 2: Create a Lambda Function from AWS Console using Python 3.6 runtime<\/h3>\n

(For more information regarding creating a Lambda on AWS console, refer to the AWS documentation here<\/a>.)<\/p>\n

On AWS Management Console, navigate to \u201cLambda\u201d service > Create Function > Choose \u201cAuthor from scratch\u201d > Provide the function name as SayHello with runtime as Python 3.6 > Click on Choose or create an execution role under \u201cPermissions\u201d and select \u201cChoose an existing role\u201d from the drop-down and provide the role name lambda_cloudwatch_access > Click on Create function button.<\/p>\n

\"\"<\/p>\n

Copy the below code and paste it in Lambda code section. The below function will get the name field from its input event and returns ‘Hello ‘ + as the output.<\/p>\n

def lambda_handler (event, context):\nname = event['name']\nreturn 'Hello ' + name<\/pre>\n
Click on \u201cSave\u201d button at the top of the console and note the ARN of the lambda which will be used inside the Step Function definition. The ARN looks like this:<\/p>\n
arn:aws:lambda:<aws_region>:<aws_account_id>:function:SayHello<\/pre>\n
Step 3: Create the IAM role to grant access to Step Function to execute Lambda Function<\/h3>\n
The step function that we create later in this tutorial requires permission to execute the \u201cSayHello\u201d lambda function.<\/p>\n
On AWS Console select IAM > Create Role > AWS Service > Choose Step Function > Click on \u201cNext: Permissions\u201d button >
\n\u201cAWSLambdaFullAccess\u201d permission is displayed by default > Next: Tags > Next: Review > Provide the role name as \u201cstepfunction_lambda_access > Click on Create Role<\/p>\n
Once you have created the role, note the role ARN to use it while creating the step function.<\/p>\n
Step 4: Create an AWS Step Function (State Machine)<\/h3>\n
In the AWS <\/a>documentation, the state machine is created by selecting Templates<\/strong>\u00a0which lets you build it from existing templates. In order to create a step function from scratch, choose Author with code snippets\u00a0<\/strong>instead (Refer to the below screenshot), name it as ‘SayHello’ and paste the state machine definition.<\/p>\n
\"\"<\/p>\n
In this example, we will use the below definition written using Amazon States Language.
\nNote: Replace the value of \u201cResource\u201d key with the ARN of SayHello lambda function created earlier<\/p>\n
{\n\"StartAt\":\"SayHello\",\n\"Comment\":\"An example of a state machine with Task state\",\n\"States\":{\n\"SayHello\":{\n\"Type\":\"Task\",\n\"Resource\":\"\",\n\"End\":true\n}\n}\n}<\/pre>\n
After pasting the definition, click \u201cNext\u201d and \u201cChoose an existing IAM role\u201d and provide the ARN of the role we created to grant lambda execution access to Step Function. Then click on Create state machine button.<\/p>\n
Step Function mandatory and optional fields<\/h4>\n
Mandatory fields: startAt, States
\nMandatory fields of a state with Type =\u201d Task\u201d: Resource, End\/Next
\nOptional: Comment<\/p>\n
Let’s take a deep-dive into the JSON definition:<\/p>\n
StartAt:<\/em> The name of the state from which you expect the workflow to begin with
\nStates Object:<\/em> All the different states in the step function and their attributes go in here
\nSayHello:<\/em> Name of the state<\/p>\n
Type:<\/em> AWS supports 7 types of states
\n<\/u><\/p>\n
    \n
  • Task – Performs a specific action<\/li>\n
  • Choice – Lets you add and evaluate conditions<\/li>\n
  • Parallel – Carries out actions in parallel<\/li>\n
  • Wait – Adds delay for a certain amount of time specified<\/li>\n
  • Fail – Terminates a step function execution resulting in a failure<\/li>\n
  • Succeed- Ends an execution successfully<\/li>\n
  • Pass – Passes the input of the state and extra parameters to its output<\/li>\n<\/ul>\n
    Resource<\/em>: The Amazon Resource Name (ARN) of your Lambda function
    \nEnd:<\/em> Any state except for Choice, Succeed, and Fail must have a field named \u201cEnd\u201d whose value is a Boolean if that is the final state of the step function<\/p>\n
    If there is more than one state, then the states must have either “next”: “name of the next state” if it’s followed by another state or “end”: true if it’s the last state (except for Choice, Succeed, and Fail states).<\/p>\n
    Step 5: Running your Step Function<\/h3>\n
    To execute your step function, navigate to Step functions on AWS console and choose the step function you created.
    \nIn the \u201cExecutions\u201d tab, click on Start execution button, specify an execution name and provide the input as below<\/p>\n
    {\n\"name\": \"Input your name here\"\n}<\/pre>\n
    Once you hit start execution button, you will be able to see your state machine getting executed and the colour of the state changes to green if it succeeds (blue while it\u2019s being executed).
    \nClick on the state to see it\u2019s input and output and exception if the state execution fails in which case, the state is represented in red colour. The input and output for the sayHello state is as follows:<\/p>\n
    input: {\n\"name\": \"the name you entered\"\n}\noutput: \"Hello \"the name you entered\"<\/pre>\n
    Conclusion<\/h2>\n
    So now you have learned to create a Step function. You understand the lambda function which runs the implementation code behind the \u201ctask\u201d state of the step function, IAM roles for the Step function to execute the lambda function and lambda to output logs to Cloud watch.<\/p>\n
    In real-time scenarios where you have complex interrelated states which perform single or parallel actions and evaluates decisions, you can orchestrate them programmatically using step functions and serverless technologies in an efficient manner. There will be many advancements and expansions in step functions and the serverless world in the forthcoming years and it will be exciting to see the evolution.<\/p>\n","protected":false},"author":0,"featured_media":8917,"menu_order":186,"template":"page-blog-v2.php","meta":{"_acf_changed":false,"popular":false,"coming_soon":false,"link":"","footnotes":""},"blog_category":[37],"class_list":["post-1881","blog","type-blog","status-publish","has-post-thumbnail","hentry","blog_category-developers"],"acf":[],"yoast_head":"\nAn Introduction to AWS Step Functions - Sinch MessageMedia Australia<\/title>\n<meta name=\"description\" content=\"Discover how Step Functions revolutionize your workflow orchestration, offering seamless integration, scalability, and reliability. Dive into the fundamentals, explore use cases, and unlock the potential of serverless architecture. Australia\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"An Introduction to AWS Step Functions - Sinch MessageMedia\" \/>\n<meta property=\"og:description\" content=\"Discover how Step Functions revolutionize your workflow orchestration, offering seamless integration, scalability, and reliability. Dive into the fundamentals, explore use cases, and unlock the potential of serverless architecture.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/\" \/>\n<meta property=\"og:site_name\" content=\"Sinch MessageMedia\" \/>\n<meta property=\"og:image\" content=\"https:\/\/messagemedia.com\/wp-content\/uploads\/2019\/04\/An-Introduction-to-AWS-Step-Functions.png\" \/>\n\t<meta property=\"og:image:width\" content=\"919\" \/>\n\t<meta property=\"og:image:height\" content=\"288\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/\",\"name\":\"An Introduction to AWS Step Functions - Sinch MessageMedia\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/An-Introduction-to-AWS-Step-Functions.png\",\"datePublished\":\"2019-04-18T04:46:21+00:00\",\"description\":\"Discover how Step Functions revolutionize your workflow orchestration, offering seamless integration, scalability, and reliability. Dive into the fundamentals, explore use cases, and unlock the potential of serverless architecture.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/#breadcrumb\"},\"inLanguage\":\"en-AU\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-AU\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/#primaryimage\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/An-Introduction-to-AWS-Step-Functions.png\",\"contentUrl\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2019\\\/04\\\/An-Introduction-to-AWS-Step-Functions.png\",\"width\":919,\"height\":288,\"caption\":\"An Introduction to AWS Step Functions\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/an-introduction-to-aws-step-functions\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Blog\",\"item\":\"https:\\\/\\\/messagemedia.com\\\/us\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"An Introduction to AWS Step Functions\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#website\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/\",\"name\":\"Sinch MessageMedia\",\"description\":\"Business SMS & Messaging Platform\",\"publisher\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-AU\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#organization\",\"name\":\"Sinch MessageMedia\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-AU\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/logo-mm-sinch.svg\",\"contentUrl\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/logo-mm-sinch.svg\",\"width\":1,\"height\":1,\"caption\":\"Sinch MessageMedia\"},\"image\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"An Introduction to AWS Step Functions - Sinch MessageMedia Australia","description":"Discover how Step Functions revolutionize your workflow orchestration, offering seamless integration, scalability, and reliability. Dive into the fundamentals, explore use cases, and unlock the potential of serverless architecture. Australia","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/","og_locale":"en_US","og_type":"article","og_title":"An Introduction to AWS Step Functions - Sinch MessageMedia","og_description":"Discover how Step Functions revolutionize your workflow orchestration, offering seamless integration, scalability, and reliability. Dive into the fundamentals, explore use cases, and unlock the potential of serverless architecture.","og_url":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/","og_site_name":"Sinch MessageMedia","og_image":[{"width":919,"height":288,"url":"https:\/\/messagemedia.com\/wp-content\/uploads\/2019\/04\/An-Introduction-to-AWS-Step-Functions.png","type":"image\/png"}],"twitter_card":"summary_large_image","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/","url":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/","name":"An Introduction to AWS Step Functions - Sinch MessageMedia","isPartOf":{"@id":"https:\/\/messagemedia.com\/au\/#website"},"primaryImageOfPage":{"@id":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/#primaryimage"},"image":{"@id":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/#primaryimage"},"thumbnailUrl":"https:\/\/messagemedia.com\/wp-content\/uploads\/2019\/04\/An-Introduction-to-AWS-Step-Functions.png","datePublished":"2019-04-18T04:46:21+00:00","description":"Discover how Step Functions revolutionize your workflow orchestration, offering seamless integration, scalability, and reliability. Dive into the fundamentals, explore use cases, and unlock the potential of serverless architecture.","breadcrumb":{"@id":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/#breadcrumb"},"inLanguage":"en-AU","potentialAction":[{"@type":"ReadAction","target":["https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/"]}]},{"@type":"ImageObject","inLanguage":"en-AU","@id":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/#primaryimage","url":"https:\/\/messagemedia.com\/wp-content\/uploads\/2019\/04\/An-Introduction-to-AWS-Step-Functions.png","contentUrl":"https:\/\/messagemedia.com\/wp-content\/uploads\/2019\/04\/An-Introduction-to-AWS-Step-Functions.png","width":919,"height":288,"caption":"An Introduction to AWS Step Functions"},{"@type":"BreadcrumbList","@id":"https:\/\/messagemedia.com\/au\/blog\/an-introduction-to-aws-step-functions\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/messagemedia.com\/au\/"},{"@type":"ListItem","position":2,"name":"Blog","item":"https:\/\/messagemedia.com\/us\/blog\/"},{"@type":"ListItem","position":3,"name":"An Introduction to AWS Step Functions"}]},{"@type":"WebSite","@id":"https:\/\/messagemedia.com\/au\/#website","url":"https:\/\/messagemedia.com\/au\/","name":"Sinch MessageMedia","description":"Business SMS & Messaging Platform","publisher":{"@id":"https:\/\/messagemedia.com\/au\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/messagemedia.com\/au\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-AU"},{"@type":"Organization","@id":"https:\/\/messagemedia.com\/au\/#organization","name":"Sinch MessageMedia","url":"https:\/\/messagemedia.com\/au\/","logo":{"@type":"ImageObject","inLanguage":"en-AU","@id":"https:\/\/messagemedia.com\/au\/#\/schema\/logo\/image\/","url":"https:\/\/messagemedia.com\/wp-content\/uploads\/2024\/03\/logo-mm-sinch.svg","contentUrl":"https:\/\/messagemedia.com\/wp-content\/uploads\/2024\/03\/logo-mm-sinch.svg","width":1,"height":1,"caption":"Sinch MessageMedia"},"image":{"@id":"https:\/\/messagemedia.com\/au\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog\/1881","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog"}],"about":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/types\/blog"}],"version-history":[{"count":0,"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog\/1881\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/media\/8917"}],"wp:attachment":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/media?parent=1881"}],"wp:term":[{"taxonomy":"blog_category","embeddable":true,"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog_category?post=1881"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}