A step-by-step guide to migrating from Perforce to Git

Passaggio 2: utenti e autorizzazioni

Dopo lo spostamento dei dati, la task successiva solitamente consiste nell'iniziare a mappare i tuoi utenti e le tue autorizzazioni in nuovi progetti Bitbucket. Se usi LDAP per un elenco utenti, risparmierai un po' di tempo qui. Altrimenti, puoi facilmente estrarre un set di account utente da Perforce usando il comando p4 users –o e poi inserirli in Bitbucket un progetto alla volta.

Tradurre le autorizzazioni Perforce nelle autorizzazioni Bitbucket equivalenti può essere difficile perché le autorizzazioni Perforce sono granulari e complesse, con la possibilità di escludere l'accesso a singoli file. Questo complicato schema di autorizzazione è uno dei motivi per cui un server Perforce può bloccarsi: ogni tentativo di accesso può far sì che il server esegua un calcolo costoso su una struttura dati complicata.

Nella maggior parte dei casi è più veloce chiedere ai responsabili del progetto di definire un set più semplice di autorizzazioni in Bitbucket utilizzando le normali autorizzazioni a livello di progetto, repository e branch. In effetti, vorrai comunque rivedere la configurazione delle tue autorizzazioni, poiché Git offre davvero tante nuove opzioni di flusso di lavoro. Ad esempio, in Perforce potresti aver limitato la creazione di branch, mentre in Bitbucket potresti dover limitare solo l'accesso push al branch principale.

Fase 3: file binari

Se hai archiviato grandi blob binari in Perforce, pensa attentamente a come vuoi gestirli in Git. Potresti provare Git LFS, oppure potresti semplicemente usare un normale sistema di gestione degli artefatti. In ogni caso ti consigliamo di non eseguire semplicemente il push di blob di grandi dimensioni in un repository Git.

Fase 4: dipendenze complesse

A Perforce working copy may actually map in read-only copies of data from several modules. In Git, this is done either using submodules, subtrees, or by leveraging CI/CD or artifact management systems. There’s no easy answer here, but some data import tools can model a submodule relationship between Git repos. For a more in depth look on how to use submodules or subtrees, you can read about each here: https://www.atlassian.com/git/tutorials/git-subtree.

Fase 5: come strutturare il tuo team durante la migrazione

Quindi, il tuo server Perforce ha 100 progetti da 10 team. Hai una strategia e un set di strumenti per la migrazione predisposti. Pianifica la finestra di manutenzione e vai!

Ehm... no.

Ricorda che cambiare strumento SCM riguarda tanto gli sviluppatori quanto i dati. Hai persone, procedure e orari da considerare: non cercare di fare tutto in una volta sola. È troppo rischioso.

Devi prendere in considerazione un piano di progetto durante la fase effettiva della migrazione. Potrebbe ad esempio essere un buon momento per provare un nuovo flusso di lavoro in Jira oppure ecco altre opzioni che puoi esaminare.

• Esegui la migrazione squadra per squadra e progetto per progetto. Cerca di avviare un progetto e un team all'inizio di uno sprint o di un incremento del programma, quando hai del tempo per adattarti.
• Migra in modo incrementale. Importa tutti i tuoi dati in un fine settimana, ma poi lascia che i team completino lentamente il passaggio a Git nel tempo. Ritira periodicamente i delta rieseguendo gli strumenti di importazione. Sebbene sia più complessa, questa strategia è ideale se hai dipendenze tra i team e gli early adopter hanno bisogno almeno di un'istantanea recente in Git da inserire nella loro pipeline CI/CD.
• Usa entrambi i sistemi contemporaneamente per un periodo di tempo. Anche se non è una scelta semplice, è tecnicamente fattibile usare Git Fusion per fare uno scambio di dati bidirezionale purché non si eseguano operazioni complesse che confonderanno il traduttore di dati.

Infine, prendi del tempo per comunicare i cambiamenti al team: la motivazione, il perché e una serie di passaggi su come farlo. Scegli un team di «early adopter» con ingegneri esperti nell'intero ciclo di vita dello sviluppo del software e chiedi a quel team di fungere da modello per gli altri. Trova campioni Git che aiutino le persone quando hanno difficoltà. Apportare modifiche piccole, comprensibili e iterative aiuterà questo processo ad avere successo.

Step 6: Mirrors and clusters

Perforce dispone di un sistema semplice ma efficace per il mirroring dei dati su siti remoti per ridurre l'effetto della latenza. Ha un sistema più complesso per l'esecuzione di un set di mirror locali per il clustering di sola lettura. Sebbene la latenza semplicemente non sia così preoccupante per Git, se stai eseguendo un'operazione in tutto il mondo dovresti dare un'occhiata a Bitbucket Data Center sia per il clustering che per il mirroring, che velocizzerà notevolmente i tempi di clonazione per un team globale.

Step 7: ALM tools

E ora una buona notizia: hai molte scelte per il tuo stack di strumenti ALM quando passi da Perforce a Git. Praticamente tutti gli strumenti per sviluppatori e ALM disponibili funzionano con Git e ovviamente Bitbucket ti offre un'ottima integrazione con Jira e Bamboo. Durante la transizione a Git, puoi esplorare le funzionalità di Bamboo come i Plan Branches, che sfruttano il flusso di lavoro di un branch di funzionalità.

Fase 8: definire il successo

Quindi, come si misura esattamente il successo durante una migrazione da Perforce a Git? In molti progetti di migrazione tendiamo a concentrarci troppo sulla fedeltà del trasferimento dei dati. Ma questa non è una metrica utile per molte ragioni. È probabile che non si possa mai ottenere una cronologia bit per bit in Git che sia esattamente l'equivalente degli eventi in un sistema SCM centralizzato come Perforce.

Un approccio più pratico consiste nell'utilizzare CI/CD per la verifica. Una volta che passi la tua pipeline CI/CD da Perforce a Git, tutti i tuoi test sono ancora validi? E puoi ancora distribuire il tuo software? Se tutte le tue importanti build più vecchie possono ancora passare attraverso la tua pipeline CI/CD, allora il tutto ha avuto successo.

E questo è tutto

Quindi ora hai capito perché assistiamo a uno spostamento da Perforce a Git e come farlo in concreto. Il passaggio successivo è scegliere una soluzione Git. Se stai passando da Perforce per lo sviluppo di giochi, scopri perché gli sviluppatori di giochi amano Bitbucket.