Skip to main content

Desabilitar e habilitar um fluxo de trabalho

Você pode desabilitar e habilitar novamente um fluxo de trabalho usando a interface do usuário de GitHub, a API REST, ou GitHub CLI.

Tool navigation

Note

No momento, não há suporte para executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Desabilitar um fluxo de trabalho permite que você impeça que um fluxo de trabalho seja acionado sem ter de excluir o arquivo do repositório. Você pode facilmente reabilitar o fluxo de trabalho novamente em GitHub.

Desabilitar temporariamente um fluxo de trabalho pode ser útil em vários cenários. Estes são alguns exemplos em que desabilitar um fluxo de trabalho pode ser útil:

  • Um erro de fluxo de trabalho que produz muitas solicitações ou solicitações erradas, afetando negativamente os serviços externos.
  • Um fluxo de trabalho que não é crítico e está consumindo muitos minutos na sua conta.
  • Um fluxo de trabalho que envia solicitações para um serviço que não está ativo.
  • Fluxos de trabalho em um repositório bifurcado desnecessários (por exemplo, fluxos de trabalho agendados).

Warning

Para evitar execuções desnecessárias do fluxo de trabalho, os fluxos de trabalho programados podem ser desabilitados automaticamente. Quando um repositório público é bifurcado, os fluxos de trabalho programados são desabilitados por padrão. Em um repositório público, os fluxos de trabalho agendados são automaticamente desabilitados quando nenhuma atividade do repositório ocorreu em 60 dias.

Também é possível desabilitar e habilitar um fluxo de trabalho usando a API REST. Para obter mais informações, confira "Pontos de extremidade da API REST para fluxos de trabalho".

Desabilitar um fluxo de trabalho

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Ações.

    Captura de tela das guias do repositório "github/docs". A guia "Ações" está realçada com um contorno laranja.

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja desabilitar.

  4. Clique em para exibir um menu suspenso e clique em Desabilitar fluxo de trabalho.

    Captura de tela de um fluxo de trabalho. O botão "Mostrar opções de fluxo de trabalho", rotulado com um ícone de kebab horizontal, e o item de menu "Desabilitar fluxo de trabalho" estão realçados em laranja escuro.

Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".

Para desabilitar um fluxo de trabalho, use o subcomando workflow disable. Substitua workflow pelo nome, pela ID ou pelo nome do arquivo de fluxo de trabalho que deseja desabilitar. Por exemplo, "Link Checker", 1234567 ou "link-check-test.yml". Se você não especificar um fluxo de trabalho, GitHub CLI irá retornar um menu interativo para você escolher um fluxo de trabalho.

gh workflow disable WORKFLOW

Habilitar um fluxo de trabalho

Você pode habilitar novamente um fluxo de trabalho que foi desabilitado anteriormente.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Ações.

    Captura de tela das guias do repositório "github/docs". A guia "Ações" está realçada com um contorno laranja.

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja habilitar.

    Captura de tela da página "Ações". Na barra lateral esquerda, o nome do fluxo de trabalho está realçado com um contorno em laranja escuro.

  4. Clique em Habilitar fluxo de trabalho.

Para habilitar um fluxo de trabalho, use o subcomando workflow enable. Substitua workflow pelo nome, pela ID ou pelo nome do arquivo de fluxo de trabalho que deseja habilitar. Por exemplo, "Link Checker", 1234567 ou "link-check-test.yml". Se você não especificar um fluxo de trabalho, GitHub CLI irá retornar um menu interativo para você escolher um fluxo de trabalho.

gh workflow enable WORKFLOW