9.2 Git və Digər Sistemlər - Git’ə Miqrasiya

git svn istifadəsi ilə bağlı əvvəlki bölümü oxumusunuzsa, bu təlimatları asanlıqla git svn clone deposuna getmək üçün istifadə edə bilərsiniz; sonra, Subversion serverindən istifadəni dayandırın, yeni bir Git serverinə keçin və istifadə etməyə başlayın. Tarixçəni istəsəniz, məlumatı Subversion serverindən çıxara bildiyiniz müddətdə (bir müddət ala bilər) bacara bilərsiniz.

Bununla birlikdə, idxal mükəmməl deyil; və çox uzun çəkəcəyi üçün bunu da edə bilərsiz. İlk problem müəllif məlumatlarıdır. Subversion-da, hər bir iş görən şəxsin sistemdə commit məlumatında qeyd olunan bir istifadəçisi var. Əvvəlki hissədəki nümunələr, blame çıxışı və git svn log kimi bəzi yerlərdə schacon göstərir. Bunu daha yaxşı Git müəllif məlumatlarına uyğunlaşdırmaq istəyirsinizsə, Subversion istifadəçilərindən Git müəlliflərinə qədər bir xəritəyə ehtiyacınız var. Bu istifadəçi şəklində belə bir formatda olan users.txt adlı bir fayl yaradın:

SVN-nin istifadə etdiyi müəllif adlarının siyahısını əldə etmək üçün bunu edə bilərsiniz:

Gündəlik çıxışı XML formatında yaradır, sonra yalnız müəllif məlumatları olan sətirləri saxlayır, dublikatları atır, XML etiketlərini silir. Aydındır ki, bu yalnız grep, sort və perl quraşdırılmış bir maşın üzərində işləyir. Sonra, hər bir girişin yanına ekvivalent Git istifadəçi məlumatlarını əlavə edə bilmək üçün bu çıxışı users.txt faylınıza yönləndirin.

Müəllif məlumatlarını daha dəqiq bir şəkildə göstərməsinə kömək etmək üçün bu faylı git svn-ə təqdim edə bilərsiniz. Ayrıca,git svn-ə Subversion-un normal olaraq idxal etdiyi meta məlumatları daxil etməməsini, --no-metadata-nı clone ya da init əmrinə keçirməklə də deyə bilərsiniz. Metadata, Gitin idxal zamanı meydana gətirəcəyi hər bir mesajın içərisində bir git-svn-id var. Bu, Git log-unuzu şişirə bilər və bir az anlaşılmaz edə bilər.

Bu, import əmrinizi belə göstərir:

İndi my_project qovluğunuzda daha yaxşı bir Subversion idxal etməlisiniz. Buna bənzər commit-lər yerinə:

they look like this:

Müəllif sahəsi həm daha yaxşı görünür, həm də git-svn-id artıq yoxdur. Ayrıca bir az post-import sonrası təmizləmə etməlisiniz. Birincisi, git svn qurduğu qəribə referansları təmizləməlisiniz. Əvvəlcə yazıları qəribə uzaq branch-lardan daha çox həqiqi etiket olduqları üçün daşıyacaqsınız, sonra qalan branch-ları local olduqları üçün köçürəcəksiniz.

Etiketləri uyğun Git etiketi olmaq üçün hərəkət etdirin:

Bu, refs/remotes/tags/ ilə başlayan uzaq branch-lar olan referansları alır və onları həqiqi (yüngül) etiketlər edir. Ardından, referansların qalan hissəsini local branch-lar halına gətirmək üçün refs/remotes altına köçürün:

Elə ola bilər ki, @xxx (harada ki xxx ədəddir) şəkilçisi olan bəzi əlavə branch-lar görərsiniz, Subversionda isə yalnız bir branch görürsünüz. Bu, əslində Git üçün heç bir sintaktik həmkarı olmayan bir şey olan “peg-revisions” adlı Subversion xüsusiyyətidir. Beləliklə, git svn branch-ın düzəldilməsini həll etmək üçün svn-də yazdığınız şəkildə svn versiya nömrəsini branch-ın adına əlavə edir. Artıq peg-revisions düzəlişləri ilə maraqlanmırsınızsa, sadəcə onları silin:

