GITHUBGuide

Conectar o GitHub

Instale o GitHub App para o Forge sincronizar repositórios, mostrar branches e PRs nas issues e — se o time quiser — mover issues automaticamente quando o PR é mesclado. A conexão é feita por um administrador do Forge.

Instale o GitHub App

  1. 1

    Abra `GitHub` na lateral do Forge.

    O item aparece apenas para administradores do Forge. Quem não é administrador vê o aviso “Peça a um administrador do Forge para conectar o GitHub.”

  2. 2

    Clique em `Conectar GitHub`.

    Você é levado ao GitHub para instalar o app e escolher a organização e os repositórios que ele acessa.

  3. 3

    Volte ao Forge e aguarde.

    A tela “Concluindo a conexão com o GitHub” salva a instalação e sincroniza os repositórios.

    resultado
    A confirmação “GitHub conectado ao Forge” aparece e a página da integração mostra a conta, a instalação e a “Última sincronização”.
Tela de integração com o GitHub no Forge, com a conta conectada e a prévia dos repositórios sincronizados.
A integração com o GitHub conectada.

Termine no mesmo navegador em que começou

A conexão guarda o contexto do time no navegador. Concluir a instalação em outro navegador — ou com os dados do site limpos — gera o erro “Não encontramos o time que iniciou a conexão. Volte ao Forge e tente novamente.” Reinicie a conexão pela página da integração.

Mantenha os repositórios em dia

  • Sincronizar repositórios atualiza a lista quando algo muda no GitHub.
  • Gerenciar instalação reabre o GitHub para incluir ou remover repositórios do app.
  • A “Prévia dos repositórios” mostra os primeiros sincronizados; a lista completa fica na página Repositórios.

Feche issues ao mesclar PR

  1. 1

    No cartão `Fechar issues ao mesclar PR`, ative `Fechar issues quando o PR for mesclado`.

  2. 2

    Escolha o destino em `Mover issues mescladas para`.

    Concluído marca a issue como finalizada e define a data de conclusão. Pronto p/ deploy mantém a issue mesclada, aguardando o deploy.

  3. 3

    Clique em `Salvar`.

    Salvar exige autenticação de dois fatores.

    resultado
    Ao mesclar um PR que referencia uma issue, ela muda para o status escolhido automaticamente.

Permissão diferente do resto do Forge

Só administradores ou gerentes do time alteram esta configuração — é o papel no time, não o papel no Forge — e salvar exige MFA. A própria tela avisa: “Por segurança, salvar estas alterações exige autenticação de dois fatores (MFA).”

Próximo