Como criar dependências de problema

Saiba como criar dependências de problemas para ver quais problemas estão bloqueados por, ou bloqueando, outros trabalhos.

Quem pode usar esse recurso?

People with at least triage permissions for a repository can create issue dependencies.

Issue dependencies are available for users on GitHub Free, GitHub Pro, GitHub Team, and GitHub Enterprise Cloud plans.

Neste artigo

As dependências de problemas permitem definir problemas bloqueados por, ou que estão bloqueando, outros trabalhos.

Como marcar um problema como bloqueado por, ou bloqueando, outro problema

  1. Navegue até o problema para o qual você deseja criar uma dependência.
  2. Na barra lateral direita, clique em Relationships.
  3. Na lista suspensa, selecione uma opção de dependência:
    • Para indicar que o problema depende de outro problema ser concluído, selecione Mark as blocked by.
    • Para indicar que o problema está impedindo que outro problema seja concluído, selecione Mark as blocking.
  4. Na caixa de diálogo aberta, pesquise e selecione todos os problemas que estão bloqueados por, ou bloqueando, o problema.

Os problemas bloqueados são marcados com um ícone "Blocked" nos quadros de projeto ou na página Issues do repositório para que você possa facilmente identificar gargalos.

Como remover uma relação de bloqueio entre dois problemas

  1. Navegue até o problema do qual você deseja remover uma dependência.
  2. Na barra lateral direita, clique em Relationships.
  3. Na lista suspensa, selecione uma opção de dependência:
    • Para indicar que o problema não depende mais da conclusão de outro problema, selecione Change blocked by.
    • Para indicar que o problema não está mais impedindo que outro problema seja concluído, selecione Change blocking.
  4. Na caixa de diálogo que é aberta, desmarque os problemas que não estão mais bloqueados por, nem bloqueando, seu problema.

Gerenciando dependências de problemas 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 GitHub CLI, consulte Sobre GitHub CLI.

Para criar uma nova issue com dependências, use os sinalizadores --blocked-by e --blocking em gh issue create. Cada sinalizador aceita uma lista separada por vírgulas de números de problema ou URLs.

gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --blocked-by BLOCKED-BY-ISSUE-NUMBER --blocking BLOCKING-ISSUE-NUMBER

Para adicionar ou remover dependências em um problema existente, use os sinalizadores correspondentes gh issue edit com o número de problema ou a URL.

gh issue edit ISSUE-NUMBER --add-blocked-by BLOCKED-BY-ISSUE-NUMBER --add-blocking BLOCKING-ISSUE-NUMBER
gh issue edit ISSUE-NUMBER --remove-blocked-by BLOCKED-BY-ISSUE-NUMBER --remove-blocking BLOCKING-ISSUE-NUMBER

Para ver as dependências de um problema, use gh issue view. A saída inclui linhas "Bloqueado por" e "Bloqueio" quando as relações são definidas.

My new issue octo-org/octo-repo#123
Open • monalisa opened 3 days ago • 0 comments
Blocked by: octo-org/octo-repo#200 Database schema migration
Blocking: octo-org/octo-repo#300 Release v2.0

  Here are more details.

View this issue on GitHub: https://github.com/octo-org/octo-repo/issues/123

Você também pode acessar dependências programaticamente com o sinalizador --json, usando os campos blockedBy e blocking.

gh issue view ISSUE-NUMBER --json blockedBy,blocking