Penggunaan Gitlab
Gitlab Corpu merupakan Versioning system dimana sistem tersebut berfungsi untuk menyimpan dan mengelola source code semua pengembangan inovasi atau produk di lingkungan Telkom Corpu.
Setiap pengembangan inovasi atau produk tersebut, wajib menggunakan Gitlab yang di host di server internal Program Digital Amoeba, yang atuan mainnya, akan dibahas lebih detail pada dokumen ini. Alasan utama mengapa diwajibkan menggunakan Gitlab internal, untuk menyimpan dan mengelola source code, yaitu sebagai bentuk pertanggungjawaban bersama kepada Telkom, sebagai pemilik inovasi dan produk yang sedang dikembangkan tersebut.
Dasar hukum: NDE SGM CORPU Nomor: C.Tel.311/UM 000/TCU-00000000/2021 tanggal 24 Agustus 2021
Ruang Lingkup
Ruang lingkup dari Tatakelola Git ini diantara lain adalah :
- The Rule of Game (RoG)
- How to access / join Git
- How to create / import Group & Invite Member
- How to create & import Projects
- How to Add Readme.
1. The Rule of Game (ROG)
Untuk memudahkan penggunaan Git Corpu, maka berikut beberapa RoG yang bisa diperhatikan :
- PO, SM, Lead DEV, Maintainer, dan Developer membuat akun pada https://git.digitalamoeba.id (menggunakan akun email Telkom diutamakan)
- Lead DEV / Maintainer membuat group repository, kemudian membuat repository baru atau memindahkan repository yang sudah ada ke dalam group tersebut. Group ini diperuntukan untuk meletakkan semua repository yang berkaitan dengan project yang akan dibuat.
- Invite developer atau member yang bersangkutan ke dalam group repository yang telah dibuat.
- Lakukan Merge / Push commit ke branch sesuai dengan kebutuhan.
- Wajib memberikan dokumentasi berupa README.md pada setiap repository, sesuai template berikut ini: https://github.com/dwisetiyadi/readme-template/blob/main/README.md.
- Menggunakan CI/CD
- Tambahkan user digitalamoeba ke dalam member group repository sebagai “reporter” (user ini digunakan oleh sistem otomasi untuk mengambil repository).
- Membuat 2 branch (wajib), hanya branch tersebut yang akan dimasukkan kedalam CI/CD pipeline:
- master : Digunakan untuk kebutuhan production
- dev : Digunakan untuk kebutuhan UAT & Development
2. How to access / join Git
- Akses ke URL Git Corpu dengan pembagian sebagai berikut :
- Pengembangan Inovasi/aplikasi sebagai akselerasi Telkom Corpu dapat menggunakan git.itdri.id
- Pengembangan Inovasi/aplikasi melalui Program Digital Amoeba dapat menggunakan git.digitalamoeba.id
- Melakukan registrasi pada akun git.digitalamoeba.id.
- Setelah berhasil melakukan Register, akun anda akan diverifikasi terlebih dahulu oleh admin selama maks. 1×24 jam.
- Setelah sudah di-approve, login menggunakan akun yang telah didaftarkan sebelumnya.
3. How to Create / Import Group & Invite team members
- Akses fitur “Menu” kemudian klik “Create Group”
- Pilih sesuai dengan kebutuhan. Create group untuk bikin group baru, dan Import Group untuk memindahkan group yang pernah dibuat sebelumnya.
- Mengisi form detail sesuai dengan kebutuhan. Untuk Visibility Level harap dipilih yang “Private”.
- Invite team members ke dalam Group yang telah dibuat.
4. How to create / import Projects.
- Create Project / Repository pada group dengan klik tombol New Project
- Pilih Create Blank Project, jika Ingin memulai dari 0 Atau Import Project jika ingin meng-copy source code and yang berada pada source lain (ex.github,gitlab,bitbucket,dsb)
- Create Blank Project
Lengkapi data sesuai dengan Project anda.
Untuk bagian README harap di-uncheck karena akan menggunakan template yang telah disediakan.
- Import Project
Pilih resource yang mau di-copy atau di-clone. Direkomendasikan pilih yang “Repo by URL”
Akses ke Repository sebelumnya yang kamu gunakan
Pilih dan masuk ke Project yang mau di-copy/clone.
Klik Clone dan copy url yang “Clone with HTTP”
Kembali ke Form Import Project yang ada pada git.digitalamoeba.id dan Paste URL tadi ke Git repository URL
Project berhasil ter-copy
5. How to Add README
Tambahkan dokumentasi berupa README.md pada setiap repository,sesuai template berikut ini: https://github.com/dwisetiyadi/readme-template/blob/main/README.md
Copy script yang ada pada template
Klik “Raw”
Block semua script dan Copy
Pilih Project yang mau ditambahkan README, kemudian klik ADD README
Paste script yang telah di-copy sebelumnya
Update sesuai dengan Project-mu kemudian klik “COMMIT” agar datanya tersimpan
Readme telah terupdate
Notes:
Jika ada pertanyaan lebih lanjut dapat disampaikan ke Group Telegram.
Atau PC ke PIC AMA:
Priscilia Indah
E: priscilia@digitalamoeba.id
P: 081382412762