İndi bütün köhnə branch-lar əsl Git branch-larıdır və bütün köhnə etiketlər əsl Git etiketləridir. Təmizləmək üçün son bir şey var. Təəssüf ki, git svn, Subversionun standart branch-ına uyğunlaşan trunk adlı əlavə bir branch yaradır, lakin trunk master ilə eyni yerə işarə edir. master daha idiomatik olaraq Git olduğundan əlavə branch-ı necə silmək olar:

Ediləcək son şey yeni Git serverinizi bir remote olaraq əlavə edib ona push etməkdir. Serverinizi məsafədən əlavə etmək üçün bir nümunə:

Bütün branch-larınızın və etiketlərinizin yuxarı qalxmasını istədiyiniz üçün indi bunu edə bilərsiniz:

Bütün branch-larınız və etiketləriniz təmiz bir idxalda yeni Git serverinizdə olmalıdır.

Mercurial və Git versiyalarını təmsil etmək üçün kifayət qədər oxşar modellərə sahib olduğundan və Git bir az daha çevik olduğundan, bir deponu Mercurial-dan Git-ə çevirmək kifayət qədər sadədir, bunun üçün "hg-fast-export" adlı bir vasitə istifadə etmək lazımdır:

Dönüşümün ilk addımı çevirmək istədiyiniz Mercurial deposunun tam bir klonunu əldə etməkdir:

Növbəti addım bir müəllif mapping faylı yaratmaqdır. Mercurial, dəyişikliklər üçün müəllif sahəsinə qoyacaqlarına görə Gitdən biraz daha bağışlayır, buna görə də ev təmizləmək üçün yaxşı vaxtdır. Bunu yaratmaq, bash shell-ində bir sətir əmridir:

Bu, layihənizin tarixinin nə qədər olacağına görə bir neçə saniyə çəkəcək və bundan sonra /tmp/authors faylı belə görünəcək:

Bu nümunədə, eyni şəxs (Bob) biri fərqli görünən və biri Git commiti üçün tamamilə etibarsız olan dörd fərqli ad altında dəyişikliklər yaratdı. Hg-fast-export hər sətri bir qaydaya çevirərək bunu düzəltməyimizə imkan verir: "<input>"="<output>", <input> ilə <output> arasında mapping. <input> və <output> string-lərinin içərisində, python string_escape kodlaması ilə başa düşülən bütün qaçış ardıcıllığı dəstəklənir. Müəllif mapping faylında uyğun bir <input> yoxdursa, o müəllif dəyişdirilmədən Git-ə göndəriləcək. Bütün istifadəçi adları yaxşı görünürsə, bu fayla heç ehtiyacımız olmayacaq. Bu nümunədə faylımızın belə görünməsini istəyirik:

Eyni növ mapping faylı, Mercurial adının Git tərəfindən icazə verilmədiyi zaman branch və etiketlərin adını dəyişdirmək üçün istifadə edilə bilər.

Növbəti addım yeni Git depomuzu yaratmaq və ixrac skriptini çalışdırmaqdır:

-r flag-ı hg-fast-export-ə çevirmək istədiyimiz Mercurial deposunu harada tapacağımızı və -A flag-ı isə author-mapping faylını harada tapacağımızı bildirir (branch və etiket mapping faylları müvafiq olaraq -B və -T flag-ları ilə təyin olunur). Skript Mercurial dəyişikliklərini təhlil edir və Git’in "fast-import" xüsusiyyəti üçün bir skriptə çevirir (bir az sonra ətraflı şəkildə müzakirə edəcəyik).

Bu bir az çəkir (baxmayaraq ki, şəbəkə üzərində olandan daha çox sürətli olur) və nəticə olduqca açıqdır:

Bunun üçün demək olar ki, hamısı var. Mercurial etiketlərin hamısı Git etiketlərinə, Mercurial branch-ları və bookmark-ları Git branch-larına çevrilmişdir. İndi deponu yeni server tərəfindəki evinə aparmağa hazırsınız:

Bazaar, Git kimi bir DVCS vasitədir və nəticədə bir Bazaar deposunu Git-ə çevirmək olduqca sadədir. Bunu həyata keçirmək üçün bzr-fastimport pluginini idxal etməlisiniz.

