GITHUB_RUN_ATTEMPT とは何か?

GITHUB_RUN_ATTEMPT は現在の run の試行番号で、1 から始まり、再実行のたびにインクリメントします。

GITHUB_RUN_ATTEMPT を使うと、workflow はそれが再実行であることを検出でき、リトライを意識した cache やメッセージングに便利です。

例

手動の再実行を検出します。

if: ${{ github.run_attempt > 1 }}

信頼性に関する注意

手動の再実行は、最初の試行で無駄になった分の時間を消費します。Latchkey のような自己修復する managed runner は、本当に一時的な失敗 (ネットワークの瞬断、OOM-kill) を自動的にリトライするため、再実行はしばしば不要です。

重要なポイント

• GITHUB_RUN_ATTEMPT は 1 から始まり、再実行ごとに増えます。
• workflow のロジックで再実行を検出します。
• 自動リトライする runner は手動の再実行を減らします。

関連ガイド