> ## 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.

# Sincronizzazione con GitLab

> Collega il tuo account GitLab, importa o esporta un progetto, sincronizza le modifiche in entrambe le direzioni e scollega.

Collega un progetto a un repository GitLab. Le modifiche vanno in entrambe le direzioni, e solo quando fai clic su **Sync**: niente si sincronizza da solo.

> [!NOTE]
>
> Un amministratore deve prima attivare la [sincronizzazione con GitLab](https://ayakaleaf-pro.mintlify.site/it/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md).

## Collegare il tuo account GitLab

Lo fai una sola volta.

**1. Apri le impostazioni dell'account**

Fai clic su **Account**, poi su **Account settings**. In **Project synchronisation**, trova **GitLab** e fai clic su **Link**.

![La sezione GitLab delle impostazioni dell'account con un pulsante 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 nelle impostazioni dell'account

**2. Autorizza su GitLab**

Si apre GitLab. Accedi se richiesto, poi autorizza l'applicazione.

**3. Controlla il collegamento**

Torni alle impostazioni dell'account. Un messaggio verde indica che il tuo account GitLab è collegato, e il pulsante ora indica **Unlink**.

![La sezione GitLab delle impostazioni dell'account con un pulsante Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f187b1d6ba770789495f03ecac75c7f7)

Il tuo account GitLab è collegato

Se il tuo account non è ancora collegato, **Import from GitLab** e la scheda **GitLab** nell'editor ti chiedono prima di collegarlo. Fai clic su **Link to your GitLab account**. Anche così arrivi alle impostazioni dell'account, in una nuova scheda se hai iniziato dall'editor. Poi torna indietro e ricomincia.

![La finestra di dialogo Import from GitLab con un pulsante 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)

La richiesta quando il tuo account non è collegato

## Importare un repository

Crea un nuovo progetto da un repository GitLab, già collegato a esso.

**1. Apri la finestra di importazione**

Nella pagina dei progetti, fai clic su **New project**, poi su **Import from GitLab**.

![Il menu New project con 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)

Il menu New project

**2. Scegli il repository**

Fai clic su **Import to Overleaf** accanto al repository. L'elenco include i tuoi repository e quelli dei tuoi gruppi.

![La finestra di dialogo Import from GitLab con quattro repository](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cb0ba36bfa954e101ec1ccd8dac0bca3)

I tuoi repository GitLab

**3. Controlla il progetto**

Il nuovo progetto si apre con i file del repository.

![L'editor con il progetto importato, i suoi file e il PDF compilato](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=a467df37fd623dffe523b5a92ebc47c1)

Il progetto importato

## Esportare un progetto in un nuovo repository

Crea un repository da un progetto e li collega. Un progetto può essere collegato solo in questo modo o tramite importazione: non puoi collegarlo a un repository già esistente.

**1. Apri GitLab nell'editor**

Apri il progetto. Nella barra a sinistra, fai clic su **Integrations**, poi su **GitLab**.

![Il pannello Integrations con la scheda GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=df24d11afeb5bbec55a8a745fd58f47a)

Il pannello Integrations

**2. Compila il repository**

Scegli l'**Owner**, che può essere tu o uno dei tuoi gruppi. Quando scegli un gruppo, questo campo si chiama **Organization**. **Repository Name** parte dal nome del progetto. La descrizione è facoltativa, e **Private** è selezionato per impostazione predefinita. Fai clic su **Create a GitLab repository**.

![Il modulo Export Project to GitLab compilato](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 il nome è già in uso, la finestra di dialogo mostra **Please check that the repository name is valid, and that you have permission to create the repository.** Cambia il nome e fai di nuovo clic sul pulsante.

**3. Controlla il collegamento**

La finestra di dialogo ora indica **This project is linked to** e il nome del repository.

![La finestra di dialogo Sync with GitLab dopo l'esportazione](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6e18dc3c00fb9a29b3bb2f1a76cec08e)

Il progetto è collegato

## Sincronizzare

**1. Apri la finestra di sincronizzazione**

Apri un progetto collegato. Nella barra a sinistra, fai clic su **Integrations**, poi su **GitLab**.

**Recent commits in GitLab** elenca ciò che entrerà nel progetto.

![La finestra di dialogo Sync with GitLab con un nuovo 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)

Un nuovo commit in attesa su GitLab

**2. Descrivi le tue modifiche**

Se hai modificato qualcosa nel progetto, compare un campo per il messaggio di commit. È facoltativo: se lo lasci vuoto, il commit si chiama `Updates from Overleaf`.

![La finestra di dialogo Sync with GitLab con un messaggio di commit compilato](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=45677a6ea3a96235bcde72e1cdaa436a)

Il messaggio di commit delle tue modifiche

**3. Fai clic su Sync**

Fai clic su **Sync**. I nuovi commit da GitLab entrano nel progetto, e le tue modifiche vanno al branch predefinito del repository. Se entrambi i lati hanno modificato cose diverse, vengono unite per te.

**4. Controlla il risultato**

La finestra di dialogo mostra **No new commits in GitLab since last merge.** e il campo del messaggio di commit è sparito. I file nell'editor e i commit su GitLab sono aggiornati.

![La finestra di dialogo Sync with GitLab dopo la sincronizzazione, senza nuovi commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=74dd7ceacb36ac0289d76504e95e7ba7)

Tutto è sincronizzato

### Se le stesse righe sono cambiate su entrambi i lati

La finestra di dialogo indica che le modifiche non sono state unite e nomina un nuovo branch, `overleaf-YYYY-MM-DD-HHMMSS`, che contiene le tue modifiche. Overleaf apre anche una merge request da quel branch su GitLab.

![La finestra di dialogo Sync with GitLab con un avviso di conflitto di merge](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=da33555666132affd667ce24b61221c9)

Un conflitto

1. Unisci quel branch nel branch predefinito su GitLab o con Git. Nel frattempo puoi chiudere la finestra di dialogo: mostra lo stesso messaggio quando la riapri.
2. Fai clic su **I have manually merged. Continue**. Il risultato unito entra nel progetto. Se fai clic prima che il branch sia unito, la finestra di dialogo resta invariata.
3. Il branch resta su GitLab, a meno che tu non l'abbia eliminato durante il merge. Eliminalo quando non ti serve più.

La stessa finestra di dialogo compare quando le regole di merge del repository trattengono la merge request, ad esempio perché richiede un'approvazione, anche se nessuna riga è in conflitto. Quando la regola lo consente, unisci la merge request su GitLab e fai clic su **I have manually merged. Continue**. Consulta [Come funziona la sincronizzazione con GitLab](https://ayakaleaf-pro.mintlify.site/it/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#how-syncing-works-with-gitlab).

## Scollegare un progetto

Fallo quando non vuoi più che il progetto si sincronizzi.

**1. Fai clic su Unlink**

Nella finestra di sincronizzazione, fai clic su **Unlink**.

**2. Conferma**

Fai clic su **Confirm**. Questo rimuove solo il collegamento: la connessione a un repository di tua proprietà, menzionata nell'avviso, è un'opzione che hai in seguito, non qualcosa che accade ora.

![La finestra di dialogo Sync with GitLab che chiede di confermare lo scollegamento](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8d7469fda58abd012ed1364f9f54005d)

Conferma lo scollegamento

**3. Controlla il risultato**

La finestra di dialogo ora mostra **Export Project to GitLab**. Il progetto e il repository conservano entrambi il loro contenuto. Per sincronizzare di nuovo, esporta il progetto in un nuovo repository o importa il repository in un nuovo progetto.

## Scollegare il tuo account GitLab

In **Account settings**, sotto **GitLab**, fai clic su **Unlink**, poi di nuovo su **Unlink** nella finestra di dialogo.

![La finestra di dialogo 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)

Scollega il tuo account

I tuoi progetti restano collegati ai loro repository. Non puoi sincronizzarli finché non colleghi di nuovo il tuo account.

> [!NOTE]
>
> Per sapere chi può fare cosa in un progetto condiviso, consulta [Chi può collegare e sincronizzare](https://ayakaleaf-pro.mintlify.site/it/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.