ステップ 1: ステートマシンを作成するステップ 2: 新しい実行のスタートステップ 3: ステートマシンの更新ステップ 4: クリーンアップ次のステップ

AWS Step Functions の開始方法

このチュートリアルでは、Step Functions の操作の基本について学習します。Step Functions コンソールにサインインし、2 つの Pass 状態を使用するステートマシンを作成します。次に、新しい実行をスタートし、実行の詳細を確認します。次に、Pass 状態の結果の 1 つを変更し、変更を表示します。最後に、クリーンアップステップを実行し、ステートマシンを削除します。このチュートリアルを最後までやると、ステートマシンの作成、テスト、デバッグ、削除の方法がわかるようになるでしょう。

このチュートリアルの前提条件を必ず完了してください。

トピック

ステップ 1: ステートマシンを作成する
ステップ 2: 新しい実行のスタート
ステップ 3: ステートマシンの更新
ステップ 4: クリーンアップ
次のステップ

ステップ 1: ステートマシンを作成する

ステートマシンは、ワークフローを定義する個々のステップを調べるために使用できるワークフローのグラフィカル表現です。

ステートマシンの構造と一般的な状態の詳細については、以下を参照してください。

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

Step Functions コンソールにサインインします。
[Create state machine] (ステートマシンの作成) をクリックします。
‬[Choose authoring method]‭ (オーサリング方法を選択) ページで ‬[Design your workflow visually]‭‬ (ワークフローを視覚的に設計) を選択します。
[Type] (タイプ) で、[Standard] (標準) を選択します。

Step Functions には 2 つのワークフロ StandardそしてExpress。これらのワークフローは、Step Functions によるタスク実行方法、AWS のサービスと統合方法、コストの管理管理方法を定めます。ステートマシンを作成した後で、そのワークフロータイプを変更することはできません。

aの場合 side-by-side 両方のワークフローの比較タイプで、決定するのを手伝ってください。
[Next] (次へ) を選択します。これにより、Workflow Studio が開きます。

Workflow Studio
[Flow] (フロー) パネルを選択した後、Pass 状態を [Drag first state here] (最初の状態をここにドラッグ) とラベル付けされた空の状態までドラッグします。
[Definition] (定義) と視覚的なワークフローを確認します。

このワークフローのコードでは、2 つの Pass 状態が定義されています。ある Pass 状態の名前は Hello で、もう一つの Pass 状態の名前は World です。


{
  "Comment": "A Hello World example of the Amazon States Language using Pass states",
  "StartAt": "Hello",
  "States": {
    "Hello": {
      "Type": "Pass",
      "Next": "World"
    },
    "World": {
      "Type": "Pass",
      "Result": "World",
      "End": true
    }
  }
}

[Next] (次へ) を選択します。Amazon ステートメント言語ワークフロー定義を確認できます。
[Next] (次へ) を選択します。ワークフローに HelloWorld という名前をつけます。
‭‬[Permissions]‭ (許可) で、‬[Create a new IAM role]‭‬ (新しい IAM ロールを作成) を選択します。

ステートマシンを作成するときは、実行中にステートマシンにアクセス許可を与えるリソースを定義する IAM ロールを選択します。次のオプションから選択します。
- [Create a new IAM role] (新しい IAM ロールを作成する) — Step Functions でステートマシンの定義とその設定の詳細に基づいて、新しい IAM ロールを作成する場合は、このオプションを選択します。
- [Choose an existing role] (既存のロールを選択する) — Step Functions の IAM ロールを以前に作成していて、ステートマシンに正しい許可がある場合は、このオプションを選択します。
- [Enter a role ARN] (ロールの ARN を入力する) — Step Functions に使用したい IAM ロールの ARN の詳細がわかっている場合は、このオプションを選択します。
Create State Machine（ステートマシンの作成）を選択します。

ステップ 2: 新しい実行のスタート

ステートマシンの実行は、ワークフローを実行してタスクを実施するインスタンスです。

新しい実行をスタートするには

[Helloworld] ページで、[Start execution] (実行をスタート) を選択します。
オプション-リポジトリの []新しい実行[] ページで次の操作を行います。実行 IDフィールドには、希望する名前を入力できます。

