Trabalhar com o suporte para o GitHub Actions

Saiba como Suporte do GitHub podem ajudar com o GitHub Actions

Neste artigo

Você pode entrar em contato com o Suporte do GitHub para obter assistência com o GitHub Actions.

Fornecendo informações de diagnóstico e solução de problemas

O conteúdo de repositórios privados e internos não é visível para o Suporte do GitHub. Portanto, o Suporte do GitHub pode solicitar informações adicionais para entender o contexto completo de sua consulta e reproduzir qualquer comportamento inesperado. Você pode acelerar a resolução da sua consulta fornecendo essas informações ao gerar inicialmente um tíquete com o Suporte do GitHub.

Algumas informações que o Suporte do GitHub solicitará podem incluir, mas não estão limitadas a:

  • A URL da execução do fluxo de trabalho.

Por exemplo: https://github.com/ORG/REPO/actions/runs/0123456789

  • O(s) arquivo(s) de fluxo de trabalho .yml anexado(s) ao tíquete como arquivos .txt. Para obter mais informações sobre os fluxos de trabalho, confira "Sobre fluxos de trabalho".

  • Uma cópia dos logs de execução do fluxo de trabalho para um exemplo de falha de execução do fluxo de trabalho. Para obter mais informações sobre logs de execução de fluxos de trabalho, confira "Usando logs de execução de fluxo de trabalho".

  • Se você estiver executando esse fluxo de trabalho em um executor auto-hospedado, este registrará que pode ser encontrado na pasta _diag dentro do executor. Para saber mais sobre executores auto-hospedados, confira "Monitorar e solucionar problemas de executores auto-hospedados".

    Nomes de arquivos de log do executor auto-hospedado são formatados: Runner_YYYY####-xxxxxx-utc.log e Worker_YYYY####-xxxxxx-utc.log.

Observação: anexe arquivos ao seu tíquete de suporte alterando a extensão do arquivo para .txt ou .zip. Se você incluir dados textuais, como trechos de arquivo de log ou de fluxo de trabalho, embutidos no seu tíquete, verifique se eles estão formatados corretamente como blocos de código de Markdown. Para obter mais informações sobre a formatação correta do Markdown, consulte "Sintaxe básica de gravação e formatação no GitHub".

Se as informações fornecidas estiverem ilegíveis devido à perda de formatação por sintaxe de Markdown inadequada, o Suporte do GitHub poderá solicitar o reenvio das informações como um anexo ou com a formatação de Markdown correta.

Aviso: verifique se todos os arquivos e textos fornecidos ao Suporte do GitHub foram editados corretamente para remover informações confidenciais, como tokens e outros segredos.

Arquivos de log do aplicativo do executor efêmero

O Suporte do GitHub pode solicitar os arquivos de log do aplicativo do executor de executores efêmeros. O GitHub espera e recomenda que você tenha implementado um mecanismo para encaminhar e preservar os arquivos de log do aplicativo do executor de executores efêmeros auto-hospedados. Para obter mais informações sobre arquivos de log do aplicativo do executor e solução de problemas de executores auto-hospedados, confira "Monitorar e solucionar problemas de executores auto-hospedados."

Actions Runner Controller

Se estiver usando o Actions Runner Controller (ARC), o Suporte do GitHub poderá solicitar que você envie os logs completos do controlador, dos ouvintes e dos pods do executor. Para obter mais informações sobre a coleta de logs do Actions Runner Controller, consulte "Solução de problemas de erros do Controlador do Executor de Ações".

Para obter mais informações sobre o escopo do suporte para o Actions Runner Controller, consulte "Sobre o suporte para o Actions Runner Controller".

CodeQL e GitHub Actions

Se estiver solicitando assistência com um Fluxo de trabalho de análise do CodeQL, o Suporte do GitHub poderá solicitar uma cópia dos artefatos de depuração do CodeQL. Para obter mais informações sobre como depurar artefatos para um Fluxo de trabalho de análise do CodeQL, consulte "Os logs não são detalhados o suficiente".

Para fornecer artefatos de depuração ao Suporte do GitHub, baixe os artefatos de depuração do CodeQL de uma execução de fluxo de trabalho de exemplo e anexe-os ao seu tíquete como um arquivo .zip. Para obter mais informações sobre como baixar artefatos de fluxo de trabalho, confira "Fazer o download de artefatos do fluxo de trabalho".

Se o arquivo de artefatos de depuração .zip do CodeQL for muito grande para carregar no tíquete, informe ao Suporte do GitHub, e trabalharemos com você para determinar as próximas etapas.

Escopo do suporte

Se a sua solicitação de suporte não está no escopo de auxílio da nossa equipe, podemos recomendar próximas etapas para resolução do problema fora do Suporte do GitHub. A sua solicitação de suporte possivelmente está fora do escopo de Suporte do GitHub, se a solicitação se tratar principalmente de:

  • Integrações de terceiros, como o Jira
  • O Enterprise Cloud Importer (disponível apenas para migrações lideradas por especialistas)
  • CI/CD, como Jenkins
  • Criação de scripts
  • Configuração de sistemas de autenticação externa, como provedores de identidade SAML
  • Projetos de software livre
  • Escrevendo ou depurando novas consultas para CodeQL
  • Configurações do provedor de nuvem, como configuração de rede virtual, firewall personalizado ou regras de proxy.
  • Orquestração de contêineres, como configuração do Kubernetes, rede, etc.
  • Assistência detalhada com fluxos de trabalho e gerenciamento de dados
  • Recursos de Versão prévia pública. O suporte para recursos versão prévia pública está fora do escopo de Suporte do GitHub. Para obter suporte com recursos versão prévia pública, você pode entrar em contato com seu gerente de conta, em Equipe de vendas do GitHub.

Para obter assistência detalhada com fluxos de trabalho e gerenciamento de dados, consulte o GitHub Expert Services, que oferece suporte especializado para ajudar você a otimizar o uso da plataforma.

Se não tem certeza se o problema está fora do escopo, abra um tíquete e ficaremos felizes em ajudá-lo a determinar a melhor maneira de prosseguir.