翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Step Functions の開始方法
このチュートリアルでは、Step Functions の操作の基本について学習します。Step Functions コンソールにサインインし、2 つの Pass 状態を使用するステートマシンを作成します。次に、新しい実行をスタートし、実行の詳細を確認します。次に、Pass
状態の結果の 1 つを変更し、変更を表示します。最後に、クリーンアップステップを実行し、ステートマシンを削除します。このチュートリアルを最後までやると、ステートマシンの作成、テスト、デバッグ、削除の方法がわかるようになるでしょう。
このチュートリアルの前提条件を必ず完了してください。
ステップ 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 の操作に関するその他のチュートリアルについては、以下をお試しください。