> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sincronização com GitLab

> Vincule sua conta do GitLab, importe ou exporte um projeto, sincronize alterações nos dois sentidos e desvincule.

Conecte um projeto a um repositório do GitLab. As alterações vão nos dois sentidos, e só quando você clica em **Sync**: nada é sincronizado sozinho.

> [!NOTE]
>
> Um administrador precisa ativar primeiro a [sincronização com GitLab](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md).

## Vincular sua conta do GitLab

Você faz isso uma vez.

**1. Abra as configurações da conta**

Clique em **Account** e depois em **Account settings**. Em **Project synchronisation**, encontre **GitLab** e clique em **Link**.

![A seção GitLab das configurações da conta com um botão Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cd34b300ea3566a7083df441f465a163)

GitLab nas configurações da conta

**2. Autorize no GitLab**

O GitLab abre. Faça login se for solicitado e depois autorize o aplicativo.

**3. Verifique o vínculo**

Você volta às configurações da conta. Uma mensagem verde informa que sua conta do GitLab está vinculada, e o botão agora diz **Unlink**.

![A seção GitLab das configurações da conta com um botão Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f187b1d6ba770789495f03ecac75c7f7)

Sua conta do GitLab está vinculada

Se sua conta ainda não estiver vinculada, **Import from GitLab** e o cartão **GitLab** no editor pedem que você a vincule primeiro. Clique em **Link to your GitLab account**. Você também chega às configurações da conta, em uma nova aba se tiver começado no editor. Depois volte e comece de novo.

![A caixa de diálogo Import from GitLab com um botão Link to your GitLab account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=50ded943f918001121d5a00ef345d008)

O aviso quando sua conta não está vinculada

## Importar um repositório

Isso cria um novo projeto a partir de um repositório do GitLab, já vinculado a ele.

**1. Abra a caixa de diálogo de importação**

Na página de projetos, clique em **New project** e depois em **Import from GitLab**.

![O menu New project com Import from GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=4065d1b3b3e2fc5542272e38e2d01f61)

O menu New project

**2. Escolha o repositório**

Clique em **Import to Overleaf** ao lado do repositório. A lista inclui seus repositórios e os dos seus grupos.

![A caixa de diálogo Import from GitLab listando quatro repositórios](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cb0ba36bfa954e101ec1ccd8dac0bca3)

Seus repositórios do GitLab

**3. Verifique o projeto**

O novo projeto abre com os arquivos do repositório.

![O editor mostrando o projeto importado com seus arquivos e o PDF compilado](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=a467df37fd623dffe523b5a92ebc47c1)

O projeto importado

## Exportar um projeto para um novo repositório

Isso cria um repositório a partir de um projeto e os vincula. Um projeto só pode ser vinculado dessa forma ou por importação: não é possível vinculá-lo a um repositório que já existe.

**1. Abra o GitLab no editor**

Abra o projeto. Na barra à esquerda, clique em **Integrations** e depois em **GitLab**.

![O painel Integrations com o cartão GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=df24d11afeb5bbec55a8a745fd58f47a)

O painel Integrations

**2. Preencha o repositório**

Escolha o **Owner**, que pode ser você ou um dos seus grupos. Quando você escolhe um grupo, esse campo se chama **Organization**. **Repository Name** começa com o nome do projeto. A descrição é opcional, e **Private** vem selecionado por padrão. Clique em **Create a GitLab repository**.

![O formulário Export Project to GitLab preenchido](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=ba5191a105be584e994ad663565ee511)

Export Project to GitLab

Se o nome já estiver em uso, a caixa de diálogo diz **Please check that the repository name is valid, and that you have permission to create the repository.** Altere o nome e clique no botão de novo.

**3. Verifique o vínculo**

A caixa de diálogo agora diz **This project is linked to** e nomeia o repositório.

![A caixa de diálogo Sync with GitLab após a exportação](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6e18dc3c00fb9a29b3bb2f1a76cec08e)

O projeto está vinculado

## Sincronizar

**1. Abra a caixa de diálogo de sincronização**

