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

テストノード

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

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

注意

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

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

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

  • 下流ノードをテストする際に、あるノードからのテストデータを利用できるようにするには、テストデータとして保存 を選択してください。

  • ページネーションが有効な場合、テストモードは結果を自動的に 100 アイテムに制限します。このリミットが適用されると、ノードはテスト結果にメッセージを追加し、ページネーションが制限されたことを示します。これにより、テスト実行が高速になり、開発中に大きなデータセットを取得することを避けられます。このリミットは実際のフロー実行には適用されません。公開されたフローは、設定どおりにすべてのページを取得します。

ノードをテストする

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

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

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

    CloudFlow cutom test parameters

  3. (オプション)下流ノードをテストする際にテストデータを利用できるようにするには、テストデータとして保存 を選択してください。

  4. Test を選択してください。

  5. ノードが期待どおりに動作しているか検証するには、テスト結果 を選択してください。

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

    CloudFlow test results

  6. (オプション)テストデータ を選択してください。次の操作ができます。

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

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

  7. 下流ノードを編集し、Test を選択してください。テストデータとして保存 を選択していた場合、参照ノードが表示されます。

    CloudFlow downstream test results

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