İdxal etməyə baxacağınız növbəti sistem Perforce’dir. Yuxarıda müzakirə etdiyimiz kimi, Git və Perforce-un bir-birlərinə danışmalarına icazə verməyin iki yolu var: git-p4 və Perforce Git Fusion.

Komandanız mənbə nəzarətini TFVC-dən Git-ə çevirirsə, əldə edə biləcəyiniz ən yüksək əslinə uyğun dönüşümünü istəyərsiniz. Bu o deməkdir ki, interop bölməsi üçün həm git-tfs, həm də git-tf-ni əhatə etdiyimiz halda, yalnız bu hissə üçün git-tfs-i əhatə edəcəyik, çünki git-tfs branch-ları dəstəkləyir və bu git-tf istifadə etmək olduqca çətindir.

Ediləcək ilk şey istifadəçi adlarının xəritəsidir. TFVC, dəyişikliklər üçün müəllif sahəsinə daxil olanlarla kifayət qədər sərbəstdir, lakin Git insan tərəfindən oxunaqlı bir ad və e-poçt ünvanı istəyir. Bu məlumatı tf əmr sətrini müştərisindən ala bilərsiniz:

Bu, layihənin tarixindəki bütün dəyişiklikləri tutur və İstifadəçi sütununun (ikincisi) məlumatlarını çıxarmaq üçün işləyəcəyimiz AUTHORS_TMP sənədinə qoyuruq. Faylı açın və sütunun hansı işarədə başlayıb bitdiyini və yerini dəyişdirin, aşağıdakı əmr sətrində cut əmrini 11-20 parametrlərini tapılanlarla əvəz edin:

cut əmri hər sətirdən yalnız 11 ilə 20 arasındakı simvolları saxlayır. tail əmri sahə başlıqları və ASCII-art vurğulayan ilk iki sətiri atlayır. Bütün bunların nəticəsi, təkrarlamaları aradan qaldırmaq üçün sort və uniq şəkillərinə göndərilir və AUTHORS adlı bir faylda saxlanılır. Növbəti addım manualdır; git-tfs-in bu fayldan səmərəli istifadə etməsi üçün hər sətir bu formatda olmalıdır:

Sol tərəfdəki hissə TFVC-dən “User” sahəsidir və bərabər işarəsinin sağ tərəfindəki hissə Git commit-ləri üçün istifadə ediləcək istifadəçi adıdır.

Bu faylı əldə etdikdən sonra bir sonrakı iş, maraqlandığınız TFVC layihəsinin tam bir klonunu yaratmaqdır:

Bundan sonra, commit mesajların altından git-tfs-id bölmələrini təmizləmək lazımdır. Aşağıdakı əmr bunu edəcəkdir:

Bu, “git-tfs-id:” ilə başlayan hər hansı bir sətri boşluqla əvəz etmək üçün Git-bash mühitindən sed əmrini istifadə edir və Git bundan sonra ignore qalacaq.

Hamısı bitdikdən sonra yeni bir remote əlavə etməyə, bütün branch-larınızı yuxarıya qaldırmağa və komandanızın Git-dən işə başlamasına hazırsınız.

Sisteminiz yuxarıda göstərilənlərdən biri deyilsə, onlayn bir idxalçı axtarmalısınız - keyfiyyətli idxalçılar CVS, Clear Case, Visual Source Safe hətta arxivlər siyahısı daxil olmaqla bir çox digər sistemlər üçün mövcuddur.

Bu vasitələrdən heç biri sizin üçün işləmirsə, daha qaranlıq bir alətiniz varsa və ya başqa bir xüsusi idxal prosesinə ehtiyacınız varsa, git fast-import istifadə etməlisiniz. Bu əmr, müəyyən Git məlumatlarını yazmaq üçün stdin-dən sadə təlimatları oxuyur. Git obyektlərini bu şəkildə yaratmaq, xam Git əmrlərini işə salmaqdan və ya xam obyektləri yazmağa çalışmaqdan daha asandır (daha çox məlumat üçün Git’in Daxili İşləri bax). Bu şəkildə, idxal etdiyiniz sistemdən lazımi məlumatları oxuyan və stdout üçün birbaşa təlimatları yazan bir idxal skriptini yaza bilərsiniz. Daha sonra bu proqramı işə sala və nəticəsini git fast-import vasitəsilə ötürə bilərsiniz.

