Vai al contenuto principale

Perché integrare Devin con Bitbucket?

Integrare Devin con i tuoi repository Bitbucket consente a Devin di creare pull request, leggere e rispondere ai commenti sulle tue PR e collaborare in modo efficace con il tuo team. In questo modo Devin può diventare un vero collaboratore all’interno del tuo team di ingegneria.

Prerequisiti

Prima di configurare l’integrazione con Bitbucket, consigliamo:
  • Account di servizio dedicato - Crea un nuovo account Bitbucket dedicato a Devin (ad es. devin@yourcompany.com) invece di usare un account utente esistente, per una gestione più chiara degli accessi e dei log di audit
Usare un account di servizio dedicato rende più semplice tracciare l’attività di Devin, gestire le autorizzazioni e mantenere le best practice di sicurezza in tutta l’organizzazione.

Configurare l’integrazione

Bitbucket Cloud

Esistono due tipi di connessione a Bitbucket Cloud. Scegli quella più adatta a ciò che Devin deve fare: Le “operazioni di scrittura di Devin” sono le pull request aperte da Devin e i risultati e gli aggiornamenti della descrizione pubblicati da Devin Review. Le azioni che esegui personalmente in Devin Review (commenti, risposte, rifiuto di una pull request) vengono pubblicate a tuo nome dal tuo Account Bitbucket collegato, con entrambi i tipi di connessione; vedi Devin Review.
Devin installa autonomamente i webhook necessari per l’auto-review di Devin Review, con entrambi i tipi di connessione, ma solo se la connessione dispone dei permessi di amministrazione sul repository: un token di accesso con Webhooks: Read and write e Repositories: Admin, oppure una connessione OAuth il cui Account Bitbucket collegato è amministratore del repository. In caso contrario, il repository risulta come Skipped nello stato dei webhook della connessione, insieme al motivo indicato da Bitbucket, e le revisioni vengono eseguite solo quando apri personalmente una pull request in Devin Review.

Connessione con un token di accesso

  1. In Bitbucket, crea un token di accesso al workspace per il workspace in cui Devin deve operare, con questi ambiti:
    • Repositories: Admin
    • Pull requests: Write
    • Webhooks: Read and write
    Con ambiti più ristretti, Devin non può leggere lo stato di merge né installare i webhook.
  2. Nel tuo Account Devin, vai a Settings > Connections > Bitbucket, apri il menu a discesa accanto al pulsante Connect e seleziona Connect with access token.
  3. Inserisci l’ID del workspace (la parte my-workspace in bitbucket.org/my-workspace) e il token, quindi fai clic su Connect.
Devin usa il token per questo workspace e pubblica a nome del token, non a nome tuo. Quando la connessione è attiva, Devin installa autonomamente i propri webhook sui repository del workspace; il pannello dei dettagli della connessione mostra l’esito per ciascun repository e un pulsante Refresh per ripetere l’installazione.

Connessione con OAuth

Usa OAuth se il tuo workspace non è su Bitbucket Cloud Premium. Una connessione OAuth coincide con l’autorizzazione Bitbucket dell’account collegato: le operazioni di scrittura di Devin (le pull request che apre, i risultati e gli aggiornamenti della descrizione pubblicati da Devin Review) risultano eseguite da quell’account, e i webhook vengono installati solo sui repository che quell’account amministra. Per questo i passaggi seguenti iniziano con un account Bitbucket dedicato: non collegare mai l’account di una persona per l’organizzazione. Se la connessione è stata collegata prima che l’app Bitbucket di Devin potesse gestire i webhook, i relativi repository vengono mostrati come Skipped finché non la sostituisci.
  1. Crea un nuovo account Bitbucket specifico per Devin (proprio come creeresti un account personale). Userai questo account, non quello personale, durante il processo di integrazione.
  2. Nel tuo account Devin, vai su Settings > Connections > Bitbucket e fai clic su “Connect”.
Connetti Bitbucket Cloud
  1. Verrai reindirizzato a Bitbucket, dove dovrai:
    • Accedere con l’account Bitbucket che hai creato per Devin (non il tuo account personale)
    • Concedere le autorizzazioni necessarie affinché Devin possa lavorare con i tuoi repository
  2. Una volta completata la procedura, tornerai alla pagina delle impostazioni di Devin, dove potrai confermare che l’integrazione è attiva.

Sostituire una connessione OAuth meno recente

Una connessione OAuth mantiene le autorizzazioni che aveva al momento del collegamento. Per questo motivo, una connessione collegata prima che l’app Bitbucket di Devin potesse gestire i webhook mostra i propri repository come Skipped e il relativo stato dei webhook ti chiede di riconnetterla. Non è possibile riconnetterla direttamente: se ti colleghi di nuovo, viene aggiunta una seconda connessione con lo stesso nome e la prima resta Skipped. Sostituisci quindi la vecchia connessione:
  1. Apri il pannello dei dettagli della connessione e prendi nota delle modifiche che hai apportato, ad esempio le autorizzazioni dei repository e Manage access. Nessuna di queste impostazioni viene trasferita alla nuova connessione.
  2. Nella scheda General, fai clic su Disconnect connection. Devin non avrà accesso a questi repository finché il passaggio successivo non sarà completato.
  3. In Settings > Connections > Bitbucket, apri il menu a discesa accanto a Connect with access token, seleziona Connect with OAuth (any Bitbucket plan) e accedi con lo stesso account Bitbucket.
  4. Riapplica le impostazioni annotate nel passaggio 1. La nuova connessione ha inizialmente accesso a tutti i workspace visibili all’account collegato. In un account Enterprise, invece, inizialmente non ha accesso ad alcuna organizzazione, quindi concedi di nuovo l’accesso alle tue organizzazioni.
