メインコンテンツへスキップ

テストノード

フロー全体を公開する前に、フロー内の個々のノードのデータをテストできます。個々のノードをテストすることで、設定ミスや権限の問題、誤ったパラメータなどを早い段階で検出でき、本番環境でフローが実行されるまで問題に気付かないという事態を防げます。例えば、EC2 の DescribeInstances ノードをテストして、期待どおりのインスタンスやフィールドが返されることを確認したり、リソースを削除またはタグ付けするステップをテストして、フルフローを実行したり他のステップに影響を与えたりすることなく、正しい ID が対象になっているかを検証できます。

さらに、ノードのテスト出力を保存しておくことで、下流ノードをテストする際にそのデータを自動的に利用できるようにすることもできます。CloudFlow は、上流ノードからのデータを使用してテスト用のペイロードを自動的に作成します。アクションノード(例えば AWS または Google Cloud のノード)の場合、ノード設定を変更することなく、テスト専用のカスタム入力パラメータを任意で使用できます。

注意

テストを実行すると、そのノードが完全に実行され、リソースの削除やデータの変更など、実際のアクションが行われる可能性があります。テストを実行する前、および下流ノードの実行を続行する前に、アクションの結果をよく検討してください。

ヒント
  • テストの前に、すべてのパラメータと接続を入力する必要があります。

  • アクションノードでは、ノード設定のパラメータを使用するか、テスト専用に独自のパラメータを使用するかを選択できます。独自のパラメータを使用する場合、Test タブには現在のノードのパラメータがあらかじめ入力されます。これらを編集したり、(例えば上流ノードからの)追加のパラメータを追加したりできます。変数や他のノードへの参照は、テスト実行時に解決されます。

  • 下流ノードをテストする際に、あるノードのテストデータを利用できるようにするには、Save as test data を選択してください。

  1. ノードの設定タブから Go to test を選択するか、Test タブを選択します。

  2. (任意)アクションノードの場合:現在のノード設定からパラメータを使用するか、独自のパラメータを使用するかを選択します。独自のパラメータを使用する場合、Test タブには現在のノードのパラメータがあらかじめ入力されます。これらを編集したり、(例えば上流ノードからの)追加のパラメータを追加したりできます。変数や他のノードへの参照は、テスト実行時に解決されます。

    CloudFlow cutom test parameters

  3. (任意)Save as test data を選択して、下流ノードをテストする際にテストデータを利用できるようにします。

  4. Test を選択します。

  5. Test results を選択し、ノードが期待どおりに動作していることを検証します。

    Test results タブでは、CloudFlow はランタイムエンベロープ内にノードの出力を表示します(例えば、resultsmessagecontext を含むエントリの配列)。これは、表示されている JSON がノードが返す生の値そのものではなく、その値がこの構造でラップされたものであることを意味します。下流ノードは、Output schema で説明されているとおり、results[0] 内のペイロードを扱います。

    CloudFlow test results

  6. (任意)Test data を選択します。次の操作ができます。

    • Copy を選択してテストデータをコピーします。例えば、テストを実行したくない(遅い・コストが高いなどの理由で)ノードからテストデータが必要な場合、別の実行から既知のペイロードをそのノードのテストデータとして貼り付けて、下流のテストを実行できるようにできます。

    • Edit を選択してテストデータを編集します。例えば、別のユースケース(異なる ID、日付、フラグなど)をテストしたい場合や、バグを再現したい場合があります。その場合はテストデータを編集して再度テストを実行し、上流ノードを再実行せずに済ませることができます。

  7. 下流ノードを編集して Test を選択します。Save as test data を選択していた場合、参照ノードが一覧表示されます。

    CloudFlow downstream test results

  8. テストしたい各ノードについて、フロー内でこれらの手順を繰り返します。