Sürətlə nümayiş etdirmək üçün sadə bir idxalçı yazacaqsınız. Tutaq ki, current-də işləyirsiniz, zaman zaman qovluğu bir time-stamped back_YYYY_MM_DD ehtiyat qovluğuna kopyalayaraq proyektinizi backup edirsiniz və bunu Git-ə idxal etmək istəyirsiniz. Qovluq quruluşunuz belə görünür:

Bir Git qovluğunu idxal etmək üçün Gitin məlumatlarını necə saxladığını nəzərdən keçirməlisiniz. Xatırladığınız kimi, Git əsas etibarilə məzmunun bir snapshot-una işarə edən obyektlərin əlaqəli siyahısıdır. Etməli olduğunuz şey məzmunun snpshot-larının nə olduğunu, məlumatları onlara yönəldən şeyləri və daxil olma qaydalarını fast-import etməyinizdir. Strategiyanız snapshot-lardan bir-bir keçmək və hər bir qovluğu əvvəlki ilə əlaqələndirərək hər bir kataloqun məzmunu ilə commit-lər yaratmaq olacaq.

Git-Enforced Siyasət Nümunəsi-də etdiyimiz kimi, bunu Ruby-də yazacağıq, çünki ümumiyyətlə işləmək və oxunması asan olur. Bu nümunəni tanış olduğunuz hər hansı bir şeydə olduqca asanlıqla yaza bilərsiniz - yalnız müvafiq məlumatları stdout-a yazdırmaq lazımdır. Və Windows üzərində işləyirsinizsə, bu, sətirlərinizin sonunda vaqon qayıtmalarını daxil etməməyə xüsusi diqqət yetirməli olduğunuz mənasını verir - git fast-import yalnız Windows istifadə etdiyi daşıyıcı xətləri (CRLF) deyil, yalnız xətt lentləri (LF) istəməyə gəldikdə çox dəqiqdir.

Başlamaq üçün hədəf qovluğunu dəyişəcəksiniz və hər biri commit olaraq idxal etmək istədiyiniz bir snapshot-u olan hər subdirectory-ni müəyyənləşdirəcəksiniz. Hər subdirectory-ni keçib ixrac etmək üçün lazım olan əmrləri çap edəcəksiniz. Əsas dövrəniz belə görünür:

Hər bir qovluğun içərisində əvvəlki snapshot-un manifestini və işarəsini götürən və bunun manifestini və işarəsini qaytaran print_export işlədirsiniz; bu şəkildə onları düzgün bir şəkildə bağlaya bilərsiniz. “Mark” commit-ə verdiyiniz bir identifikator üçün fast-import terminidir; commit-lər yaradarkən, hər birinə digər commit-lərdən əlaqələndirmək üçün istifadə edə biləcəyiniz bir işarə verirsiniz. Beləliklə, print_export metodunda ediləcək ilk şey qovluq adından bir işarənin yaradılmasıdır:

Bunu bir dizin qovluğu yaratmaqla və indeks dəyərini işarə olaraq istifadə etməklə edəcəksiniz, çünki bir işarə tam olmalıdır. Metodunuz belə görünür:

Commit-inizin tam bir təmsilçiliyinə sahib olduğunuz üçün, commit meta məlumatları üçün bir tarixə ehtiyacınız var. Tarix qovluq adına ifadə olunduğundan, onu təhlil edəcəksiniz. Print_export falınızdakı növbəti sətir:

where convert_dir_to_date is defined as:

Bu, hər bir qovluğun tarixi üçün bir tam dəyər qaytarır. Hər bir commit üçün lazım olan son meta məlumat parçası, qlobal dəyişəndə sabit kodladığınız ötürmə məlumatlarıdır:

İndi idxalçı üçün commit məlumatlarını çap etməyə başlamağa hazırsınız. İlkin məlumatda commit obyektini və hansı branch-da olduğunuzu, sonra yaratdığınız işarəni, məlumat verən məlumatı və commit mesajını, sonra varsa əvvəlki commit-i təyin etdiyiniz bildirilir. Kod belə görünür:

