BlankOnDev

 view release on metacpan or  search on metacpan

lib/BlankOnDev/Tutorial/id.pod  view on Meta::CPAN

=item 5.
Perintah C<B<boidev gpg-genkey>> - Perintah ini digunakan untuk melakukan C<Generate key GnuPG>

=item 6.
Perintah C<B<boidev list-cfg>> - Perintah ini digunakan untuk melihat daftar konfigurasi program B<BlankOnDev> yang telah dilakukan.

=item 7.
Perintah C<B<boidev list-file>> - Perintah ini digunakan untuk melihat daftar file konfigurasi yang tersimpan pada sistem program B<BlankOnDev>.

=item 8.
Perintah C<B<boidev rilis>> - Perintah Ini digunakan untuk mengubah rilis B<BlankOn> yang digunakan pada program B<BlankOnDev>

=item 9.
Perintah C<B<boidev -v>> atau C<B<boidev --version>> - Perintah ini digunakan untuk melihat versi tools C<BlankOnDev>

=back

=head3 Perintah Migrasi Paket

Bagian ini terdiri dari 17 Perintah yaitu :

=over

=item 1.
Perintah C<B<boidev bzr2git>> - Perintah ini merupakan perintah yang digunakan untuk melakukan Migrasi paket dari repositori B<Bazaar> ke repositori B<Github>

=item 2.
Perintah C<B<boidev bzr2git addpkg-group>> - Perintah ini merupakan perintah yang digunakan untuk menambahkan group paket yang akan dimigrasi.

=item 3.
Perintah C<B<boidev bzr2git addpkg>> - Perintah ini merupakan perintah yang digunakan untuk menambahkan nama paket yang akan di migrasi

=item 4.
Perintah C<B<boidev bzr2git addpkg-file>> - Perintah ini merupakan perintah yang digunakan untuk menambahkan nama paket yang akan dimigrasi melalui file list paket yang berekstensi B<.boikg>

=item 5.
Perintah C<B<boidev bzr2git remove-pkg-group>> - Perintah ini merupakan perintah yang digunakan untuk menghapus nama group paket migrasi. Perintah ini akan menghapus semau daftar paket yang terkait dengan B<Group>.

=item 6.
Perintah C<B<boidev bzr2git rename-pkg-group>> - Perintah ini merupakan perintah yang digunakan untuk mengubah nama group paket migrasi.

=item 7.
Perintah C<B<boidev bzr2git remove-pkg>> - Perintah ini merupakan perintah yang digunakan untuk menghapus nama paket yang terdaftar pada system program B<BlankOnDev>

=item 8.
Perintah C<B<boidev bzr2git list-pkg>> - Perintah ini merupakan perintah yang digunakan untuk melihat daftar paket yang terdaftar pada system program B<BlankOnDev>.

=item 9.
Perintah C<B<boidev bzr2git list-pkg-group>> - Perintah ini merupakan perintah yang digunakan untuk melihat daftar group paket.

=item 10.
Perintah C<B<boidev bzr2git search-pkg>> - Perintah ini merupakan perintah yang digunakan utnuk mencari nama paket yang terdaftar pada system program B<BlankOnDev>.

=item 11.
Perintah C<B<boidev bzr2git branch>> - Perintah ini merupakan perintah yang digunakan untuk mengambil/download paket dari repositori bazaar berdasarkan nama paket yang sudah terdaftar pada system program B<BlankOnDev>.

=item 12.
Perintah C<B<boidev bzr2git bzr-cgit>> - Perintah ini merupakan perintah yang digunakan untuk mengkonversi format repositori bazaar ke format repositori github, berdasarkan nama paket yang sudah terdaftar pada system program B<BlankOnDev>

=item 13.
Perintah C<B<boidev bzr2git git-push>> - Perintah ini merupakan perintah yang digunakan untuk mendorong/upload yang sudah didownload, berdasarkan nama paket yang sudah terdaftar pada system program B<BlankOnDev>

=item 14.
Perintah C<B<boidev bzr2git git-push-new>> - Perintah ini merupakan perintah yang digunakan untuk mendorong/upload yang sudah didownload namum belum dikonversi ke format repositori github, berdasarkan nama paket yang sudah terdaftar pada system progr...

