Integração com GitHub Enterprise Server

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

1. GitHub App (Recomendado) — Registre e instale um GitHub App dedicado na sua instância do GHES ou GHEC. Isso torna a configuração mais simples e não exige o gerenciamento de tokens de acesso pessoal.
2. Token de Acesso Pessoal (PAT) — Crie uma conta de serviço e gere um token de acesso pessoal com permissões granulares. Esse método funciona em todas as versões do GHES.

1. Registro do app — Registre um GitHub App na sua instância do GHES ou GHEC. Você só precisa de um registro de app por instância.
2. Configuração do app — Configure o app registrado na sua instância do GHES ou GHEC (por exemplo, torne-o público e desative a expiração do token).
3. Instalação do app — Instale o app registrado em cada organização do GitHub que o Devin deve acessar. Você precisa de uma instalação por organização.

• Um usuário do Devin com Gerenciar permissões do Git
• Acesso de proprietário ou de administrador à organização do GitHub onde o App será registrado

1. Na sua conta do Devin, acesse Configurações do Enterprise → Integrações → GitHub.
2. Expanda a seção Avançado para exibir as opções do GitHub Enterprise.

3. Clique em Registrar app.
4. No modal exibido, insira o hostname da sua instância do GHES ou GHEC e a organização em que o GitHub App será registrado.

5. Você será redirecionado ao GitHub. Clique em Registrar app para concluir o registro.

6. Após ser redirecionado de volta ao Devin, o GitHub App já estará registrado na sua organização no GitHub.

1. Na sua instância GHES ou GHEC, acesse a organização do GitHub especificada durante o registro.
2. Vá para Configurações → Configurações do desenvolvedor → GitHub Apps e selecione o app do Devin.

3. Na seção Avançado, em Zona de perigo, clique em Tornar público. Isso permite que o app seja instalado em outras organizações na mesma instância.
4. Vá até a seção Recursos opcionais e desative Expiração do token de usuário para servidor. Isso evita que os tokens de acesso expirem e que os usuários precisem reautorizar o app periodicamente.

1. Na sua conta do Devin, navegue até Configurações do Enterprise → Integrações → GitHub.
2. Expanda a seção Avançado e clique em Instalar app.
3. No modal, selecione o GitHub App registrado na sua instância GHES ou GHEC.

4. Você será redirecionado para o GitHub, onde poderá escolher uma organização do GitHub e selecionar quais repositórios conceder acesso ao Devin. Recomendamos conceder acesso a todos os repositórios.
5. Depois de concluir a instalação, você será redirecionado de volta ao Devin. Uma nova conexão Git aparecerá em Configurações → Integrações → GitHub.

1. No seu GitHub Enterprise, crie uma nova conta no GitHub para o Devin usar. Isso é importante para garantir que todo o acesso e utilização do Devin possam ser devidamente rastreados e gerenciados.
2. Adicione a conta de serviço recém-criada a todas as organizações relevantes do GitHub como membro (Member). Verifique se a conta tem acesso a todos os repositórios que se espera que o Devin acesse.

1. Com a conta de serviço conectada, clique na foto de perfil no canto superior direito e depois clique em Settings.
2. Na barra lateral esquerda, clique em Developer settings.
3. Na barra lateral esquerda, em Personal access tokens, clique em Fine-grained tokens.
4. Clique em Generate new token.
5. Adicione o Token name e a Expiration.
   Observação: Quando o token expirar, o Devin perderá imediatamente todo o acesso ao GitHub e será necessário criar um novo token.
6. Em Resource owner, selecione a organização correta.

7. Em Repository access, selecione em quais repositórios você deseja que o Devin trabalhe. Os tokens sempre incluem acesso somente leitura a todos os repositórios públicos no GitHub.
8. Certifique-se de que o token tenha as seguintes permissões, que são necessárias para o Devin funcionar corretamente:

9. Clique em Generate Token e salve o token exibido.
   Observação: Pode ser necessária aprovação de administrador, dependendo das suas configurações do GitHub.
10. Para validar que o token possui todos os acessos e permissões necessários, crie e faça push de um branch de teste da sua máquina local para um repositório na organização.
11. Depois que o token tiver sido gerado e testado, entre em contato com seu ponto de contato na Cognition para concluir o processo de configuração. Se você não estiver atualmente trabalhando diretamente com nossa equipe, entre em contato pelo e-mail enterprise@cognition.ai.

# Authenticate with gh CLI using your token
export GH_TOKEN=your_personal_access_token
export GH_HOST=your-github-enterprise-server.com

# Clone the repository
gh repo clone your-organization/your-repository
cd your-repository

# Create a test branch
git checkout -b test-devin-token-$(date +%s)

# Make a small change
echo "# Test" >> TEST.md
git add TEST.md
git commit -m "Test: Validate Devin token permissions"

# Push the branch (tests contents write permission)
git push origin HEAD

# Create a pull request (tests pull requests write permission)
gh pr create --title "Teste: Validar permissões do token Devin" \
  --body "Este é um PR de teste para validar permissões do token." \
  --base main

# Clean up: close the test PR and delete the test branch
gh pr close pr-number --delete-branch

• Recomendamos habilitar proteções de branch no branch master para garantir que as verificações sejam aplicadas antes que o Devin possa fazer merge de qualquer alteração.
• Se o Devin estiver conectado à conta do GitHub da sua organização, ele terá as mesmas permissões para qualquer usuário com acesso às organizações do GitHub e do Devin.
• O Devin não espelhará as permissões do usuário que estiver executando uma sessão com ele; manterá as permissões concedidas no nível da organização.
• O Devin não pode criar novos repositórios na sua conta do GitHub.