第 1 步：设置您的Amazon CloudFormation模板第 2 步：使用Amazon CloudFormation用于创建 Lambda 状态机的模板第 3 步：启动状态机执行

使用为 Step Functions 创建 Lambda 状态机Amazon CloudFormation

本教程向您展示如何使用 Amazon CloudFormation 创建基本 Amazon Lambda 函数。您会使用Amazon CloudFormation控制台和一个 YAML模板创建堆（IAM 角色、Lambda 函数和状态机）。然后、你会使用Amazon Step Functions控制台以启动状态机执行。

有关更多信息，请参阅。使用 CloudFormation 模板和AWS::StepFunctions::StateMachine中的资源Amazon CloudFormation用户指南.

主题

第 1 步：设置您的Amazon CloudFormation模板
第 2 步：使用Amazon CloudFormation用于创建 Lambda 状态机的模板
第 3 步：启动状态机执行

第 1 步：设置您的Amazon CloudFormation模板

在使用示例模板之前，您应该了解如何声明 Amazon CloudFormation 模板的不同部分。

主题

为 Lambda 创建 IAM 角色
创建 Lambda 函数
创建用于状态机执行的 IAM 角色
创建 Lambda 状态机

为 Lambda 创建 IAM 角色

定义与 Lambda 函数的 IAM 角色关联的信任策略。以下示例使用 YAML 或 JSON 定义信任策略。

创建 Lambda 函数

定义以下属性对于Lambda 函数将打印消息Hello World.

重要

确保您的 Lambda 函数处于相同之下Amazon账户和Amazon区域作为状态机。

创建用于状态机执行的 IAM 角色

定义与状态机执行的 IAM 角色关联的信任策略。

YAML


StatesExecutionRole:
  Type: "AWS::IAM::Role"
  Properties:
    AssumeRolePolicyDocument:
      Version: "2012-10-17"
      Statement:
        - Effect: "Allow"
          Principal:
            Service:
              - !Sub states.${AWS::Region}.amazonaws.com
          Action: "sts:AssumeRole"
    Path: "/"
    Policies:
      - PolicyName: StatesExecutionPolicy
        PolicyDocument:
          Version: "2012-10-17"
          Statement:
            - Effect: Allow
              Action:
                - "lambda:InvokeFunction"
              Resource: "*"

JSON


        "StatesExecutionRole": {
            "Type": "AWS::IAM::Role",
            "Properties": {
                "AssumeRolePolicyDocument": {
                    "Version": "2012-10-17",
                    "Statement": [
                        {
                            "Effect": "Allow",
                            "Principal": {
                                "Service": [
                                    {
                                        "Fn::Sub": "states.${AWS::Region}.amazonaws.com"
                                    }
                                ]
                            },
                            "Action": "sts:AssumeRole"
                        }
                    ]
                },
                "Path": "/",
                "Policies": [
                    {
                        "PolicyName": "StatesExecutionPolicy",
                        "PolicyDocument": {
                            "Version": "2012-10-17",
                            "Statement": [
                                {
                                    "Effect": "Allow",
                                    "Action": [
                                        "lambda:InvokeFunction"
                                    ],
                                    "Resource": "*"
                                }
                            ]
                        }
                    }
                ]
            }
        },

创建 Lambda 状态机

定义 Lambda 状态机。

第 2 步：使用Amazon CloudFormation用于创建 Lambda 状态机的模板

Once你了解组件的Amazon CloudFormation您模板能够将它们放在一起，然后使用模板创建Amazon CloudFormation堆栈。

创建 Lambda 状态机

将以下示例数据复制到名为 MyStateMachine.yaml（适用于 YAML 示例）或 MyStateMachine.json（适用于 JSON）的文件中。

YAML


AWSTemplateFormatVersion: "2010-09-09"
Description: "An example template with an IAM role for a Lambda state machine."
Resources:
  LambdaExecutionRole:
    Type: "AWS::IAM::Role"
    Properties:
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service: lambda.amazonaws.com
            Action: "sts:AssumeRole"

  MyLambdaFunction:
    Type: "AWS::Lambda::Function"
    Properties:
      Handler: "index.handler"
      Role: !GetAtt [ LambdaExecutionRole, Arn ]
      Code:
        ZipFile: |
          exports.handler = (event, context, callback) => {
              callback(null, "Hello World!");
          };
      Runtime: "nodejs12.x"
      Timeout: "25"

  StatesExecutionRole:
    Type: "AWS::IAM::Role"
    Properties:
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: "Allow"
            Principal:
              Service:
                - !Sub states.${AWS::Region}.amazonaws.com
            Action: "sts:AssumeRole"
      Path: "/"
      Policies:
        - PolicyName: StatesExecutionPolicy
          PolicyDocument:
            Version: "2012-10-17"
            Statement:
              - Effect: Allow
                Action:
                  - "lambda:InvokeFunction"
                Resource: "*"

  MyStateMachine:
    Type: "AWS::StepFunctions::StateMachine"
    Properties:
      DefinitionString:
        !Sub
          - |-
            {
              "Comment": "A Hello World example using an Amazon Lambda function",
              "StartAt": "HelloWorld",
              "States": {
                "HelloWorld": {
                  "Type": "Task",
                  "Resource": "${lambdaArn}",
                  "End": true
                }
              }
            }
          - {lambdaArn: !GetAtt [ MyLambdaFunction, Arn ]}
      RoleArn: !GetAtt [ StatesExecutionRole, Arn ]

JSON


{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "An example template with an IAM role for a Lambda state machine.",
    "Resources": {
        "LambdaExecutionRole": {
            "Type": "AWS::IAM::Role",
            "Properties": {
                "AssumeRolePolicyDocument": {
                    "Version": "2012-10-17",
                    "Statement": [
                        {
                            "Effect": "Allow",
                            "Principal": {
                                "Service": "lambda.amazonaws.com"
                            },
                            "Action": "sts:AssumeRole"
                        }
                    ]
                }
            }
        },
        "MyLambdaFunction": {
            "Type": "AWS::Lambda::Function",
            "Properties": {
                "Handler": "index.handler",
                "Role": {
                    "Fn::GetAtt": [
                        "LambdaExecutionRole",
                        "Arn"
                    ]
                },
                "Code": {
                    "ZipFile": "exports.handler = (event, context, callback) => {\n    callback(null, \"Hello World!\");\n};\n"
                },
                "Runtime": "nodejs12.x",
                "Timeout": "25"
            }
        },
        "StatesExecutionRole": {
            "Type": "AWS::IAM::Role",
            "Properties": {
                "AssumeRolePolicyDocument": {
                    "Version": "2012-10-17",
                    "Statement": [
                        {
                            "Effect": "Allow",
                            "Principal": {
                                "Service": [
                                    {
                                        "Fn::Sub": "states.${AWS::Region}.amazonaws.com"
                                    }
                                ]
                            },
                            "Action": "sts:AssumeRole"
                        }
                    ]
                },
                "Path": "/",
                "Policies": [
                    {
                        "PolicyName": "StatesExecutionPolicy",
                        "PolicyDocument": {
                            "Version": "2012-10-17",
                            "Statement": [
                                {
                                    "Effect": "Allow",
                                    "Action": [
                                        "lambda:InvokeFunction"
                                    ],
                                    "Resource": "*"
                                }
                            ]
                        }
                    }
                ]
            }
        },
        "MyStateMachine": {
            "Type": "AWS::StepFunctions::StateMachine",
            "Properties": {
                "DefinitionString": {
                    "Fn::Sub": [
                        "{\n  \"Comment\": \"A Hello World example using an AWS Lambda function\",\n  \"StartAt\": \"HelloWorld\",\n  \"States\": {\n    \"HelloWorld\": {\n      \"Type\": \"Task\",\n      \"Resource\": \"${lambdaArn}\",\n      \"End\": true\n    }\n  }\n}",
                        {
                            "lambdaArn": {
                                "Fn::GetAtt": [
                                    "MyLambdaFunction",
                                    "Arn"
                                ]
                            }
                        }
                    ]
                },
                "RoleArn": {
                    "Fn::GetAtt": [
                        "StatesExecutionRole",
                        "Arn"
                    ]
                }
            }
        }
    }
}

打开 Amazon CloudFormation 控制台并选择创建堆栈。
在 Select Template (选择模板) 页面上，选择 Upload a template to Amazon S3 (将模板上传到 Amazon S3)。选择您的 MyStateMachine 文件，然后选择 Next。
在指定详细信息页面上，为堆栈名称输入 MyStateMachine，然后选择下一步。
在 Options (选项) 页面上，选择 Next (下一步)。
在存储库的审核页面，选择我承认Amazon CloudFormation可能会创建 IAM 资源。然后选择Create.

Amazon CloudFormation 开始创建 MyStateMachine 堆栈，并显示 CREATE_IN_PROGRESS 状态。在此过程完成后，Amazon CloudFormation 将显示 CREATE_COMPLETE 状态。
(可选) 要显示您的堆栈中的资源，请选择堆栈，然后选择 Resources 选项卡。

第 3 步：启动状态机执行

在创建 Lambda 状态机后，能够开始它的执行。

启动状态机执行

打开Step Functions 控制然后选择您使用创建的状态机的名称Amazon CloudFormation.
在 MyStateMachine-ABCDEFGHIJ1K 页面上，选择 New execution。

此时将显示 New execution 页面。
（可选）为了帮助识别您的执行，您可以在输入执行名称。如果未输入 ID，Step Functions 将自动生成一个唯一 ID。

注意
Step Functions 允许您创建包含非 ASCII 字符的状态机、执行和活动名称。这些非 ASCII 名称不适用于 Amazon CloudWatch。为确保您可以跟踪 CloudWatch 指标，请选择仅使用 ASCII 字符的名称。
选择 Start Execution (开始执行)。

此时将启动新的状态机执行，并显示一个说明正在运行的执行的新页面。
（可选）在 Execution Details (执行详细信息) 中，查看 Execution Status (执行状态) 以及 Started (已开始) 和 Closed (已关闭) 时间戳。
要查看执行结果，请选择 Output。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

Step Functions 和Amazon SAM

使用创建 Lambda 状态机Amazon CDK