Langkau ke kandungan utama

Git dan Projek Aplikasi

Assalamualaikum

Mari kita terus fokus kepada pembangunan aplikasi. Senario ini biasanya berlaku dalam sesebuah jabatan yang bertanggungjawab membina aplikasi untuk organisasi atau pelanggan.


Pasukan JuruProgram


Beberapa juruprogram yang membina aplikasi yang sama akan berkongsi-kongsi kodprogram mereka samada secara online menggunakan cloud ataupun bertukar-tukar peranti storan mudah alih (ada yang buat gitu lagi ke?). Namun secara idealnya, setiap juruprogram akan menulis kod untuk modul yang berbeza bagi satu-satu aplikasi. 

Jika seorang juruprogram yang ditugaskan untuk membina fungsi tertentu, maka dia akan memeras otaknya untuk mengeluarkan idea. Biasanya dengan meminum kopi pekat sikit. Selepas itu maka diapun berjaya mengeluarkan 3 kaedah atau idea bernas untuk membina fungsi tersebut. Maka, dia akan membuat 3 salinan dan menamakan setiap salinan itu dengan nama yang berbeza-beza. Koding ditulis dan diuji satu persatu. Ketiga-tiga salinan tersebut berjaya dibina dan selepas dinilai oleh bos beliau, salah satu salinan tadi akan disalin kedalam salinan asal dan dimuatnaik semula ke server cloud.

Sangat-sangat praktikal kan? Namun, banyak masalah yang mungkin timbul dengan cara ini jika sekiranya sesuatu yang tidak diingini berlaku selepas salinan utama telah ditambah dengan kod baru. Mungkin terdapat bug yang tidak terlihat sebelum ini. Maka kita terpaksa menyelesaikan dengan seberapa segera masalah tersebut sekiranya sistem telah sedia digunakan. Ataupun, untuk setiap versi (penambahan kod) salinan utama tadi, setiapnya disimpan salinan secara berasingan dan diberikan nama yang unik dan tarikh kemaskini dan dilakukan oleh siapa. Banyangkan kita bekerja dengan 10 orang juruprogram yang sedang membangunkan aplikasi yang sama. Dalam sehari, mungkin setiap juruprogram akan meminta untuk kodprogram mereka dinilai dan dimasukkan kedalam salinan utama. 

Situasi itu sangat-sangat(SANGAT) seram untuk digambarkan.

Untuk menyelesaikan masalah ini (memudahkan) kaedah pembangunan aplikasi secara berkumpulan inilah timbulnya Git.

Dengan git, setiap juruprogram dapat membuat salinan daripada repositori utama dengan arahan:

git clone [alamat repositori]

git clone akan menyalin bukan sahaja semua fail daripada repo, bahkan juga setiap perubahan yang telah dilakukan, tarikh dan masa perubahan itu dilakukan, nama dan emel orang yang melakukan perubahan itu dan apa yang diubah. Selepas kita clone suatu repo daripada server (konsep cloud juga), juruprogram akan mendapat salinan yang 100% sama dengan apa yang ada dalam repositori utama.

contoh dibawah adalah cara untuk kita clone salah satu repo daripada github:

$\> git clone https://github.com/mischa78/boxroom.git
Cloning into 'boxroom'...
remote: Counting objects: 2995, done.
remote: Total 2995 (delta 0), reused 0 (delta 0), pack-reused 2995
Receiving objects: 100% (2995/2995), 719.42 KiB | 207.00 KiB/s, done.
Resolving deltas: 100% (1529/1529), done.
Checking connectivity... done.

Selepas arahan ini dilaksanakan, kesemua fail daripada github itu akan berada dalam komputer kita. 
(jangan risau, repo dalam github ini kesemuanya adalah opensource)

Dengan memiliki kesemua fail yang sama dengan apa yang ada dalam repositori utama, dan ianya disalin menggunakan Git, salinan dalam komputer kita itu juga merupakan satu repositori.


Repositori di Server dipanggil Remote.
Remote Server yang pertama sekali kita clone dinamakan Origin

Arahan untuk melihat Remote Server:


$\> git remote -v
origin https://github.com/mischa78/boxroom.git (fetch)

origin https://github.com/mischa78/boxroom.git (push)
Jadi, bagaimana untuk mula menulis kod? Kena buat salinan asing ke?

Git didatangkan dengan fungsi Branching. Sama seperti kita membuat salinan kogprogram, namun dengan lebih tersusun. Kita boleh membuat beberapa branch serentak sekiranya kita ada banyak idea untuk menyelesaikan satu-satu tugas.


Arahan untuk mencipta branch baru 

$\> git checkout -b add_staff_module_yusdirman
        Switched to a new branch 'add_staff_module_yusdirman'

Biasanya, apabila kita membina aplikasi beramai-ramai, kita akan tandakan branch yang kita bina itu dengan nama sendiri supaya mudah dikenalpasti nanti. 

Dari sini, tulislah kodprogram anda. simpan dan uji.

Jika dah berjaya. Commit. ...?

Dalam pengurusan kodprogram menggunakan git, setiap perubahan yang telah dibuat perlu diisytiharkan dan kemudian disahkan pula dengan menggunankan arahan git add dan git commit

Pada ketika ini, bagi sesiapa yang belum pernah menggunakan mana-mana pengurusan kodprogram sebelum ini, termonologi ini adalah sangat asing.

Git mempunyai 3 peringkat dalam setiap perubahan kod aturcara.

1. bersih (clean)

2. ada perubahan, belum dipentaskan

3. telah dipentaskan, belum dicommit

selepas dicommit, ianya akan kembali semula ke peringkat 1: Bersih


Apakah maksud ketiga-tiga peringkat ini?

1. Bersih: tiada apa-apa perubahan berlaku pada kod program. 

2. Belum dipentaskan (unstage) : terdapat perubahan pada fail. namun belum diisytiharkan untuk dimasukkan kedalam repositori

3. Telah dipentaskan (staged) tapi belum dicommit  : fail-fail yang berubah telah dikenalpasti untuk dimasukkan kedalam repo. 

Setelah juruprogram pasti dengan perubahan tersebut, dia hanya perlu commit sahaja kodprogram. Maka satu bab atau titik perbatuan telah direkodkan dalam log pembangunan aplikasi ini dan segala perubahan yang dilakukan juga direkodkan.

Mari saya tunjukkan contoh:

 selepas membina branch baru, saya telah memasukkan fail dan kod baru ke dalam aplikasi ini.

saya boleh melihat status perubahan dengan :
$\> git status
On branch add_staff_module_yusdirman
Changes not staged for commit:
  (use "git add ..." to update what will be committed)
  (use "git checkout -- ..." to discard changes in working directory)
modified:   config/routes.rb
Untracked files:
  (use "git add ..." to include in what will be committed)
app/assets/javascripts/staffs.coffee
app/assets/stylesheets/scaffolds.scss
app/assets/stylesheets/staffs.scss
app/controllers/staffs_controller.rb
app/helpers/staffs_helper.rb
app/models/staff.rb
app/views/staffs/
db/migrate/20161116180542_create_staffs.rb
test/controllers/
test/fixtures/staffs.yml
test/models/
no changes added to commit (use "git add" and/or "git commit -a")
Apabila arahan git status dimasukkan, setiap perubahan akan tersenarai. 

Status "Changes not staged for commit" merujuk kepada perubahan yang telah kita lakukan (telah save) namun masih belum dipentaskan untuk dicommit.

Cara untuk pentaskan fail (staging)

$\> git add [nama fail] : untuk pilih fail mana yang akan dipentaskan (stage)
atau

$\> git add . : semua perubahan pada semua fail dipentaskan

selepas itu, status fail tadi akan berubah

$\> git status
On branch add_staff_module_yusdirman
Changes to be committed:
  (use "git reset HEAD ..." to unstage)
new file:   app/assets/javascripts/staffs.coffee
new file:   app/assets/stylesheets/scaffolds.scss
new file:   app/assets/stylesheets/staffs.scss
new file:   app/controllers/staffs_controller.rb
new file:   app/helpers/staffs_helper.rb
new file:   app/models/staff.rb
new file:   app/views/staffs/_form.html.erb
new file:   app/views/staffs/edit.html.erb
new file:   app/views/staffs/index.html.erb
new file:   app/views/staffs/new.html.erb
new file:   app/views/staffs/show.html.erb
modified:   config/routes.rb
new file:   db/migrate/20161116180542_create_staffs.rb
new file:   test/controllers/staffs_controller_test.rb
new file:   test/fixtures/staffs.yml
new file:   test/models/staff_test.rb

Status "Changes to be committed" menunjukkan kesemua fail yang tersenarai itu akan dimasukkan kedalam repositori.


langkah seterusnya adalah melarikan arahan git commit

