メインコンテンツまでスキップ

ワークフロー

概要

ワークフロー機能を利用することで、複数の関連するファンクションを1回の操作で実行できます。

各ファンクションを個別に実行する代わりに、単一のワークフロー実行によって複数のジョブをまとめて実行できるため、実行管理やジョブ管理を効率化できます。

ワークフローへのアクセス

ワークフローを作成するには、以下の手順を実行します。

  1. 左側のナビゲーションメニューから ワークフロー を選択します。
  2. ワークフロー作成 をクリックします。
  3. ワークフロー名と必要に応じて説明を入力します。

ワークフローの作成

ワークフローエディタでは、複数のタスクおよびその実行フローを定義できます。

各タスクでは、デプロイ済みのファンクションを実行できます。

ファンクションの選択

ファンクション名 フィールドには、現在のプロジェクトでデプロイ済みのファンクション一覧が表示されます。

ユーザーは、各ワークフローステップで実行するファンクションを選択できます。

設定

各ワークフローステップでは、以下の項目を設定できます。

  • ファンクション名
  • プロバイダー
  • デバイス
  • ショット数
  • 入力パラメータ

設定内容を変更した後、コードへ反映 をクリックすると、対応するワークフローコード内のタスク定義へ設定内容が反映されます。

ワークフローコードとステップ設定は常に同期された状態で管理されます。

  • ステップパネルで変更した内容は コードへ反映 によりコードへ書き込まれます。
  • 保存済みのタスク設定は、ワークフローを再度開いた際に自動的に復元されます。
  • ユーザーはコード編集画面とビジュアル設定画面を自由に切り替えることができます。

この同期機能により、ワークフローの保守性を向上させながら、コードへの完全なアクセスも維持できます。

編集と保存

ユーザーはいつでもワークフローコードやステップ設定を変更できます。

ワークフローを保存するには、以下の手順を実行します。

  1. 必要に応じてワークフローステップを更新します。
  2. コードへ反映 をクリックして設定内容を同期します。
  3. ワークフロー保存 をクリックします。

保存後、ワークフローは実行可能な状態になります。

既存ワークフローを開く

既存のワークフローを編集するには、以下の手順を実行します。

  1. ワークフロー ページを開きます。
  2. ワークフロー一覧から対象のワークフローを選択します。
  3. ワークフローコードがエディタに読み込まれます。
  4. タスク設定がステップパネルに自動表示されます。
  5. 必要に応じてコードまたは設定を編集します。
  6. ワークフローを保存します。

ワークフローの実行

ワークフローを保存した後、ユーザーは任意のタイミングでワークフローを実行できます。

実行手順は以下のとおりです。

  1. ワークフロー詳細画面を開きます。
  2. 画面右上の ワークフロー実行 をクリックします。

ワークフロー実行ダイアログ

ワークフロー実行 ダイアログでは以下を設定します。

  • 実行するワークフローバージョンを選択します。
  • 必要に応じて JSON 形式の入力パラメータを指定します。
  • パラメータが不要な場合は {} を入力します。

実行 をクリックするとワークフローが開始されます。

新しいワークフロー実行が作成され、実行履歴に追加されます。

ワークフロー実行履歴

ワークフロー詳細画面の下部には 実行履歴 テーブルが表示されます。

◆実行情報 セクションには以下の情報が表示されます。

  • 実行者
  • 開始日時
  • 終了日時
  • 実行時間
  • ワークフローバージョン
  • Prefect 実行ID

これらの情報は、実行状況の確認やトラブルシューティングに役立ちます。

◆パラメータ セクションでは、ワークフロー実行時に指定された入力パラメータを確認できます。

これにより、実行時に使用された入力値を確認できます。

◆ワークフロー DAG セクションでは、ワークフローの実行状況およびタスク依存関係を視覚的に確認できます。

各タスクには実行結果が表示されます。

  • 成功

    • タスクが正常に完了しました。

  • 実行中

    • タスクが現在実行中です。

  • 失敗

    • タスク実行中にエラーが発生しました。

  • キャンセル

    • タスクがキャンセルされました。

  • 待機中

    • タスクの実行待ち状態です。

表示例では、

  • simulate-a57

    • 正常に完了しています。

  • bell_state-09b

    • 実行中に失敗しています。

DAG 表示により、タスクの実行順序、実行時間、依存関係、および障害発生箇所を迅速に把握できます。

◆実行ログ セクションでは、ワークフロー実行中および実行完了後のログを確認できます。

ログには以下の情報が含まれます。

  • ワークフロー送信イベント
  • デプロイ初期化処理
  • タスク実行状況
  • インフラ関連イベント
  • エラーメッセージおよびスタックトレース
  • ワークフロー完了ステータス

ユーザーはログレベルによるフィルタリングや並び替えを行い、ワークフローの監視や問題解析に必要な詳細情報を確認できます。