実行名に ASCII 以外の文字が含まれないようにしてください。独自の実行 ID を指定しない場合、Step Functions が一意の実行 ID を生成します。
[New execution] (新しい実行) ページで、[Start Execution] (実行のスタート) を選択します。

[Start execution] (実行をスタート) を選択すると、Step Functions コンソールから実行 ID のタイトルがついたページが表示されます。このページでは、新しい実行結果を確認できます。[Execution details] (実行の詳細) をクリックすると、実行 ARN と実行が成功したかどうかを示すステータスが表示されます。また、実行がスタートおよび終了したときのタイムスタンプも確認できます。
実行結果を表示するには、[Output] (出力) タブを選択します。

この出力は World です。

ステップ 3: ステートマシンの更新

Pass 状態の結果を変更し、将来の例外に備えてステートマシンを更新します。次に、ビジュアルワークフローペインで変更内容を表示します。例外は、ワークフローのステップを中断するイベントです。

ステートマシンを更新すると、更新は結果に整合します。数秒後または数分後、新しくスタートしたすべての実行は、ステートマシンの更新された定義と roleARN を反映します。現在実行中のすべての実行は、前の定義に基づいて完了し、更新前に roleARN となるまで行われます。

Pass 状態の結果を変更する

実行 ID のタイトルのページで、[Edit state machine] (ステートマシンの編集) を選択します。

リポジトリの [Edit Helloworld] (HelloWorld を編集) ページのコードペインで、2 番目の Result を World has been updated! に更新します


{
  "Comment": "A Hello World example of the Amazon States Language using Pass states",
  "StartAt": "Hello",
  "States": {
    "Hello": {
      "Type": "Pass",
      "Result": "Hello",
      "Next": "World"
    },
    "World": {
      "Type": "Pass",
      "Result": "World has been updated!",
      "End": true
    }
  }
}

[Save] (保存)、[Start execution] (実行のスタート) の順に選択します。

[Save] (保存) を選択した後、次のメッセージが表示されます。

「ステートマシンを変更すると、どのリソースにアクセスする必要があるかに影響がでる可能性があります。ステートマシンの許可を正しいものにするには、現在の IAM ロールを編集するか、新しいロールを作成するか、別のロールを選択する必要があります。」

このメッセージはスタンダードです。[Save anyway] (とにかく保存する) を選択します。
[New execution] (新しい実行) ページで、[Start Execution ] (実行のスタート) をもう一度選択します。
次のページのビジュアルワークフローペインで、ワークフローを定義する個々のステップを検査します。
オプション - ワークフローのグラフを SVG または PNG ファイルにエクスポートするには、[Export] (エクスポート) を選択します。
実行結果を表示するには、ビジュアルワークフローペインで、[World] (ワールド) を選択します。[Output] (ステップ詳細) で、[Output] (出力) を選択します。

この出力は World has been updated! です

ステップ 4: クリーンアップ

場合によっては、ステートマシンと実行ロールを削除する必要が生じることがあります。

このチュートリアルを終了すると、ステートマシンと Step Functions で自分用に作成した実行ロールを削除します。

ステートマシンを削除するには

ナビゲーションメニューから、[State machines] (ステートマシン) を選択します。
ステートマシンページでは、[State machines] (ステートマシン) で [HelloWorld] を選択してから、[Delete] (削除) を選択します。

[Delete] (削除) を選択すると、次のメッセージが表示されます。

「ステートマシンを削除しようとしています。続行しますか?」

このメッセージはスタンダードです。[Delete state machine] (ステートマシンの削除) を選択します。

緑色のステータスバーが画面の上部に表示されます。緑色のステータスバーには、ステートマシンが削除対象としてマークされていると書かれています。すべての実行が停止すると、ステートマシンは削除されます。

実行ロールを削除するには

IAM 用 [Roles] (ロール) ページを開きます。
Step Functions がユーザー用に作成した IAM ロールを選択します。ステップ関数-HelloWorld-役割-例。
[Delete role] (ロールの削除) を選択します。
[Yes, delete] (はい、削除します) を選択します。

このチュートリアルを終えて、ステートマシンの作成、テスト、デバッグ、および削除の方法をご理解いただけたでしょうか。

次のステップ

Step Functions の操作に関するその他のチュートリアルについては、以下をお試しください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

前提条件

ユースケース