Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- documentazione_3di_riservata:manuali_sysadmin:cvs2git [2016/01/21 12:06] – aalberghini
+++ documentazione_3di_riservata:manuali_sysadmin:cvs2git [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-====== Migrazione di un progetto da CVS a GIT ======
-Per migrare un progetto dal sistema di versioning CVS a git sono disponibili diverse utility, ma già con quella inclusa nel normale client git (__cvsimport__) è possibile effettuare l'operazione.
-Questo strumento per funzionare __necessita di un accesso diretto al repository CVS da filesystem__, poiché alcune operazioni necessarie per la conversione non possono essere effettuate lato client.
-L'operazione è ripetibile nel caso in cui vengano effettuati nuovi commit sul progetto CVS anche dopo la migrazione a git: questi nuovi commit saranno integrati all'interno del repository git.
-===== Migrazione manuale =====
-Per effettuare la migrazione manualmente bisogna effettuare i seguenti passaggi:
-  * creazione di un nuovo repository git vuoto
-<code bash>
-git --bare init /path/to/new/repo/<CVSMODULE>
-</code>
-  * conversione da CVS a git
-<code bash>
-git --bare cvsimport -d:local:<CVSROOT> -v -k -m -i [-A <AUTHORFILE>] -o master -C /path/to/new/repo/<CVSMODULE> <CVSMODULE>
-</code>
-dove:
-  * <CVSROOT> indica il path assoluto sul file system del repository CVS
-  * /path/to/new/repo indica la locazione su file system del nuovo repository git
-  * <AUTHORFILE> indica un file contenente il mapping tra gli utenti CVS e il nome esteso + mail previsto da git. Ogni riga del file appare come <code>ncognome-3di=Nome Cognome <ncognome@3di.it></code>
-  * <CVSMODULE> indica il nome del modulo CVS (ovvero del progetto)
-Utilizzando questi comandi, verrà prima inizializzato un repository vuoto (bare) all'interno di /path/to/new/repo/<CVSMODULE> e poi verrà importato tutto il codice presente nel module CVS <CVSMODULE> all'interno di /path/to/new/repo/<CVSMODULE>/.git.
-Si riporta un esempio sul progetto mailArchiver. Il progetto mailArchiver è attualmente un modulo con lo stesso nome sotto la CVSROOT /opt/cvs/docway3.
-<code bash>
-git init --bare /opt/git/migrazione/docway3/mailArchiver
-git --bare cvsimport -d:local:/opt/cvs/docway3 -v -k -m -i -A /root/bin/cvs2git.AUTHORS -o master -C /opt/git/migrazione/docway3/mailArchiver mailArchiver
-</code>
-Al termine della migrazione è possibile clonare il repository git appena creato mediante comandi tipo:
-<code bash>
-git clone ssh://user@git.3di.it:/opt/git/migrazione/docway3/mailArchiver/
-</code>
-oppure, sfruttando l'esposizione tramite HTTP del repository((effettuata mediante un reverse proxy su vegezio stesso))
-<code bash>
-git clone http://gittest.bo.priv/migrazione/docway3/mailArchiver/.git
-</code>
-===== Migrazione batch =====
-È stato approntato uno script sul nostro server CVS **vegezio** che automatizza le operazioni necessarie alla migrazione di un singolo progetto (modulo in CVS) oppure di tutti i progetti (moduli) all'interno della stessa CVSROOT (per es., tutti i progetti sotto docway3, docway4, progetti ecc.).
-Lo script è posto in /root/bin/cvs2git.sh e se ne riporta il codice:
-<code bash cvs2git.sh>
-#!/bin/bash
-set -e
-function usage () {
-cat << EOF
-Usage:
-        cvs2git.sh -d CVSROOT [-m MODULE] -o DESTDIR
-where
-        CVSROOT         path to the cvs root of a project (e.g. /opt/cvs/docway4)
-        MODULE          (Optional) module to import (e.g. code)
-        DESTDIR         destination directory for the new git repository. If no MODULE is set, every module found will be put inside this directory
-EOF
-}
-# Conversione di un singolo modulo CVS in git.
-# Argomenti:
-# $1 CVSROOT
-# $2 MODULE
-# $3 DESTDIR
-function convert_module () {
-        mkdir -p "$3/$2"
-        (cd "$3/$2" && git init --bare "$3/$2")
-        git cvsimport -d :local:"$1" -C "$3/$2" -v -k -m -i -A /root/bin/cvs2git.AUTHORS -o master "$2"
-}
-# Conversione di tutti i moduli all'interno di una CVSROOT
-# Argomenti:
-# $1 CVSROOT
-# $2 DESTDIR
-function convert_all_modules () {
-        for module in "$1"/*
-        do
-                if [ -d "$module" -a "$module" != "CVSROOT" ]
-                then
-                        CVS_MODULE_NAME=${module##*/}
-                        convert_module "$1" "$CVS_MODULE_NAME" "$2"
-                fi
-        done
-}
-while getopts "d: m: o:" OPTION
-do
-        case "$OPTION" in
-        d)
-                SRC_CVSROOT="$OPTARG"
-                ;;
-        m)
-                SRC_CVSMODULE="$OPTARG"
-                ;;
-        o)
-                DESTDIR="$OPTARG"
-                ;;
-        esac
-done
-if [ x"$SRC_CVSROOT" == x ]
-then
-        echo "No CVSROOT specified. Exiting."
-        usage
-        exit 1
-fi
-if [ x"$DESTDIR" == x ]
-then
-        echo "No DESTDIR specified. Exiting."
-        usage
-        exit 2
-fi
-if [ x"$SRC_CVSMODULE" == x ]
-then
-        convert_all_modules "$SRC_CVSROOT" "$DESTDIR"
-else
-        convert_module "$SRC_CVSROOT" "$SRC_CVSMODULE" "$DESTDIR"
-fi
-</code>
-====== Migrazione da CVS a Gitlab ======
-Per migrare i progetti CVS su Gitlab è necessario effettuare comunque il passaggio di conversione descritto nei punti precedenti. Una volta terminata la migrazione del progetto o dei progetti, è possibile importarli su Gitlab in diversi modi.
-===== Importazione singolo progetto via HTTP =====
-Questo tipo di importazione è indicato per singoli progetti. È necessario creare un nuovo progetto((magari già in un gruppo consono)) ed indicare di importare un qualsiasi progetto git mediante la sua URL (ultimo bottone). La URL da indicare è composta nel seguente modo:
-<code>http://gittest.bo.priv/PATH/PROGETTO/.git</code>
-tenendo conto che PATH è già relativo al percorso /opt/git sul server vegezio.
-===== Importazione singolo progetto mediante pull e push =====
-Questo tipo di importazione (la più generica in assoluto) prevede l'utilizzo di una qualsiasi macchina client che faccia da ponte tra il repository migrato e Gitlab.
-Per poter effettuare questo tipo di migrazione, è necessario che:
-  * il progetto sia stato migrato in un percorso raggiungibile dal client mediante ssh((controllare i permessi relativi al gruppo gitusers su vegezio))
-  * il progetto di destinazione sia già stato creato su Gitlab
-  * si sia caricata la propria chiave pubblica all'interno del proprio profilo su Gitlab
-Le operazioni da effettuare sono le seguenti:
-  - clonazione del repository migrato sulla propria macchina: <code bash>git clone ssh://user@git.3di.it/path/to/repo</code>
-  - rimozione del remote "origin" attuale (che punterà a git.3di.it): <code bash>git remote remove origin</code>
-  - impostazione del nuovo remote "origin" su Gitlab((copiare la URL fornita da Gitlab stesso quando si visualizza il nuovo progetto)): <code bash>git remote add origin git://gitlab.bo.priv/group/project</code>
-===== Batch import =====
-Questa procedura permette di importare in un colpo solo diversi repository git migrati da CVS.
-I passi da seguire sul server Gitlab sono i seguenti:
-  - creazione del grupp/i che conterranno i nuovi progetti:<code bash>sudo -u git mkdir /var/opt/gitlab/git-data/repositories/GRUPPO</code> dove GRUPPO rappresenta il gruppo/namespace all'interno del quale si vuole che siano posti i repository. Ovviamente si possono creare più gruppi in questa fase.
-  - copia dei repository all'interno di ''/var/opt/gitlab/git-data/repositories/GRUPPO''((o dei vari gruppi)) <code bash>cp -r /path/to/source/repos /var/opt/gitlab/git-data/repositories/GRUPPO</code>
-  - Aggiustamento del proprietario gruppo (devono essere git:git): <code bash>chown -R git:git /var/opt/gitlab/git-data/repositories/GRUPPO/</code>
-  - Aggiornamento DB dei repository ed effettiva importazione in Gitlab: <code bash>gitlab-rake gitlab:import:repos</code>
-A questo punto i repository importati dovrebbero comparire nell'interfaccia di Gitlab all'interno dei rispettivi gruppi.
-====== Riferimenti esterni ======
-[[http://git-scm.com/docs/gitcvs-migration | Guida base per git cvsimport]]
-[[https://git-scm.com/docs/git-cvsimport || man page di git cvsimport ]]
-[[http://stackoverflow.com/questions/7344941/converting-cvs-repositories-to-git#answer-7345524 || flag utili per git cvsimport]]
-[[http://gittest.bo.priv/ || Accesso HTTP all'attuale repository git su vegezio (/opt/git)]]
-[[http://doc.gitlab.com/ce/raketasks/import.html | Importazione di repository "bare" in Gitlab ]]