Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Usar registros de execução do fluxo de trabalho

Você pode visualizar, pesquisar e fazer download dos logs para cada trabalho em uma execução de fluxo de trabalho.

Observação: GitHub Actions estava disponível para GitHub Enterprise Server 2.22 como um beta limitado. O beta terminou. GitHub Actions está agora geralmente disponível em GitHub Enterprise Server 3.0 ou posterior. Para obter mais informações, consulte as observações sobre a versão GitHub Enterprise Server 3.0.


Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.

Na página de execução de fluxo de trabalho, você pode verificar se a execução está em andamento ou foi concluída. 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.

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 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. É necessário o acesso de leitura ao repositório é para executar essas etapas.

Além das etapas configuradas no arquivo do fluxo de trabalho, GitHub acrescenta duas etapas adicionais a cada trabalho para configurar e concluir a execução do trabalho. Estas etapas estão registradas na execução do fluxo de trabalho com os nomes "Configurar trabalho" e "Concluir trabalho".

Para trabalhos executados em executores hospedados no GitHub, "Configurar trabalho" registra os detalhes do ambiente virtual do executor e inclui um link para a lista de ferramentas pré-instaladas que estavam presentes na máquina do executor.

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

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. Na barra lateral esquerda, clique no trabalho que você deseja ver. Selecione um trabalho do fluxo de trabalho

  6. Expanda a etapa Executar Super-Linter para visualizar os resultados. Resultados do fluxo de trabalho do Super linter

  7. Para obter um link para uma linha específica nos logs, clique no número da linha da etapa. Em seguida, você pode copiar o link da barra de endereço do seu 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. É necessário o acesso de leitura ao repositório é para executar essas etapas.

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

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. Na barra lateral esquerda, clique no trabalho que você deseja ver. Selecione um trabalho do fluxo de trabalho

  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

Fazer download dos registros

Você pode fazer o download dos arquivos de registro da execução do seu fluxo de trabalho. Você também pode fazer o download dos artefatos de um fluxo de trabalho. Para obter mais informações, consulte "Dados recorrentes do fluxo de trabalho que usam artefatos". É necessário o acesso de leitura ao repositório é para executar essas etapas.

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

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. Na barra lateral esquerda, clique no trabalho que você deseja ver. Selecione um trabalho do fluxo de trabalho

  6. No canto superior direito, clique em e selecione Fazer o download do arquivo de registro. Menu suspenso Download logs (Baixar logs)

Excluir registros

Você pode excluir arquivos de registro da execução do seu fluxo de trabalho. É necessário o acesso de gravação ao repositório é para executar essas etapas.

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

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. No canto superior direito, clique em . Ícone horizontal do kebab

  6. 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 Depois que os registros forem excluídos, o botão Excluir todos os registros é removido para indicar que nenhum arquivo de registro permanece na execução do fluxo de trabalho.

Visualizar registros com GitHub CLI

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Para visualizar o registro para uma tarefa específica, use o subcomando executar a vista. Substitua run-id pelo ID da execução que você deseja visualizar os registros. GitHub CLI retorna um menu interativo para você escolher um trabalho a partir da execução. Se você não especificar run-id, GitHub CLI irá retornar um menu interativo para você escolher uma execução recente e, em seguida, irá retornar outro menu interativo para você escolher um trabalho da execução.

gh run view run-id --log

Você também pode usar o sinalizador --job para especificar um ID de trabalho. Substitua job-id pelo ID do trabalho para o qual você deseja exibir os registros.

gh run view --job job-id --log

Você pode usar grep para pesquisar o registro. Por exemplo, este comando retornará todas as entradas do registro que contêm a palavra erro.

gh run view --job job-id --log | grep error

Para filtrar os registros para quaisquer etapas que falharam, use --log-failed em vez de --log.

gh run view --job job-id --log-failed