Skip to main content

​
Perché integrare Devin con GitLab?

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

​
Configurare l’integrazione

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

​
Configurazione del webhook

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
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.
Una volta configurato, Devin sarà in grado di rispondere agli eventi di GitLab in tempo reale, anziché basarsi sul polling periodico.

​
Repository Permissions

​
Per gli utenti Core e Teams

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

​
Per gli utenti Enterprise

Una volta configurata l’integrazione, puoi delegare i repository a organizzazioni specifiche da 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.
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.

​
Collegamento utente

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 > 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 nelle impostazioni del tuo account personale
  3. Individua la riga GitLab e fai clic su Link, quindi completa l’autorizzazione GitLab
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.

​
Usare Devin con l’integrazione GitLab

Dopo aver collegato GitLab, configura i tuoi repository su Devin’s Machine.
Come Devin risponde ai commenti sulle MR. Una volta configurato il webhook, 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 > 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.

​
Best practice

  • 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

​
Supporto

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