コンテンツにスキップ

Reviewノード

Reviewノードは、レビュアーが承認・却下・差し戻しを決定するまでワークフローを一時停止するゲートです。自動パイプラインに人間の判断を組み込むための主要な仕組みです。

破壊的あるいは不可逆な操作(デプロイ、データマイグレーション、コンテンツ公開、外部システムへの送信など)の直前にReviewノードを挟みます。中間成果物を点検して品質が足りなければ作り直させる、という用途でも有効です。

レビューは常に人が、HQダッシュボードから判断します。承認できるのは、その実行が属するプロジェクトのメンバーです(閲覧のみの人は承認できません)。古いワークフローでレビュアーにミニオンやロールを指定していても、人のレビューとして扱われます。

フィールド説明
review.preferred_reviewer_id任意。まず見てほしい人。レビューの通知は、プロジェクトのメンバー全員ではなくその人に届きます(プロジェクトのメンバーである間)。
criteriaレビューで確かめること。ダッシュボードの承認・却下・差し戻しのボタンの横に出ます。
revision_targetキャンバス上でreviewノードから祖先ノードにrevisionエッジを引くと自動設定されます。差し戻し時に再実行するノード。

revision_target はReviewノードの祖先、すなわち非revisionエッジで前方到達可能なノードでなければなりません。そうでないと差し戻しループが実際に経由できません。

  1. cascadeがReviewノードに到達すると、waitingかつreview_status: review_pendingで挿入され、判定待ちになります。
  2. プロジェクトのメンバーに通知が届き、誰かがダッシュボードで判定を送信:
    • approved — approved出力エッジに沿ってcascadeが続行。
    • revision — revision_targetが再実行されます。再実行が終わるとReviewノードも自動で再開。
    • rejected — その時点でグラフが停止。
  • review 設定ブロックは必須。
  • criteria は空文字不可。
  • revision_target は実在するノードで、かつReviewノードの前方祖先でなければなりません。
  • Reviewノードには少なくとも1本のapproved出力エッジが必要です(fan-outテンプレート内なら、テンプレートOutマーカー宛のapproved io-edgeでも可)。そうでないと承認後にハッピーパスが続かなくなります。
  • Reviewノードからrevision_targetへのrevisionエッジが必要です。
flowchart LR
Draft["Skill: draft-post"] --> R{"Review"}
R -->|approved| Publish["Skill: publish"]
R -. revision .-> Draft

revisionエッジ(点線)は、レビュアーが修正を求めたときにフローをdraft-postに戻します。draft-postが再度完了すると、自動的にReviewが再開されます。