A questo punto Devin installa autonomamente i webhook e il pannello dei dettagli della nuova connessione mostra il risultato per ciascun repository. Se ti sei già collegato di nuovo, avrai due connessioni con lo stesso nome. Prendi nota delle impostazioni di entrambe, disconnettile entrambe e collegati una sola volta come descritto nei passaggi 3 e 4.

Bitbucket Data Center

Per le organizzazioni che utilizzano Bitbucket Data Center (self-hosted), segui questi passaggi:
  1. Crea un account di servizio dedicato nella tua istanza di Bitbucket Data Center per Devin.
  2. Nel tuo account Devin, vai su Settings > Connections > Bitbucket, apri il dropdown accanto al pulsante Connect e seleziona Connect with Bitbucket Data Center.
Connetti Bitbucket Data Center
  1. Configura la connessione fornendo:
    • Bitbucket Host: il dominio del tuo Bitbucket Data Center (ad es. bitbucket.mycompany.com)
    • Bitbucket Username: lo username dell’account di servizio
    • Bitbucket token di accesso HTTP: un token di accesso HTTP creato per l’account di servizio. Puoi sostituirlo in seguito tramite Rotate access token nel pannello dei dettagli della connessione.
Configurazione di Bitbucket Data Center
  1. Concedi all’account di servizio le autorizzazioni appropriate per progetti e repository nella tua istanza di Bitbucket Data Center.
  2. Una volta completata la configurazione, vedrai lo stato dell’integrazione confermato nelle impostazioni del tuo account Devin.

Configurazione del webhook (Bitbucket Data Center)

La configurazione di un webhook consente a Devin di ricevere in tempo reale gli eventi delle pull request da Bitbucket Data Center, in modo che lo stato e i commenti della PR vengano recapitati alla sessione Devin che sta lavorando sulla PR.
  1. Nel tuo account Devin, vai su Settings > Connections > Bitbucket e clicca sulla connessione Bitbucket Data Center per aprirne il pannello dei dettagli.
  2. Nella scheda General, clicca su Configure nella riga Webhook. La finestra di dialogo mostra l’URL del webhook e un token segreto: copia subito il token, perché viene mostrato una sola volta (potrai rigenerarlo in seguito dalla stessa finestra di dialogo).
  3. In Bitbucket Data Center, apri le impostazioni del repository o del progetto e vai su Webhooks.
  4. Crea un webhook e incolla l’URL del webhook.
  5. Tra gli eventi Pull request, seleziona Opened, Source branch updated, Merged, Declined e Comment added.
  6. In Authentication, scegli Basic, inserisci un username qualsiasi e incolla il token segreto come password.
Le connessioni Bitbucket Cloud non prevedono una finestra di dialogo per il webhook: Devin installa autonomamente i webhook su una connessione tramite token di accesso oppure su una connessione OAuth il cui account Bitbucket collegato è amministratore del repository.
Per impostazione predefinita, tutte le azioni di Devin su Bitbucket Data Center vengono attribuite all’account di servizio. Collegando il tuo account puoi commentare, aggiungere o rimuovere reviewer, approvare e rifiutare le pull request da Devin Review a tuo nome. Configurazione da parte dell’amministratore (una sola volta per ogni host Bitbucket Data Center):
  1. In Devin, vai su Settings > Connections > Bitbucket e fai clic su Register app nella sezione Bitbucket Data Center user OAuth. La finestra di dialogo mostra l’URL di reindirizzamento e le autorizzazioni da utilizzare.
  2. In Bitbucket Data Center, vai su Administration > Application links, seleziona Create link, quindi scegli External application e Incoming. Incolla l’URL di reindirizzamento e concedi l’autorizzazione Repositories: Write.
  3. Incolla il client ID e il client secret dell’applicazione nella finestra di dialogo di Devin e fai clic su Register.
Ogni utente: collega il tuo account Bitbucket quando Devin Review te lo chiede, oppure dalla sezione degli account collegati del tuo profilo.
Se rimuovi l’applicazione registrata in Devin, l’account Bitbucket Data Center di tutti gli utenti su quell’host verrà scollegato.

Usare Devin con l’integrazione Bitbucket

Dopo aver collegato Bitbucket, configura i tuoi repository su Devin’s Machine.
Come Devin risponde ai commenti alle PR.
  • Bitbucket Cloud: Devin non si risveglia automaticamente per i commenti sulle proprie pull request. Può comunque gestirli se glieli segnali direttamente nella sessione. I webhook che Devin installa su una connessione Cloud sono destinati a Devin Review, non alle sessioni.
  • Bitbucket Data Center: una volta configurato il webhook, un commento su una pull request monitorata da una sessione Devin viene inoltrato a quella sessione e Devin risponde. Un organization admin può limitare questo comportamento con Require @Devin to respond in Settings > Devin > Pull requests: in questo modo Devin risponde solo ai commenti che iniziano con @Devin o con Devin come parola a sé stante, ad esempio Devin fix this (è accettato anche il prefisso devinai). I commenti che contengono (aside) o !aside, o che iniziano con aside, vengono sempre ignorati. Senza webhook, Data Center si comporta come Bitbucket Cloud.

Best Practices

  • Crea un account Bitbucket dedicato per Devin
  • Abilita le regole di protezione per i branch main/master
  • Concedi all’account di servizio le autorizzazioni appropriate a livello di workspace e repository
  • Su Bitbucket Cloud, quando ti connetti con OAuth, collega un account Bitbucket creato appositamente per Devin (con ruolo di amministratore del repository); Devin pubblicherà a nome dell’account collegato
  • Su Bitbucket Data Center, configura il webhook in modo che Devin riceva gli eventi delle PR in tempo reale