Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Gerenciar a execução de fluxos de trabalho

Você pode visualizar o status e os resultados de cada etapa no seu fluxo de trabalho, cancelar um fluxo de trabalho pendente, visualizar os minutos de execução do trabalho faturável, depurar e reexecutar o fluxo de trabalho com falha, pesquisar e fazer o download de registros e de artefatos.

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub One. O GitHub Actions não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. Para obter mais informações, consulte os "produtos do GitHub".

Neste artigo

Sobre o gerenciamento de fluxos de trabalho

Na página de execução de fluxo de trabalho, você pode verificar se a execução está em andamento ou foi concluída. Se a execução estiver em andamento, será possível cancelá-la. Você deve estar conectado a uma conta GitHub para visualizar as informações da execução do seu fluxo de trabalho, incluindo os repositórios públicos. Para obter mais informações, consulte "Permissões de acesso no GitHub".

Se a execução estiver concluída, será possível ver se o resultado teve êxito, se houve falha, se foi cancelado ou se ficou neutro. Em caso de falha, você poderá exibir e pesquisar os logs de criação para diagnosticar a falha e executar o fluxo de trabalho novamente. Você também pode visualizar os minutos da execução do trabalho faturável ou fazer o download dos registros e criar artefatos.

Imagem de execução de fluxo de trabalho comentada

O GitHub Actions usa a API de Verificação para mostrar os status, resultados e logs de um fluxo de trabalho. O GitHub cria um novo conjunto de verificações para cada execução de fluxo de trabalho. O conjunto de verificações contêm uma execução de verificação para cada trabalho no fluxo de trabalho, e cada trabalho inclui etapas. As ações do GitHub Actions são executadas como etapas no fluxo de trabalho. Para obter mais informações sobre a API de verificações, consulte "Verificações".

Nota: Garanta que você só faça commit de arquivos de fluxo de trabalho válidos no seu repositório. Se .github/workflows contiver um arquivo de fluxo de trabalho inválido, GitHub Actions gera uma falha na execução do fluxo de trabalho para cada novo commit.

Exibir o histórico do fluxo de trabalho

Você pode exibir todos os trabalhos em uma execução de fluxo de trabalho e todas as etapas de um trabalho. Para obter mais informações, consulte "Conceitos básicos para GitHub Actions". People with read access to the repository can perform these steps.

In addition to the steps configured in the workflow file, each job also includes additional tasks for initiating and completing the job's execution. These steps are logged in the workflow run as "Set up job" and "Complete job".

For jobs run on GitHub-hosted runners, "Set up job" records details of the runner's virtual environment, and includes a link to the list of preinstalled tools that were present on the runner machine.

  1. No GitHub, navegue até a página principal do repositório.
  2. Under your repository name, click Actions.
    Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see.
    Workflow list in left sidebar
  4. Under "Workflow runs", click the name of the run you want to see.
    Name of workflow run
  5. Para executar o fluxo de trabalho novamente em caso de falha, use o menu suspenso Re-run checks (Executar verificações novamente) no canto superior direito e selecione Re-run all checks (Executar todas as verificações novamente).
    Menu suspenso Re-run checks (Executar verificações novamente)

Cancelar a execução do fluxo de trabalho

Quando você cancela a execução de um fluxo de trabalho, o GitHub cancela todas as etapas que integram o fluxo em questão. People with write-level access to the repository can perform these steps.

  1. No GitHub, navegue até a página principal do repositório.
  2. Under your repository name, click Actions.
    Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see.
    Workflow list in left sidebar
  4. Under "Workflow runs", click the name of the run you want to see.
    Name of workflow run
  5. No canto superior direito do fluxo de trabalho, clique em Cancel check suite (Cancelar conjunto de verificações).
    Botão Cancel check suite (Cancelar conjunto de verificações)

Eliminar execução de um fluxo de trabalho

Você pode excluir uma execução do fluxo de trabalho que foi concluída ou que tem mais de 2 semanas. People with write-level access to the repository can perform these steps.

  1. No GitHub, navegue até a página principal do repositório.

  2. Under your repository name, click Actions.

    Actions tab in the main repository navigation

  3. In the left sidebar, click the workflow you want to see.

    Workflow list in left sidebar

  4. Para excluir a execução de um fluxo de trabalho, use o menu suspenso e selecione Excluir execução de fluxo de trabalho.

    Excluir execução de um fluxo de trabalho

  5. Revise a solicitação de confirmação e clique em Sim, excluir permanentemente esta execução do fluxo de trabalho.

    Excluir uma confirmação de execução de fluxo de trabalho

Visualizar os minutos de execução do trabalho faturável

Você pode visualizar o tempo de execução de um trabalho, incluindo os minutos faturáveis que um trabalho acumulou.

Os minutos de execução de um trabalho faturável são exibidos para trabalhos executados em repositórios privados que usam executores hospedados em GitHub. Não há minutos faturáveis ao usar GitHub Actions nos repositórios públicos ou para trabalhos executados em executores auto-hospedados.

  1. No GitHub, navegue até a página principal do repositório.

  2. Under your repository name, click Actions.

    Actions tab in the main repository navigation

  3. In the left sidebar, click the workflow you want to see.

    Workflow list in left sidebar

  4. Under "Workflow runs", click the name of the run you want to see.

    Name of workflow run

  5. No resumo do trabalho, clique em Informações sobre tempo faturável e execução.

    Link com informações sobre o tempo faturável e execução

    Observação:O tempo faturável exibido não inclui arredondamentos ou multiplicadores de minutos. Para visualizar o uso total de GitHub Actions, incluindo arredondamento e multiplicadores de minutos, consulte "Visualizando o seu uso GitHub Actions".

