Menulis Kod Berkumpulan dengan GIT

Panduan Asas: Pengurusan Pembangunan Aplikasi Berkumpulan Menggunakan GitLab

Pernahkah kod aplikasi anda rosak selepas rakan sekerja membuat perubahan? Atau anda kehilangan kod lama yang berfungsi dengan baik? Jangan risau, Git dan GitLab adalah penyelamat anda.

Secara ringkas:

• Git ialah "mesin masa" untuk kod anda. Ia merekod setiap perubahan.

• GitLab ialah "pejabat maya" di mana anda dan pasukan menyimpan kod (Git) dan bekerjasama.

Dalam tutorial ini, kita akan membina sebuah aplikasi ringkas bernama "BlogKita" secara berkumpulan, bermula dari sifar sehingga kod kita diuji secara automatik (Continuous Integration).

Langkah 1: Cipta Projek Baru di GitLab

Langkah pertama adalah menyediakan "tapak rumah" untuk aplikasi kita di GitLab.

1. Log masuk ke akaun GitLab.

2. Klik butang biru "New Project" dan pilih "Create blank project".

3. Isi butiran projek:

   • Project name: blog-kita

   • Visibility Level: Pilih Private (hanya untuk pasukan) atau Public.

4. Klik "Create project".

(Bayangkan imej paparan borang Create Project GitLab di sini)

[Grafik: Tangkap layar butang 'Create Project' dan borang nama projek]

Langkah 2: Masukkan Kod Pertama Anda (Push Code)

Mari buat aplikasi blog kita. Buka terminal (atau Command Prompt) di komputer anda. Kita akan buat satu fail web ringkas dan hantarnya ke GitLab.

1. Sediakan fail projek:

Buat folder baru dan satu fail bernama index.html.

<!-- index.html -->
<html>
  <body>
    <h1>Selamat Datang ke BlogKita!</h1>
    <p>Ini adalah artikel pertama kami.</p>
  </body>
</html>

2. Hantar kod ke GitLab (Gunakan arahan ini di Terminal):

git init
git add index.html
git commit -m "Bina muka depan blog"
git remote add origin https://gitlab.com/NAMA_ANDA/blog-kita.git
git push -u origin main

Maksudnya: Kita arahkan Git untuk menjejak fail kita, simpan perubahannya, dan hantar (push) ke GitLab. Buka semula GitLab anda, fail index.html kini ada di sana!

Langkah 3: Bekerja Secara Berkumpulan (Branching)

Katakan rakan anda, Ali, mahu menambah halaman "Tentang Kami". Untuk mengelakkan kod utama (main) rosak, Ali mesti bekerja di "cawangan" (branch) yang berasingan.

1. Ali membuat 'branch' baru:

git checkout -b halaman-tentang-kami

(Arahan ini mencipta cawangan baru dan Ali terus masuk ke dalamnya).

2. Ali membina fail baru (tentang.html):

<!-- tentang.html -->
<html>
  <body>
    <h1>Tentang Kami</h1>
    <p>BlogKita diasaskan pada tahun 2026.</p>
  </body>
</html>

3. Ali menghantar cawangan ini ke GitLab:

git add tentang.html
git commit -m "Tambah halaman tentang kami"
git push origin halaman-tentang-kami

Langkah 4: Menggabungkan Kod (Merge Request)

Sekarang, fail Ali ada di GitLab tetapi di dalam branch yang berasingan. Ali perlu meminta izin untuk menggabungkan kodnya ke fail utama. Ini dipanggil Merge Request (MR).

1. Buka GitLab. Anda akan nampak butang hijau "Create merge request" muncul secara automatik. Klik butang itu.

2. Tulis tajuk: "Tambah Halaman Tentang Kami".

3. Anda atau ketua pasukan boleh menyemak kod Ali. Jika semuanya okey, klik butang "Merge".

Tahniah! Kod Ali kini digabungkan dengan selamat ke dalam aplikasi utama.

[Grafik: Tangkap layar butang hijau 'Merge' di GitLab yang menunjukkan kod berjaya digabungkan]

Langkah 5: Pengenalan Ringkas Continuous Integration (CI)

Bagaimana jika kita mahu pastikan tiada siapa yang menghantar kod yang rosak? Di sinilah Continuous Integration (CI) berfungsi. CI adalah "robot pekerja" GitLab yang akan menguji kod anda setiap kali anda membuat perubahan.

Mari cipta satu ujian ringkas.

Buat satu fail baru bernama .gitlab-ci.yml di dalam folder projek anda dan masukkan kod ini:

# .gitlab-ci.yml
uji_blog_kita:
  script:
    - echo "Memulakan ujian untuk BlogKita..."
    - echo "Semua fail HTML nampak berkeadaan baik!"
    - echo "Ujian Lulus!"

Hantar fail ini ke GitLab:

git add .gitlab-ci.yml
git commit -m "Tambah robot CI"
git push origin main

Apa yang berlaku?

Buka GitLab, dan pergi ke menu CI/CD > Pipelines. Anda akan nampak satu ikon hijau bertanda "Passed". Robot CI GitLab telah membaca fail .gitlab-ci.yml anda dan menjalankan arahan tersebut secara automatik!

(Untuk aplikasi sebenar, robot ini akan diprogramkan untuk menguji ralat dalam kod PHP/NodeJS/Python anda).

Kesimpulan

Anda baru sahaja mempelajari kitaran hayat sebenar seorang pembangun perisian moden!

1. Cipta Projek di GitLab.

2. Push kod untuk disimpan.

3. Buat Branch untuk menambah ciri baru tanpa merosakkan kod asal.

4. Guna Merge Request untuk semakan kumpulan.

5. Guna CI/CD supaya robot menguji kod anda secara automatik.

Dengan GitLab, kerja berkumpulan menjadi lebih tersusun, selamat, dan profesional. Selamat mencuba!