Abra um projeto vinculado. Na barra à esquerda, clique em **Integrations** e depois em **GitLab**.

**Recent commits in GitLab** lista o que vai entrar no projeto.

![A caixa de diálogo Sync with GitLab listando um novo commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e67529c0cad7a0cb7eafaa5f8d134b0a)

Um novo commit esperando no GitLab

**2. Descreva suas alterações**

Se você alterou algo no projeto, aparece um campo para a mensagem de commit. Ele é opcional: se você deixá-lo vazio, o commit se chama `Updates from Overleaf`.

![A caixa de diálogo Sync with GitLab com uma mensagem de commit preenchida](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=45677a6ea3a96235bcde72e1cdaa436a)

A mensagem de commit das suas alterações

**3. Clique em Sync**

Clique em **Sync**. Os novos commits do GitLab entram no projeto, e suas alterações vão para o branch padrão do repositório. Se os dois lados alteraram coisas diferentes, elas são mescladas para você.

**4. Verifique o resultado**

A caixa de diálogo mostra **No new commits in GitLab since last merge.** e o campo da mensagem de commit desaparece. Os arquivos no editor e os commits no GitLab estão atualizados.

![A caixa de diálogo Sync with GitLab após a sincronização, sem novos commits](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=74dd7ceacb36ac0289d76504e95e7ba7)

Tudo está sincronizado

### Se as mesmas linhas mudaram dos dois lados

A caixa de diálogo informa que as alterações não puderam ser mescladas e nomeia um novo branch, `overleaf-YYYY-MM-DD-HHMMSS`, que contém suas alterações. O Overleaf também abre um merge request a partir desse branch no GitLab.

![A caixa de diálogo Sync with GitLab com um aviso de conflito de mesclagem](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=da33555666132affd667ce24b61221c9)

Um conflito

1. Mescle esse branch no branch padrão no GitLab ou com Git. Você pode fechar a caixa de diálogo nesse meio-tempo: ela mostra a mesma mensagem quando você a abre de novo.
2. Clique em **I have manually merged. Continue**. O resultado mesclado entra no projeto. Se você clicar antes de o branch ser mesclado, a caixa de diálogo continua como está.
3. O branch fica no GitLab, a menos que você o tenha excluído ao mesclar. Exclua-o quando não precisar mais dele.

A mesma caixa de diálogo aparece quando as regras de mesclagem do repositório retêm o merge request, por exemplo quando ele precisa de uma aprovação, mesmo que nenhuma linha esteja em conflito. Assim que a regra permitir, mescle o merge request no GitLab e clique em **I have manually merged. Continue**. Consulte [Como a sincronização com o GitLab funciona](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#how-syncing-works-with-gitlab).

## Desvincular um projeto

Faça isso quando não quiser mais que o projeto seja sincronizado.

**1. Clique em Unlink**

Na caixa de diálogo de sincronização, clique em **Unlink**.

**2. Confirme**

Clique em **Confirm**. Isso só remove o vínculo: a conexão com um repositório do qual você é dono, mencionada no aviso, é uma opção que você terá depois, não algo que acontece agora.

![A caixa de diálogo Sync with GitLab pedindo para confirmar a desvinculação](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8d7469fda58abd012ed1364f9f54005d)

Confirme a desvinculação

**3. Verifique o resultado**

A caixa de diálogo agora mostra **Export Project to GitLab**. O projeto e o repositório mantêm seu conteúdo. Para sincronizar de novo, exporte o projeto para um novo repositório ou importe o repositório para um novo projeto.

## Desvincular sua conta do GitLab

Em **Account settings**, em **GitLab**, clique em **Unlink** e depois em **Unlink** novamente na caixa de diálogo.

![A caixa de diálogo Unlink GitLab Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=478ab26a1f13d3a9cb08ffc15ad64bc1)

Desvincule sua conta

Seus projetos continuam vinculados aos repositórios. Você não pode sincronizá-los até vincular sua conta de novo.

> [!NOTE]
>
> Para saber quem pode fazer o quê em um projeto compartilhado, consulte [Quem pode vincular e sincronizar](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#who-can-link-and-sync).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.