Skip to main content

Esta versão do GitHub Enterprise foi descontinuada em 2022-10-12. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Criar um problema

Os problemas podem ser criados de várias maneiras. Portanto, você pode escolher o método mais conveniente para seu fluxo de trabalho.

Who can use this feature

People with read access can create an issue in a repository where issues are enabled.

Os problemas podem ser usados para acompanhar erros, aprimoramentos ou outras solicitações. Para obter mais informações, confira "Sobre os problemas".

Os administradores do repositório podem desabilitar problemas para um repositório. Para obter mais informações, confira "Como desabilitar problemas".

Criar um problema a partir de um repositório

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository. 2. No nome do seu repositório, clique em Problemas. Aba de problemas 1. Clique em Novo problema. Botão Novos Problemas
  2. Se o seu repositório usar modelos de problemas, clique em Introdução ao lado do tipo de problema que deseja abrir. Selecione o tipo de problema que deseja criar ou clique em Abrir um problema em branco se o tipo de problema que deseja abrir não estiver incluído nas opções disponíveis. Link para abrir um problema em branco 1. Digite um título e uma descrição para o seu problema. Um exemplo de problema 1. Se você for um mantenedor de projeto, poderá atribuir o problema a alguém, adicioná-lo a um quadro de projetos, associá-lo a um marco ou aplicar um rótulo. 1. Quando terminar, clique em Enviar novo problema.

Criando um problema com GitHub CLI

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. Quando você está trabalhando na linha de comando, você pode usar GitHub CLI para economizar tempo e evitar mudar o contexto. Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Para criar um problema, use o subcomando gh issue create. Para ignorar os prompts interativos, inclua os sinalizadores --body e --title.

gh issue create --title "My new issue" --body "Here are more details."

Você também pode especificar responsáveis, etiquetas, marcos e projetos.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Criando um problema a partir de um comentário

Você pode abrir um novo problema a partir de um comentário em um problema ou pull request. Quando você abre um problema a partir de um comentário, o problema contém um trecho mostrando onde o comentário foi originalmente publicado.

  1. Acesse o comentário que você deseja abrir a partir de um problema.
  2. No comentário, clique em . Botão de kebab no comentário de revisão de solicitação de pull
  3. Clique em Referência em novo problema. Item de menu Referência em um novo problema
  4. Use o menu suspenso "Repository" (Repositório) para selecionar o repositório em que deseja abrir o problema. Menu suspenso Repositório do novo problema
  5. Digite um título descritivo e o texto do problema. Título e corpo do novo problema
  6. Clique em Criar problema. Botão usado para criar um problema 1. Se você for um mantenedor de projeto, poderá atribuir o problema a alguém, adicioná-lo a um quadro de projetos, associá-lo a um marco ou aplicar um rótulo. 1. Quando terminar, clique em Enviar novo problema.

Criando um problema a partir do código

É possível abrir um problema novo a partir de uma linha ou linhas específicas de código em um arquivo ou pull request. Quando você abre um problema de código, o problema contém um trecho mostrando a linha ou intervalo de código que você escolheu. Você pode abrir somente um problema no mesmo repositório onde o código é armazenado.

Trecho de código fornecido em um problema aberto de código

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.
  2. Localize o código que deseja referenciar em um problema:
    • Para abrir um problema sobre código em um arquivo, navegue até o arquivo.
    • Para abrir um problema sobre um código em uma solicitação de pull, navegue até a solicitação de pull e clique em Arquivos alterados. Em seguida, procure o arquivo que contém o código que deseja incluir no comentário e clique em Exibir.
  3. Escolha se deseja selecionar uma única linha ou um intervalo:
    • Para selecionar uma única linha de código, clique no número de linha para destacá-la. Arquivo com linha de código única selecionado
      • Para selecionar um intervalo de código, clique no número da primeira linha no intervalo para destacar a linha de código. Em seguida, posicione o cursor sobre a última linha do intervalo de códigos, pressione SHIFT e clique no número de linha para realçar o intervalo. Arquivo com um intervalo de códigos selecionado
  4. À esquerda do intervalo do código, clique em . No menu suspenso, clique em Referência em um novo problema. Menu de kebab com a opção para abrir um novo problema de uma linha selecionada 1. Digite um título e uma descrição para o seu problema. Um exemplo de problema 1. Se você for um mantenedor de projeto, poderá atribuir o problema a alguém, adicioná-lo a um quadro de projetos, associá-lo a um marco ou aplicar um rótulo. 1. Quando terminar, clique em Enviar novo problema.

Criando um problema a partir de uma observação do quadro de projeto

Se estiver usando um quadro de projeto para rastrear e priorizar seu trabalho, você poderá converter observações do quadro de projeto em problemas. Para obter mais informações, confira "Sobre os quadros de projetos" e "Como adicionar anotações a um quadro de projetos".

Criando um problema a partir de uma consulta de URL

Você pode usar parâmetros de consulta para abrir problemas. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página web específica, como resultados do filtro de pesquisa ou um modelo de problemas no GitHub. Para criar seus próprios parâmetros de consulta, você deve corresponder o par de chave e valor.

Dica: também é possível criar modelos de problemas que são abertos com rótulos padrão, responsáveis e um título para o problema. Para obter mais informações, confira "Como usar modelos para incentivar problemas e solicitações de pull úteis".

Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é preciso ter permissão para adicionar um rótulo a um problema a fim de usar o parâmetro de consulta labels. Para obter mais informações, confira "Funções de repositório de uma organização".

Se você criar uma URL inválida usando parâmetros de consulta ou se não tiver as permissões adequadas, a URL retornará uma página de erro 404 Not Found. Se você criar uma URL que exceda o limite do servidor, a URL retornará uma página de erro 414 URI Too Long.

Parâmetro de consultaExemplo
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report cria um problema com o rótulo "bug" e o título "Novo relatório de bugs".
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. cria um problema com o título "Novo relatório de bugs" e o comentário "Descreva o problema" no corpo do problema.
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug cria um problema com os rótulos "preciso de ajuda" e "bug".
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones cria um problema com o marco "testando marcos".
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat cria um problema e o atribui a @octocat.
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 cria um problema com o título "Correção de bug" e o adiciona ao quadro de projetos 1 da organização.
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md cria um problema com um modelo no corpo do problema. O parâmetro de consulta template funciona com modelos armazenados em um subdiretório ISSUE_TEMPLATE na raiz no diretório docs/ ou .github/ em um repositório. Para obter mais informações, confira "Como usar modelos para incentivar problemas e solicitações de pull úteis".

Leitura adicional