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

# GitLab

> Collega Devin a GitLab (versione 15.0 e successive) per creare merge request, rispondere ai commenti nelle MR e collaborare nei tuoi repository.

<h2 id="why-integrate-devin-with-gitlab">
  Perché integrare Devin con GitLab?
</h2>

Integrare Devin con i tuoi repository GitLab consente a Devin di creare merge request (MR), leggere e rispondere ai commenti sulle MR e collaborare in modo efficace con il tuo team. Questo permette a Devin di essere un vero collaboratore nel tuo team di sviluppo.

<Note>
  **Utilizzi un'istanza GitLab self-hosted?** Supportiamo GitLab Self-Managed (versione 15.0 e successive) per gli utenti del nostro piano Enterprise. Ti basta fare clic sul menu a discesa del pulsante "Connect" e selezionare **Connect to self-hosted instance**. Consulta la [guida all'integrazione con GitLab Self-Managed](/it/enterprise/integrations/gitlab-self-managed) per le istruzioni complete per la configurazione.

  Lo stesso menu a discesa offre anche **Connect service account**, che collega un service account GitLab.com (o un account utente dedicato nel tier Free) con un token di accesso personale dotato dell'ambito `api`, anziché tramite l'OAuth flow descritto di seguito.
</Note>

<h2 id="setting-up-the-integration">
  Configurare l'integrazione
</h2>

**La configurazione è semplice!** Ecco come iniziare:

1. Crea un nuovo account GitLab dedicato a Devin (proprio come faresti per un account personale). Utilizzerai questo account, e non il tuo account personale, durante il processo di integrazione.

