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

テストノード

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

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

注意

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

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

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

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

  • テストモードでページネーションが有効な場合は、ノードが取得するアイテム数を確認してください。ベストプラクティスとして、ページネーションされたテスト実行は少量に抑えてください(例えば、2~3 ページ・1 ページあたり 20~30 件のみでテストする)。結果に問題がないことを確認したら、これらの設定を増やしてフローを公開してください。

ノードをテストする

ノードをテストするには、次の手順に従ってください。

  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. テストしたいフロー内の各ノードについて、これらの手順を繰り返してください。