O Que É fail-fast em uma Matrix do GitHub Actions?

fail-fast decide se uma célula de matrix que falha cancela as outras. O padrão é true.

Uma matrix pode iniciar muitos jobs em paralelo. Por padrão, se um falha, o GitHub cancela os demais para economizar tempo. A configuração fail-fast permite desativar isso quando você quer resultados completos.

O que é

Uma opção da strategy de matrix. Quando fail-fast: true (o padrão), o primeiro job de matrix que falha cancela todos os irmãos em andamento e pendentes. Quando false, cada célula roda até a conclusão.

strategy:
  fail-fast: false
  matrix:
    os: [ubuntu-latest, windows-latest, macos-latest]

Como funciona

Com a falha rápida ativada, o GitHub interrompe a matrix assim que um job falha, dando feedback rápido e economizando minutos. Com ela desativada, você obtém o panorama completo de sucesso/falha em todas as combinações.

Quando desativá-lo

• Depurar qual SO ou versão realmente falha.
• Ambientes instáveis onde uma falha não é decisiva.
• Quando você quer resultados de cobertura completa apesar de uma falha.

Por que importa

fail-fast troca velocidade por completude. Deixá-lo ativado economiza minutos; desativá-lo ajuda você a ver a matrix completa ao diagnosticar falhas específicas de ambiente.

Conceitos relacionados

Faz parte da strategy da matrix e complementa continue-on-error para controlar o comportamento em caso de falha.

Principais conclusões

• fail-fast cancela os irmãos quando uma célula falha.
• O padrão é true; defina como false para resultados completos.
• Ativado economiza minutos; desativado ajuda na depuração.

Guias relacionados