Skip to content

Repository

Standar dalam penggunaan repository pada lingkungan PELNI
05 January 2021Dimas Wicaksono
Riwayat Dokumentasi
VersiTanggalAktorKeterangan
v1.007/Des/2020Dimas WicaksonoPenulisan dokumentasi
v1.105/Jan/2021Dimas WicaksonoPerbaikan gambar asset pada dokumen

Pastikan Git telah terinstall pada perangkat development Untuk melakukan pengelolaan dan pemeliharaan kode aplikasi, tim IT menggunakan Source Versioning (Gitlab) yang dapat diakses pada bagian navbar di atas.

Login Melalui Web UI

Masukkan username (email PELNI tanpa domain @pelni.co.id) dan password yang digunakan.

alt text

Daftar Project

Setelah login, daftar project akan ditampilkan pada halaman utama, apabila tidak ada project yang tersedia, berarti akun belum ditambahkan pada project apapun. Silakan request akses ke project pada project owner.

alt text

Autentikasi Repo

Untuk autentikasi pada saat melakukan pengelolaan repository dapat menggunakan salah satu metode di bawah ini.

Menggunakan Username & Password

Bila pilihan autentikasi yang digunakan adalah username dan password, maka git akan meminta memasukkan username dan password pada saat awal penggunaan yang nantinya akan disimpan pada Global Config Git.

Referensi: Stackoverflow: Store Credential Git

Menggunakan SSH Key

Metode ini memungkinkan pengaksesan project pada repo tanpa perlu memasukkan username dan password pada saat penggunaannya, serta apabila terdapat perubahan password akun tidak akan mempengaruhi akses ke repo. Untuk menggunakan metode ini dapat menggunakan langkah-langkah berikut:

1. Generate SSH Key pada perangkat development. Referensi

Akan digenerate 2 file (private (id_rsa) & public file (id_rsa.pub)) baru pada folder ~/.ssh. File ini akan digunakan pada tahap berikutnya.

2. Daftarkan SSH Key pada profil GitLab

Untuk mendaftarkan, klik profil pada kanan atas navbar Gitlab. Kemudian pilih Settings.

alt text

Pada Sidebar di sebelah kiri, pilih menu SSH Keys.

alt text

Paste isi dari id_rsa.pub (public key) ke textbox Key pada Gitlab dan klik tombol Add key.

alt text

Format dari public key ini: ssh-rsa AAAAB3… text sengaja dipotong

Apabila berhasil, maka key yang baru ditambahkan akan ditampilkan pada daftar Your SSH Keys

alt text

3. Test Akses SSH

Lakukan testing akses ke server gitlab dengan menggunakan command

ssh git@gitlab.pelni.co.id

Apabila berhasil, maka pesan Welcome akan ditampilkan.

Selamat Datang di Repo Server Gitlab!
PTY allocation request failed on channel 0
Welcome to GitLab, @YOUR.USERNAME!
Connection to gitlab.pelni.co.id closed.

Clone Project

Sebelum memulai pengembangan, lakukan clone project/repository ke perangkat development lokal. Apabila metode autentikasi yang digunakan adalah username & password maka gunakan link HTTPS (Clone with HTTPS), sedangan apabila menggunakan SSH maka gunakan link SSH (Clone with SSH)

alt text

Gunakan command berikut untuk clone

git clone LINK_REPOSITORY_GITLAB

Apabila menggunakan username dan password untuk pertama kali, Git akan meminta credential username dan password yang akan digunakan.