$\> git commit -m "create scaffold for staff to integrate existing staff table with boxroom for user session"
[add_staff_module_yusdirman 5368f32] 
create scaffold for staff to integrate existing staff table with boxroom for user session
 16 files changed, 326 insertions(+)
 create mode 100644 app/assets/javascripts/staffs.coffee
 create mode 100644 app/assets/stylesheets/scaffolds.scss
 create mode 100644 app/assets/stylesheets/staffs.scss
 create mode 100644 app/controllers/staffs_controller.rb
 create mode 100644 app/helpers/staffs_helper.rb
 create mode 100644 app/models/staff.rb
 create mode 100644 app/views/staffs/_form.html.erb
 create mode 100644 app/views/staffs/edit.html.erb
 create mode 100644 app/views/staffs/index.html.erb
 create mode 100644 app/views/staffs/new.html.erb
 create mode 100644 app/views/staffs/show.html.erb
 create mode 100644 db/migrate/20161116180542_create_staffs.rb
 create mode 100644 test/controllers/staffs_controller_test.rb
 create mode 100644 test/fixtures/staffs.yml
 create mode 100644 test/models/staff_test.rb 

Untuk git commit, kita perlu masukkan komen (wajib)

komen ini bertujuan untuk memberitahu orang lain apa yang kita lakukan pada perubahan itu.


Saya rasa, sampai disini dulu kali ini. Nanti bersambung lagi..



Download git disini:

https://git-scm.com/

tutorial juga ada dilaman tersebut.
untuk tutorial interaktif, boleh cuba disini:

https://try.github.io/

Wassalamualaikum

Ulasan

Catatan popular daripada blog ini

Apa Maksud RON dalam pengkelasan Petrol?

RON dan Petrol Oleh yusdirman, Oktober 2014 RON adalah singkatan daripada Research Octane Number Ianya kaedah penarafan bahan api. Lebih tinggi nilai RON, lebih mahal harga PETROL. Adakah minyak RON 97 lebih berkuasa berbanding RON 95? RON merujuk kepada tahap bahan api menahan rintangan "ketukan" semasa proses pembakaran oleh palam pencucuh dalam enjin. Ianya merujuk kepada tahap ketahanan bahan api untuk tidak terbakar sebelum dinyalakan oleh palam pencucuh dalam enjin. "ketukan" dalam konteks RON ini adalah apabila campuran bahan api dan udara dalam enjin terbakar lebih awal sebelum api dari palam pencucuh menbakarnya. Pembakaran awal ini mungkin disebabkan enjin terlalu panas. Haba dari silinder enjin itu sendiri mungkin telah menyalakan bahan api sebelum palam pencucuh menyala. Ini boleh menurunkan prestasi dan mungkin boleh memudaratkan enjin! Jadi, RON bukannya bermaksud LEBIH KUASA! Ianya bermaksud bahan api itu dapat menahan tekanan dari

Load Balancing dengan Nginx dan Puma

Load Balancing dengan Nginx dan Puma Tutorial ini adalah sangat ringkas hanya untuk menunjukkan kebolehan nginx sebagai load balancer yang dapat menjadi 'orang tengah' antara banyak server di belakangnya Keperluan 1. Paling kurang 2 server aplikasi 2. Satu server diinstall nginx Contoh Persekitaran yang sekarang 1. server1: os: debian application: ruby on rails web server : puma dns : myaplication1.yusdirman.com 2. server2: myaplication2.yusdirman.com os:debian application: ruby on rails web server : puma dns : myaplication1.yusdirman.com 3. nginx diinstall di server1 /ets/nginx/nginx.conf setup (default): worker_processes  2; worker_processes  auto; worker_rlimit_nofile 65536; error_log  logs/error.log  notice; error_log  logs/error.log  info; events {   worker_connections  65536; } http {   include       mime.types;   default_type  application/octet-stream;   sendfile        on;   tcp_nopush on;   tcp_nodelay on;   keepalive_tim

Server Redundancy - Pertindanan Komputer Pelayan

alkisahnya tercari-cari untuk buat server redundancy ( pertindihan komputer pelayan ) atas sebab perlunya server yang sentiasa on-line tanpa ada downtime yang lama. Dan, cabarannya adalah memang kami tak pernah jalani apa-apa latihan, pengalaman dan apa jua pengetahuan berkenaan teknologi ini. Yang pastinya, perlu banyak mengoogle. Setakat ini, ada banyak kaedah untuk memastikan aplikasi masih terus boleh berfungsi walaupun server mati/rosak. 1. guna 2 server yang sama. Bila satu mati, satu lagi yang masih hidup dapat terus melayan pengguna. 2. guna 2 talian rangkaian yang berbeza. Bila satu talian rosak/putus, masih ada satu lagi talian rangkaian yang berfungsi. 3. storan di server guna raid ( redundant array of independent disk ) atau dalam bahasa melayu : barisan disk berlainan yang bertindan. Raid dapat menjadikan sebilangan hd menjadi 1 dengan semua data pada 1 hd adalah sama dengan data pada hd 2. (mirroring) 4. satu IP maya untuk sebilangan server. 2 server yang mena