2. Nel tuo account Devin, vai su [Settings > **Connections** > **Gitlab**](https://app.devin.ai/settings/connections) e fai clic su "Connect".

3. Verrai reindirizzato a GitLab, dove dovrai:
   * Accedere con l'account GitLab che hai creato per Devin (non il tuo account personale)
   * Concedere le autorizzazioni necessarie affinché Devin possa lavorare con i tuoi repository

4. Una volta completata la procedura, tornerai alla pagina delle impostazioni di Devin, dove potrai confermare che l'integrazione è attiva.

<Warning>
  Per le installazioni GitLab on-premise (self-hosted), la sincronizzazione dello stato delle MR (aperte, unite, chiuse) con le sessioni di Devin avviene solo una volta al giorno. Questo può comportare uno stato delle MR temporaneamente non aggiornato nella tua sessione o nell'elenco delle sessioni, fino alla successiva sincronizzazione.
</Warning>

***

<h2 id="webhook-configuration">
  Configurazione del webhook
</h2>

La configurazione di un webhook consente a Devin di ricevere automaticamente notifiche in tempo reale quando si verificano eventi specifici in GitLab, come l'apertura o l'aggiornamento di merge request e i commenti sulle merge request.

Per configurare il webhook:

1. Nel tuo account Devin, vai a **Settings** > **Connections** > **GitLab**
2. Fai clic sulla connessione GitLab che vuoi configurare per aprirne il pannello dei dettagli
3. Nella scheda **General**, fai clic su **Configure** nella riga **Webhook**
4. Copia l'**URL** del webhook e il **Secret Token** dalla finestra di dialogo
5. Segui i passaggi **Group** (consigliato) o **Project** indicati nella finestra di dialogo per aggiungere il webhook in GitLab, selezionando i trigger **Comments**, **Merge request events**, **Push events**, **Issues events** e **Pipeline events**

<Note>
  Per aggiungere un webhook in GitLab è necessario il ruolo **Maintainer** sul progetto, oppure il ruolo **Owner** sul gruppo per i webhook di gruppo (disponibili su GitLab Premium e Ultimate). Se per la tua organizzazione è disponibile la configurazione automatica dei webhook, la finestra di dialogo segnala che Devin configura i webhook su tutti i progetti e i gruppi che il suo account GitLab può amministrare; usa i passaggi manuali solo per i progetti a cui non riesce ad accedere.
</Note>

Una volta configurato, Devin sarà in grado di rispondere agli eventi di GitLab in tempo reale, anziché basarsi sul polling periodico.

***

<h2 id="repository-permissions">
  Repository Permissions
</h2>

<h3 id="for-core-and-teams-users">
  Per gli utenti Core e Teams
</h3>

Una volta configurata l'integrazione, puoi @menzionare direttamente i repository nei tuoi prompt nell'app web di Devin.

<h3 id="for-enterprise-users">
  Per gli utenti Enterprise
</h3>

Una volta configurata l'integrazione, puoi delegare i repository a organizzazioni specifiche da [**Settings** > **Repositories**](https://app.devin.ai/settings/repositories).

1. Seleziona l'organizzazione dal menu a discesa nella parte superiore della pagina
2. Fai clic su **Manage permissions**
3. Aggiungi i gruppi o i repository pertinenti con accesso **Read & write** o **Read only**

Per maggiori dettagli, consulta [Repository Permissions](/it/enterprise/integrations/git-integrations#repository-permissions).

<Note>
  Se i repository non vengono visualizzati subito dopo la connessione, Devin aggiorna periodicamente l'elenco dei repository. Puoi anche aggiornare manualmente l'elenco dei repository in Devin.
</Note>

***

<h2 id="user-linking">
  Collegamento utente
</h2>

Oltre alla connessione a livello di organizzazione, i singoli utenti possono collegare il proprio account GitLab a Devin, in modo che Devin possa agire con la loro identità nelle operazioni GitLab, ad esempio aprendo merge request come utente collegato quando **Open PRs as** è impostato su **User** o **User only** in [**Settings** > **Devin**](https://app.devin.ai/settings/devin) > **Pull requests**.

Per collegare un account GitLab personale:

1. Assicurati di far parte di una Devin organizzazione in cui l'integrazione GitLab è già configurata
2. Vai su [Settings > **Connections**](https://app.devin.ai/account/connections) nelle impostazioni del tuo account personale
3. Individua la riga **GitLab** e fai clic su **Link**, quindi completa l'autorizzazione GitLab

<Note>
  **Personal Connections mostra solo le integrazioni delle organizzazioni a cui l'utente appartiene.** La riga **GitLab** compare quando la tua organizzazione dispone di una connessione GitLab.com. Le istanze GitLab self-hosted (piano Enterprise) compaiono come righe **Self-hosted GitLab** separate, contrassegnate dal nome host, e si collegano allo stesso modo. Se non compare alcuna riga GitLab, verifica di far parte di una Devin organizzazione con una connessione GitLab.
</Note>

***

<h2 id="using-devin-with-the-gitlab-integration">
  Usare Devin con l'integrazione GitLab
</h2>

Dopo aver collegato GitLab, configura i tuoi repository su [Devin's Machine](https://app.devin.ai/machine).

<Note>
  **Come Devin risponde ai commenti sulle MR.** Una volta configurato il [webhook](#webhook-configuration), i commenti su una merge request monitorata da una sessione Devin vengono recapitati a quella sessione in tempo reale. Per impostazione predefinita, questo risveglia una sessione in sleep e Devin risponde al commento.

  Per limitare questo comportamento, un amministratore dell'organizzazione può attivare **Require @Devin to respond** in [**Settings** > **Devin**](https://app.devin.ai/settings/devin) > **Pull requests**. Con questa impostazione abilitata, Devin si risveglia e risponde solo ai commenti che iniziano con `@Devin` o con la parola intera `Devin`, ad esempio `Devin fix this` (è accettato anche il prefisso `devinai`). La corrispondenza non fa distinzione tra maiuscole e minuscole.

  I commenti che contengono `(aside)` o `!aside`, oppure che iniziano con `aside`, vengono sempre ignorati indipendentemente da questa impostazione, così puoi discutere della MR senza risvegliare Devin.

  Senza un webhook, i commenti sulle MR non vengono recapitati alla sessione in tempo reale; Devin può comunque gestirli se glieli segnali direttamente nella sessione.
</Note>

<h2 id="best-practices">
  Best practice
</h2>

* Crea un account GitLab dedicato per Devin
* Abilita la protezione per i branch main/master
* Configura il webhook per ricevere notifiche sugli eventi in tempo reale

<h2 id="support">
  Supporto
</h2>

1. Crea un canale Slack Connect col nostro team su [app.devin.ai/settings/support](https://app.devin.ai/settings/support)
2. Condividi i link alle sessioni quando segnali un problema e allega screenshot


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