Exibir logs para diagnosticar falhas

Se houver falha na execução do fluxo de trabalho, você poderá ver qual etapa causou a falha e revisar os logs de criação da etapa com falha para resolver os problemas. Também é possível ver a duração da execução de cada etapa. Além disso, você pode copiar um permalink para determinada linha no arquivo de log a fim de compartilhar com a sua equipe. People with read access to the repository can perform these steps.

GitHub stores full build logs and artifacts for 90 days.

  1. No GitHub, navegue até a página principal do repositório.
  2. Under your repository name, click Actions.
    Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see.
    Workflow list in left sidebar
  4. Under "Workflow runs", click the name of the run you want to see.
    Name of workflow run
  5. In the left sidebar, click the job you want to see.
    List of jobs in left sidebar
  6. Para expandir o log de uma etapa com falha, clique na etapa.
    Nome da etapa com falha
  7. Para obter um link para uma linha específica nos logs, clique no número da linha da etapa. Você pode copiar o link da barra de endereços do navegador da web.
    Botão para copiar link

Pesquisar logs

É possível pesquisar os logs de criação em determinadas etapas. Na pesquisa dos logs, somente as etapas expandidas são incluídas nos resultados. People with read access to the repository can perform these steps.

  1. No GitHub, navegue até a página principal do repositório.
  2. Under your repository name, click Actions.
    Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see.
    Workflow list in left sidebar
  4. Under "Workflow runs", click the name of the run you want to see.
    Name of workflow run
  5. In the left sidebar, click the job you want to see.
    List of jobs in left sidebar
  6. Para expandir cada etapa que você pretende incluir na pesquisa, clique na etapa.
    Nome da etapa
  7. No canto superior direito da saída do log, na caixa Search logs (Pesquisar logs), digite um termo de consulta.
    Caixa de pesquisa de logs

Downloading logs

You can download the log files from your workflow run. You can also download a workflow's artifacts. Para obter mais informações, consulte "Dados recorrentes do fluxo de trabalho usando artefatos".People with read access to the repository can perform these steps.

  1. No GitHub, navegue até a página principal do repositório.
  2. Under your repository name, click Actions.
    Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see.
    Workflow list in left sidebar
  4. Under "Workflow runs", click the name of the run you want to see.
    Name of workflow run
  5. Para baixar os logs, use o menu suspenso Download logs (Baixar logs) e selecione os logs que você pretende baixar.
    Menu suspenso Download logs (Baixar logs)

Excluir registros

Você pode excluir arquivos de registro da execução do seu fluxo de trabalho. People with write-level access to the repository can perform these steps.

  1. No GitHub, navegue até a página principal do repositório.
  2. Under your repository name, click Actions.
    Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see.
    Workflow list in left sidebar
  4. Under "Workflow runs", click the name of the run you want to see.
    Name of workflow run
  5. Para excluir os arquivos de registro, clique no botão Excluir todos os registros e revise a instrução de confirmação.
    Delete all logs
    Após excluir os registros, o botão Excluir todos os registros será removido para indicar que não restaram arquivos de registro na execução do fluxo de trabalho.

Habilitar log de depuração

Se os logs do fluxo de trabalho não fornecerem detalhes suficientes para diagnosticar o motivo pelo qual um fluxo de trabalho, um trabalho ou uma etapa não está funcionando como esperado, habilite o log de depuração adicional.

Esses registros adicionais são habilitados pela definição dos segredos no repositório que contém o fluxo de trabalho. Portanto, aplicam-se os mesmos requisitos de permissão:

  • Para criar segredos no nível da organização, você deve ter acesso admin.
  • Para criar segredos para um repositório de conta de usuário, você deve ser o proprietário do repositório. Para criar segredos para o repositório de uma organização, você deve ter acesso admin.
  • Para criar segredos usando a API REST, você deve ter acesso à gravação ao repositório. Para obter mais informações, consulte "GitHub Actions secrets API."

For more information on setting secrets, see "Creating and using encrypted secrets."

Habilitar log de diagnóstico do runner

Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. Dois arquivos de log extras foram adicionados ao arquivo de log:

  • O log de processo do runner, que inclui informações sobre a coordenação e a configuração de runners para executar trabalhos.
  • O log de processo do worker, que registra em log a execução de um trabalho.
  1. Para habilitar o log de diagnóstico do runner, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: ACTIONS_RUNNER_DEBUG como true.

  2. Para baixar os logs de diagnóstico do runner, baixe o arquivo de log da execução de fluxo de trabalho. Os logs de diagnóstico do runner ficam na pasta runner-diagnostic-logs. For more information on downloading logs, see "Downloading logs."

Habilitar log de depuração da etapa

O log de depuração da etapa aumenta o detalhamento dos logs de um trabalho durante e depois da execução dele.

  1. Para habilitar o log de diagnóstico da etapa, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: ACTIONS_STEP_DEBUG como true.

  2. Após a configuração da chave secreta, mais eventos de depuração são exibidos nos logs da etapa. Para obter mais informações, consulte "Exibir logs para diagnosticar falhas".

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato