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

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

本教程向您展示如何使用创建基本 Amazon Lambda 函数 Amazon CloudFormation。您将使用 Amazon CloudFormation 控制台和 YAML 模板来创建堆栈（IAM 角色、Lambda 函数和状态机）。然后，您将使用 Amazon Step Functions 控制台开始执行状态机。

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

主题

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

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

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

为 Lambda 创建 IAM 角色

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

创建 Lambda 函数

为将打印 Hello World 消息的 Lambda 函数定义以下属性。

重要

确保您的 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 状态机

了解 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 控制台并选择创建堆栈。
在选择模板页面上，选择将模板上传到 Amazon S3。选择您的 MyStateMachine 文件，然后选择下一步。
在指定详细信息页面上，为堆栈名称输入 MyStateMachine，然后选择下一步。
在选项页面上，选择下一步。
在审核页面上，选择我确认， Amazon CloudFormation 可能创建 IAM 资源。，然后选择创建。

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

第 3 步：启动状态机执行

在创建您的 Lambda 状态机后，可以开始执行。

启动状态机执行

打开 Step Functions 控制台，然后选择你使用创建的状态机的名称 Amazon CloudFormation。
在 MyStateMachine-ABCDEFGHIJ1 K 页面上，选择 “新建执行”。

此时将显示新执行页面。
（可选）要识别您的执行，您可以在名称框中为其指定一个名称。默认情况下，Step Functions 会自动生成一个唯一的执行名称。

注意
Step Functions 允许您为状态机、执行和活动创建名称，以及包含非 ASCII 字符的标签。这些非 ASCII 名称不适用于亚马逊。 CloudWatch为确保您可以跟踪 CloudWatch 指标，请选择仅使用 ASCII 字符的名称。
选择启动执行。

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

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

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

使用 Application Composer 中的 Workflow Studio

使用 Amazon CDK 创建一个 Lambda 状态机

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

主题

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

主题

为 Lambda 创建 IAM 角色

创建 Lambda 函数

重要

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

创建 Lambda 状态机

步骤 2：使用 Amazon CloudFormation 模板创建 Lambda 状态机

创建 Lambda 状态机

第 3 步：启动状态机执行

启动状态机执行

注意