> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instale o app do provedor Git

> Dê aos builds de ambiente em segundo plano acesso aprovado aos seus repositórios com uma instalação do GitHub App ou uma concessão de grupo do GitLab, separado do acesso pessoal.

Conecte seu provedor Git para que o Replit possa acessar repositórios em builds de ambiente compartilhados. Este passo a passo usa o GitHub; você também pode [conectar um grupo do GitLab](#gitlab-conecte-um-grupo-e-selecione-projetos).

Um build de ambiente roda sem a sua sessão pessoal de chat, por isso precisa de uma conexão de workspace, e não da conexão da sua conta pessoal (Personal account). Você deve ser administrador do workspace para configurar o acesso compartilhado. Os membros podem visualizá-lo e gerenciar o próprio login pessoal.

> [!NOTE]
>
> Este fluxo em acesso antecipado pode não estar disponível em todos os workspaces.

## GitHub: instale o GitHub App do Replit

**1. Abra sua conexão com o GitHub**

Abra [Repositories](https://replit.com/repos) e selecione **Manage** no card do GitHub. Se você ainda não estiver conectado, selecione **Connect** e entre primeiro.

![Página Repositories com os cards de conexão do GitHub e do GitLab destacados.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/provider-cards.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=ca5ffa6fc9d3849fc57a26746f4030f9)

**2. Configure o acesso compartilhado**

Selecione **Configure** ao lado de **GitHub App**.

![Caixa de diálogo da conexão com o GitHub com o botão Configure destacado.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/configure-github.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=78c6766b8632ed165ee1b8d2e11251ae)

**3. Adicione sua organização**

Selecione **Add GitHub organization** para abrir a página de instalação do GitHub.

![Configurações da organização no GitHub com Add GitHub organization destacado.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/add-organization.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=9d708646d465c53b69dca7acbf7b10ee)

Escolha a organização em que deseja instalar o Replit. Para uma instalação existente, selecione **Configure**.

![O GitHub perguntando onde instalar o Replit, com a organização Replit disponível para configurar.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/choose-organization.png?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=45625ac4a235b0ddc42930116ce48208)

**4. Escolha o acesso aos repositórios**

Escolha **All repositories** ou **Only select repositories**, revise as permissões solicitadas e selecione **Install**. Para uma instalação existente, selecione **Update access**. O administrador do GitHub pode precisar aprová-la.

![Página de instalação do GitHub mostrando as opções All repositories e Only select repositories, as permissões solicitadas e o botão Install.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/repository-permissions.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=16852b935103770fef58dd9aac2cde93)

**5. Confirme a conexão**

Volte ao Replit e selecione **Refresh**, se necessário. Ative a organização para a criação de sandboxes. A instalação por si só não ativa esse acesso: no exemplo acima, a organização ainda mostra **Enable**.

Confirme que a organização está ativada antes de criar o build do seu ambiente.

O GitHub gerencia as permissões de repositório da instalação. Revise essas configurações com o administrador do GitHub se um repositório estiver ausente.

## GitLab: conecte um grupo e selecione projetos

O GitLab usa concessões de grupo e de projeto, não uma instalação de app no estilo do GitHub.

**1. Entre no GitLab**

Abra [Repositories](https://replit.com/repos) e conecte o GitLab. Selecione **Manage** no card dele e abra a configuração de conexão do workspace para ver seus grupos.

**2. Conecte seu grupo**

Escolha **Configure** ao lado de um grupo. Selecione os projetos a compartilhar e depois escolha **Connect group**.

**3. Confirme a conexão**

Confirme que o grupo mostra **Connected**. Para alterar os projetos selecionados depois, escolha **Edit**.

Se um grupo ou projeto estiver ausente, verifique suas permissões no GitLab e os requisitos de aprovação da sua organização.

## Desconecte o acesso compartilhado

Em Repositories > Manage > Configure, escolha Disconnect para a concessão salva do workspace no GitHub ou para o grupo do GitLab. Isso remove o acesso desse workspace por meio da concessão, não o seu login pessoal nem a instalação do GitHub App no lado do provedor.

Builds e projetos que dependem da concessão perdem o acesso ao repositório. Desconectar um grupo do GitLab também remove a conta de serviço do Replit, as associações e os webhooks dele, e revoga os tokens de build existentes.

Para manter um grupo do GitLab conectado, mas remover projetos individuais, use Edit. Remover projetos revoga o acesso do workspace a eles e pode invalidar tokens de build existentes.

## Crie o build do seu ambiente

Volte a [Crie um ambiente reutilizável](https://docs.replit.com/pt/build/code/create-reusable-environment.md). Se o checkout falhar, verifique a conexão do workspace e as permissões de repositório dela. Nunca coloque um token pessoal em uma etapa de build, em um arquivo-fonte ou em uma imagem.

Para outros recursos de desenvolvimento, consulte [segredos do chat ou um gerenciador de segredos externo](https://docs.replit.com/pt/build/code/adding-secrets-to-environments.md) para acesso exclusivo do chat versus acesso reutilizável, e [identidades de máquina](https://docs.replit.com/pt/build/code/machine-identities.md) para a confiança entre provedores. Nenhum dos dois substitui uma conexão de workspace.