Saat dilimini (-0700) kodlaşdırın, çünki bunu etmək asandır. Başqa bir sistemdən idxal edirsinizsə, zaman zonasını ofset kimi göstərməlisiniz. Commit mesajı xüsusi bir formatda ifadə olunmalıdır:

Format məlumat sözündən, oxunacaq məlumatın ölçüsündən, yeni bir sətirdən və nəhayət məlumatdan ibarətdir. Faylın məzmununu daha sonra müəyyənləşdirmək üçün eyni formatı istifadə etməlisiniz, çünki köməkçi bir metod, export_data yaradırsınız:

Qalan yalnız hər bir snapshot üçün fayl məzmununun müəyyənləşdirilməsidir. Bu çox asandır, çünki hər biriniz bir kataloqdadır - qovluqdakı hər bir sənədin məzmunu və ardından deleteall əmrini çap edə bilərsiniz. Daha sonra Git hər bir snapshot-u uyğun şəkildə qeyd edəcək:

Qeyd: Bir çox sistem öz reviziyalarını bir commit-dən digərinə dəyişiklik kimi qəbul etdiyini düşündüyündən, sürətli idxal da hər bir faylda hansı faylların əlavə olunduğunu, silindiyini və ya dəyişdirildiyini və yeni məzmununun nə olduğunu müəyyənləşdirmək üçün əmrlər götürə bilər. Snapshot-lar arasındakı fərqləri hesablaya bilər və yalnız bu məlumatları verə bilərsiniz, ancaq bunu etmək daha mürəkkəbdir - Git-ə bütün məlumatları verə və onu başa düşməsinə icazə verə bilərsiniz. Bu, məlumatlarınıza daha uyğun gəlirsə, məlumatlarınızı bu şəkildə necə təqdim edəcəyiniz barədə ətraflı məlumat üçün fast-import man page-ini yoxlayın.

Yeni fayl məzmununun siyahısı və ya dəyişdirilmiş bir sənədin yeni məzmunu ilə göstərilməsi formatı belədir:

Budur, 644 rejimi (executable fyllarınız varsa, bunun əvəzinə 755-i aşkarlamalı və təyin etməlisiniz) və sətir içərisindəki məzmunu bu sətirdən dərhal sonra sadalayacağınızı söyləyir. inline_data metodunuz belə görünür:

Daha əvvəl müəyyənləşdirdiyiniz export_data metodundan təkrar istifadə edirsiniz, çünki bu, commit mesajı məlumatlarınızı təyin etməyinizlə eynidir.

Etməli olduğunuz son şey cari işarəni növbəti təkrarlamaya ötürmək üçün qaytarmaqdır:

Bu qədər. Budur skript bütövlükdə:

Bu skripti işlədirsinizsə, buna bənzər bir məzmun əldə edəcəksiniz:

İmporter-i çalıştırmak üçün bu çıxışı idxal etmək istədiyiniz Git qovluğunda olarkən git fast-import vasitəsilə ilə ötürün. Yeni bir qovluq yaradıb sonra bir başlanğıc nöqtəsi üçün içərisindəki git init -i işə sala və sonra skriptinizi işə sala bilərsiniz:

Gördüyünüz kimi uğurla başa çatdıqda, həyata keçirdikləri barədə bir çox statistika verir. Bu vəziyyətdə, 1 branch-a 4 commit üçün cəmi 13 obyekt idxal etdiniz. İndi yeni tarixçənizi görmək üçün git log-u işə sala bilərsiniz:

Budur - gözəl, təmiz bir Git deposu. Heç bir şeyin yoxlanılmadığını qeyd etmək vacibdir - əvvəlcə iş qovluğunda heç bir faylınız yoxdur. Bunları əldə etmək üçün branchnızı master-i n olduğu yerə sıfırlamalısınız:

fast-import aləti ilə daha çox şey edə bilərsiniz - fərqli rejimləri, ikili məlumatları, birdən çox branch-ı və birləşmə, etiketlər, irəliləyiş göstəriciləri və s. Daha mürəkkəb ssenarilərin bir sıra nümunələri Git qaynaq kodunun contrib/fast-import qovluğunda mövcuddur.