=item 15.
Perintah C<B<boidev bzr2git git-check>> - Perintah ini merupakan perintah yang digunakan untuk validasi repositori yang sudah diupload ke github.

=item 16.
Perintah C<B<boidev bzr2git re-branch>> - Perintah ini merupakan perintah untuk download ulang paket dari bazaar repositori.

=item 17.
Perintah C<B<boidev bzr2git re-gitpush>> - Perintah ini digunakan untuk memperbaiki kesalahan upload paket ke github yang dimana paket belum dilakukan convert format sebelumnya.

=back

=head3 Perintah help

Bagian ini terdiri dari 17 Perintah yaitu :

=over

=item 1.
Perintah C<B<boidev help>> - Untuk melihat seluruh help perintah C<boidev>

=item 2.
Perintah C<B<boidev bzr2git help>> - Untuk melihat seluruh perintah C<boidev bzr2git>
Adapun perintah help untuk perintah yang diawali dengan perintah C<boidev bzr2git> yaitu :

=over

=item * perintah C<B<boidev bzr2git addpkg-group help>>

=item * perintah C<B<bzr2git addpkg help>>

=item * perintah C<B<bzr2git addpkg-file help>>

=item * perintah C<B<bzr2git list-pkg help>>

=item * perintah C<B<bzr2git rename-pkg-group help>>

=item * perintah C<B<bzr2git remove-pkg-group help>>

=item * perintah C<B<bzr2git remove-pkg help>>

=item * perintah C<B<bzr2git search-pkg help>>

=item * perintah C<B<bzr2git branch help>>

=item * perintah C<B<bzr2git bzr-cgit help>>

=item * perintah C<B<bzr2git git-push help>>

=item * perintah C<B<bzr2git git-push-new help>>

=item * perintah C<B<bzr2git git-check help>>

=item * perintah C<B<bzr2git re-branch help>>

=item * perintah C<B<bzr2git re-gitpush help>>

=back

=back

=head1 2. Persiapan dan Implementasi

=head2 2.1. Persiapan

Pada bagian ini akan dijelaskan hal-hal yang perlu dipersipakan sebelum menggunakan program B<BlankOnDev> yaitu "B<rng-tools>".

=head3 2.1.1. Install dan Konfigurasi I<rng-tools>

lib/BlankOnDev/Tutorial/id.pod  view on Meta::CPAN

    [success] Action "bzr convert git -> gnome-screenshot" 1
    [success] Action "git push -> gnome-screenshot" 1
    [success] Action "git check -> gnome-screenshot" repo_github = master, tambora
    ------------------------------------------------------------------------
    Branch : "gnome-photos"
    [success] Action "bzr branch -> gnome-photos" : 1
    [success] Action "bzr convert git -> gnome-photos" 1
    [success] Action "git push -> gnome-photos" 1
    [success] Action "git check -> gnome-photos" repo_github = master, tambora
    ------------------------------------------------------------------------
    Action re-branch for packages "gnome-software"
    [success] Action "bzr branch -> gnome-software" : 1
    [success] Action "bzr convert git -> gnome-software" 1
    [success] Action "git push -> gnome-software" 1
    [success] Action "git check -> gnome-software" repo_github = master, tambora
    ------------------------------------------------------------------------
    Branch : "gnome-packagekit"
    [success] Action "bzr branch -> gnome-packagekit" : 1
    [success] Action "bzr convert git -> gnome-packagekit" 1
    [success] Action "git push -> gnome-packagekit" 1
    [success] Action "git check -> gnome-packagekit" repo_github = master, tambora
    ------------------------------------------------------------------------
    Branch : "gnome-icon-theme"
    [success] Action "bzr branch -> gnome-icon-theme" : 1
    [success] Action "bzr convert git -> gnome-icon-theme" 1
    [success] Action "git push -> gnome-icon-theme" 1
    [success] Action "git check -> gnome-icon-theme" repo_github = master, tambora
    ------------------------------------------------------------------------
    Branch : "gnome-settings-daemon"
    [success] Action "bzr branch -> gnome-settings-daemon" : 1
    [success] Action "bzr convert git -> gnome-settings-daemon" 1
    [success] Action "git push -> gnome-settings-daemon" 1
    [success] Action "git check -> gnome-settings-daemon" repo_github = master, tambora
    ------------------------------------------------------------------------
    Branch : "gnome-pkg-tools"
    [success] Action "bzr branch -> gnome-pkg-tools" : 1
    [success] Action "bzr convert git -> gnome-pkg-tools" 1
    [success] Action "git push -> gnome-pkg-tools" 1
    [success] Action "git check -> gnome-pkg-tools" repo_github = master, tambora
    ------------------------------------------------------------------------

    You want to migration all packages in group "github-end-3 [5]" ? [y or n] n

    [no-migration] All packages in group "github-end-3"

    ==================== Migration packages has been finished ====================

