AWS Step Functions
開発者ガイド

ご利用開始にあたって

このチュートリアルでは、AWS Step Functions の基本操作について説明します。開始するには、独立して動作し、Pass 状態を使用する、シンプルなステートマシンを作成します。Pass 状態は no-op (オペレーションのない命令) を表します。

Step Functions には、さまざまな定義済みステートマシンがテンプレートとして用意されています。Hello World テンプレートを使用して、最初のステートマシンを作成します。

ステートマシンを作成する

  1. AWS マネジメントコンソールにサインインし、https://console.aws.amazon.com/states/home?#/statemachines/create で Step Functions コンソールを開きます。

  2. [Define state machine (ステートマシンの定義)] ページで、[テンプレート]、[Hello world] の順に選択します。[State machine definition (ステートマシン定義)] と視覚的なワークフローを確認します。

    
            Hello world

    Step Functions によって、ステートマシンの名前が自動的に入力されます。また、[Code] ペインに、ステートマシンの Amazon ステートメント言語 記述が挿入されます。

    この JSON テキストは HelloWorld という名前の Pass 状態を定義します。詳細については、「State Machine Structure」を参照してください。

    { "Comment": "A Hello World example of the Amazon States Language using a Pass state", "StartAt": "HelloWorld", "States": { "HelloWorld": { "Type": "Pass", "Result": "Hello World!", "End": true } } }
  3. [Visual Workflow] のグラフを使用して、Amazon ステートメント言語 コードでステートマシンが正しく記述されていることを確認します。

    グラフが表示されない場合は、[Visual Workflow] ペインの 
       refresh
    を選択します。

    
            ビジュアルワークフロー
  4. [次へ] を選択します。

  5. IAM ロールを作成または入力します。

    • Step Functions の IAM ロールを作成するには、[自分用の IAM ロールを作成する] を選択し、[名前] にロール名を入力します。

    • ステートマシンの正しいアクセス許可を使用して IAM ロールをすでに作成済みである場合は、[Choose an existing IAM role (既存の IAM ロールを選択する)] を選択します。リストから ロールを選択するか、ロールの ARN を指定します。

    注記

    Step Functions によって作成された IAM ロールを削除すると、Step Functions で後で再作成することはできません。同様に、ロールを変更すると (たとえば、IAM ポリシーのプリンシパルから Step Functions を削除するなど)、後で Step Functions でそれを元の設定に復元することはできません。

  6. [ステートマシンの作成] を選択します。

新しい実行の開始

ステートマシンを作成した後、実行を開始できます。

  1. [Helloworld] ページで [New execution (新しい実行)]、または、以前に実行を開始している場合に [Start Execution (実行の開始)] を選択します。

  2. (オプション) 実行を特定できるように、[Enter an execution name] (実行名を入力) ボックスでその ID を指定できます。ID を入力しない場合、Step Functions は自動的に一意の ID を生成します。

    注記

    Step Functions では、ASCII 以外の文字を含むステートマシン、実行、およびアクティビティの名前を作成することができます。これらの ASCII 以外の文字は Amazon CloudWatch では使用できません。CloudWatch メトリクスを追跡できるようにするには、ASCII 文字のみを使用する名前を選択します。

  3. [New execution (新しい実行)] ページで、[Start Execution (実行の開始)] を選択します。

    ステートマシンの新しい実行が開始され、実行中の実行が表示されている新しいページが表示されます。

  4. (省略可能) [Execution Details] セクションで、[Info] タブを選択して [Execution Status] および [Started] と [Closed] のタイムスタンプを確認します。

  5. 実行結果を表示するには、[Output] タブを選択します。

    
            ステートマシンの結果

ステートマシンの更新

今後の実行用にステートマシンを更新できます。

注記

Step Functions でのステートマシンの更新は、結果的に整合します。数秒以内に行われるすべての実行で、更新された定義と roleArn が使用されます。ステートマシンを更新したすぐ後に開始された実行では、前のステートマシン定義と roleArn が使用されることがあります。

  1. [Helloworld] ページで、[Edit] (編集) を選択します。

  2. [編集] ページの [コード] ペインで、ステートマシンの Amazon ステートメント言語 記述を編集します。Result を更新して Hello World has been updated! と表示されるようにする

    { "Comment": "A Hello World example of the Amazon States Language using a Pass state", "StartAt": "HelloWorld", "States": { "HelloWorld": { "Type": "Pass", "Result": "Hello World has been updated!", "End": true } } }
  3. (オプション) [IAM role for executions (実行の IAM ロール)] リストで、新しい AWS Identity and Access Management (IAM) ロールを選択します。

    注記

    [Create new role (新しいロースの作成)] を選択して、新しい IAM ロールを作成することもできます。詳細については、「AWS Step Functions の IAM ロールを作成する」を参照してください。

  4. [保存]、[実行の開始] の順に選択します。

  5. [New execution (新しい実行)] ページで、[Start Execution (実行の開始)] を選択します。

  6. 実行の結果を表示するには、[Visual workflow (ビジュアルワークフロー)] で、[HelloWorld] 状態を選択して、[Step details (ステップの詳細)] で、[Output (出力)] を選択します。

    
            実行出力

    注記

    出力テキストは、新しく更新されたステートマシンと一致します。

次のステップ

Pass 状態を使用するシンプルなステートマシンを作成したところで、以下を試します。