=head1 3. Troubleshooting Migrasi Paket

Pada bagian ini akan dijelaskan 2 permasalah terkait dengan aktifitas Migrasi paket dari Repositori Bazaar ke Repositori Github.
Beberapa permasalahan yang akan dijelaskan pada upabab ini, akan diselesaikan dengan perintah C<boidev bzr2git> dan C<boidev bzr2git [cmd2]>.

=head2 3.1. Paket github belum dikonverersi

Berikut contoh paket yang didorong ke github, tanpa dilakukan Konversi format :

=begin html

<p><center>
<figure>
<img src="https://yusrideb.github.io/BlankOnDev/docs/source/img/pkg-github-no-convert.png" alt="Contoh paket yang diupload tanpa konversi format ke github" />
<figcaption>Gambar 3.1. <b>Contoh paket yang diupload tanpa konversi format ke github</b></figcaption>
</figure>
</center></p>

=end html

Untuk memperbaiki repositori ini, sebenarnya bisa langsung menghapus repositori di akun github, kemudian mengupload ulang paket yang sudah dikonversi ke format git.
Jika hanya 1 paket mungkin tidak masalah, namun jika sudah terdapat repositori yang harus dihapus kemudian diupload ulang ke Github, maka beresiko salah hapus repositori.

Untuk melesaikan permasalahan seperti ini I<BlankOnDev Tools> menyediakan fitur untuk perbaikan repositori github yaitu
dengan cara seperti yang ditunjukkan pada upabab I<L<2.4. Proses Migrasi Paket|https://metacpan.org/pod/distribution/BlankOnDev/lib/BlankOnDev/Tutorial/id.pod#Proses-Migrasi-Paket1>,
bagian L<2.4.1|https://metacpan.org/pod/distribution/BlankOnDev/lib/BlankOnDev/Tutorial/id.pod#Migrasi-Paket-dengan-Metode-Split>
dan bagian L<2.4.2|https://metacpan.org/pod/distribution/BlankOnDev/lib/BlankOnDev/Tutorial/id.pod#Migrasi-Paket-dengan-Skema-One-time>>. berikut Ilustrasi penyelesaian masalah :

=head3 3.1.1. Problem Solved dengan perintah C<boidev bzr2git [cmd]>

Pada contoh ini nama paket yang bermasalah yaitu B<notify-osd>, berikut daftar perintah yang digunakan untuk menyelesaikan masalah :

=over

=item * Perintah C<boidev bzr2git branch B<notify-osd>>

=item * Perintah C<boidev bzr2git bzr-cgit B<notify-osd>>

=item * Perintah C<boidev bzr2git re-gitpush B<notify-osd>>

=item * Perintah C<boidev bzr2git git-check B<notify-osd>>

=back

Rangkaian proses penggunaan perintah :

    $ boidev bzr2git branch notify-osd

    Rilis Active : tambora

    You want to Re-branch [y/n] : y

    Bazaar re-branch for packages : "notify-osd"
    Action re-branch for packages "notify-osd"

    ======== Packages notify-osd has been finished to bzr branch ========

-

    $ boidev bzr2git bzr-cgit notify-osd

    Rilis Active : tambora

    Converting ....

    ======== Packages notify-osd has been finished to convert ========

-

    $ boidev bzr2git re-gitpush notify-osd

    Rilis Active : tambora

    Re-push to GitHub ....
    ----------------------------------------


    Username for 'https://github.com': yusrideb
    Password for 'https://yusrideb@github.com':

    re-push to git for packages "notify-osd" has success.

lib/BlankOnDev/Tutorial/id.pod  view on Meta::CPAN


=begin html

<p><center>
<figure>
<img src="https://yusrideb.github.io/BlankOnDev/docs/source/img/solved-github-no-convert.png" alt="Penyelesaian masalah : Format paket belum dikonversi ke format gitb" />
<figcaption>Gambar 3.2. <b>Penyelesaian masalah : Format paket belum dikonversi ke format git</b></figcaption>
</figure>
</center></p>

=end html

=head3 3.1.2. Problem Solved dengan perintah C<boidev bzr2git>

Pada bagian ini akan diilustrasi penyelesaian masalah mengunakan perintah C<boidev bzr2git>. Berikut Ilustrasinya :

    yusrideb@pemaket:~$ boidev bzr2git

    Rilis Active : tambora

    ---------------------------------------------------------------------------
    Choose Action :
    ---------------------------------------------------------------------------
    1. All Packages
    2. Specific Group Packages
    3. Single Packages
    Answer: 3

    Enter packages name : notify-osd

    Action re-branch for packages "notify-osd"
    [success] Action "bzr branch -> notify-osd" : 1
    [success] Action "bzr convert git -> notify-osd" 1
    [success] re-Action "bzr convert git -> notify-osd" 1
    [success] Action "re-git push -> notify-osd"
    [success] Action "git check -> notify-osd" repo_github = master, tambora

    ========= Migration packages "notify-osd" has been finished =========

Output Perintah :

=begin html

<p><center>
<figure>
<img src="https://yusrideb.github.io/BlankOnDev/docs/source/img/solved-github-no-convert.png" alt="Penyelesaian masalah : Format paket belum dikonversi ke format git" />
<figcaption>Gambar 3.3. <b>Penyelesaian masalah : Format paket belum dikonversi ke format git</b></figcaption>
</figure>
</center></p>

=end html

=head2 3.2. Paket github hanya memiliki 1 jenis I<Branch>

Berikut contoh paket yang di dorong ke github, namun tidak dibuatkan branch ke rilis B<tambora>, hanya branch B<master> saja.

=begin html

<p><center>
<figure>
<img src="https://yusrideb.github.io/BlankOnDev/docs/source/img/pkg-github-1-branch.png" alt="Contoh paket yang diupload ke github, namun hanya memilik branch I<master>" />
<figcaption>Gambar 3.4. <b>Contoh paket yang diupload ke github, namun hanya memilik branch I<master></b></figcaption>
</figure>
</center></p>

=end html

Untuk memperbaiki repositori github seperti permasalah ini, dapat diselesaikan dengan metode yang digunakan yaitu B<Metode Split> atau B<Metode One-time>.
Pada bagian ini menggunakan B<Metode One-time>. Berikut ilustrasinya :

    $ boidev bzr2git

    Rilis Active : tambora

    ---------------------------------------------------------------------------
    Choose Action :
    ---------------------------------------------------------------------------
    1. All Packages
    2. Specific Group Packages
    3. Single Packages
    Answer: 3

    Enter packages name : nvidia-firmware

    Action re-branch for packages "nvidia-firmware"
    [success] Action "bzr branch -> nvidia-firmware" : 1
    [success] Action "bzr convert git -> nvidia-firmware" 1
    Username for 'https://github.com': yusrideb
    Password for 'https://yusrideb@github.com':
    [success] Action "git push -> nvidia-firmware" 1
    [success] Action "git check -> nvidia-firmware" repo_github = master, tambora

    =========== Migration packages "nvidia-firmware" has been finished ===========

Hasil dari ilustrasi diatas :

=begin html

<p><center>
<figure>
<img src="https://yusrideb.github.io/BlankOnDev/docs/source/img/solved-github-1-branch.png" alt="Penyelesaian Masalah : Repositori Github hanya memiliki type branch I<master>" />
<figcaption>Gambar 3.5. <b>Penyelesaian Masalah : Repositori Github hanya memiliki type branch I<master></b></figcaption>
</figure>
</center></p>

=end html

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2017 by Achmad Yusri Afandi and BlankOn Developer Team.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

=head1 AUTHORS

=over

=item * Achmad Yusri Afandi, E<lt>yusrideb@cpan.orgE<gt>

=item * BlankOn Developer Team.



( run in 0.831 second using v1.01-cache-2.11-cpan-b16cb0d3907 )