Menguasai Kontrol Versi: Panduan Praktis Git dan GitHub untuk Pengembang
Hidup seorang programmer sudah cukup sulit. Mengapa tidak membuat hidup Anda lebih mudah dan mengalihkan kontrol versi proyek Anda ke layanan khusus? Sebagian besar programmer di dunia IT akrab dengan Git, tetapi bagi beberapa programmer OT di komunitas ini, ini adalah konsep yang baru. Saat bekerja dengan rekan-rekan yang berbeda di proyek yang sama, berbagi kode menjadi semakin merepotkan, layanan seperti GitHub membuatnya mudah untuk berbagi dan bekerja sama pada kode yang sama. Blog ini memandu Anda melalui langkah awal Anda dalam menggunakan Git dan GitHub untuk menjaga kode dan proyek Anda tetap teratur.
Dalam blog ini saya akan menggunakan GitHub dan GitHub client untuk windows, tetapi perhatikan bahwa ada lebih banyak opsi termasuk GitLab. Saya hanya menyukai kemudahan penggunaan GitHub Client!
Mengatur repositori di GitHub
Langkah 1 – Unduh dan instal GitHub Client untuk Windows
Sebenarnya, langkah pertama adalah membuat akun GitHub, tetapi itu agak di luar lingkup blog ini.
- Client dapat diunduh dari sini.
- Ikuti Panduan Instalasi
- Masuk ke akun GitHub Anda
Langkah 2 – Buat folder atau repositori untuk proyek Anda
Repositori adalah tempat untuk proyek Anda untuk tinggal. Buat satu folder untuk setiap proyek! Setiap kali ada perubahan di folder ini, GitHub client akan mendeteksi dan Anda akan dapat menyimpan atau mendorong perubahan Anda ke repositori online di GitHub.
- Klik “Create a New Repository on your hard drive … ”
- Berikan nama dan deskripsi pada repositori baru Anda.
- Anda dapat mengubah jalur untuk repositori jika Anda ingin, atau biarkan begitu (cara malas)
- Klik Initialize this repository with a README (Malas tidak berarti, mengikuti praktik terbaik dan mendokumentasikan kode Anda!)
- Buat repositori
Langkah 3 – Buat Proyek PLCnext
Git bekerja sangat baik dengan file berbasis teks. Untungnya di PLCnext Engineer ada opsi untuk menyimpan proyek Anda sebagai sejumlah besar file teks, sempurna untuk Git dan oleh karena itu untuk GitHub client kami!
- Buka PLCnext Engineer dan mulai membuat proyek seperti biasa.
- Saat siap menyimpan proyek Anda, pilih Save Project As (F12)
- Telusuri ke repositori GitHub Anda (default: This PC/documents/GitHub)
- Simpan proyek Anda sebagai “Uncompressed Project”
Langkah 4 – Commit perubahan Anda
Untuk “menyimpan” perubahan ke repositori Anda Anda perlu commitnya ke sebuah branch. Apa itu branch, saya akan jelaskan nanti, untuk saat ini Anda hanya perlu mengingat bahwa Anda perlu commit perubahan Anda ke branch untuk menyimpannya.
Berikan commit Anda deskripsi baru dan singkat sehingga Anda dapat mengingat apa yang berubah tepatnya!
Langkah 5 – Publish atau Push repositori Anda
Langkah terakhir untuk membuat repositori online adalah mendorong repositori lokal Anda ke GitHub. Ini mudah seperti menekan tombol atau menekan (ctrl + p). Pilih apakah kode Anda harus pribadi dan apakah itu milik Anda, atau organisasi.
Langkah 6 – Dokumentasikan!
tekan (Ctrl + shift + G) untuk melihat repositori online di GitHub di browser Anda. Voila! Di sana ada Proyek PLCnext Anda di GitHub. Ingat “Initialize README”? Itu adalah teks yang Anda lihat sekarang di depan Anda. Di README.md Anda harus menjelaskan struktur proyek, tujuannya dan mungkin beberapa informasi kontak untuk referensi di masa depan.
Untuk saat ini buat beberapa perubahan, ke file README.md dengan mengklik pensil. File tersebut “ditulis” dalam MarkDown informasi lebih lanjut tentang MarkDown dapat ditemukan di sini.
Jika Anda telah membuat beberapa perubahan, lagi commit ke branch master!
Langkah 7 – Pull perubahan ke repositori lokal Anda
Windows Client akan mendeteksi bahwa beberapa perubahan telah dibuat ke Repositori di GitHub. Jangan lupa untuk pull perubahan untuk mulai bekerja pada versi terbaru lagi!
Tips & Trik
Issue Tracker
GitHub memiliki issue tracker yang luar biasa, gunakan untuk melacak masalah yang diketahui dalam perangkat lunak Anda dan berdiskusi tentang solusi dengan pemangku kepentingan lainnya
Proyek
Gunakan Project Board bawaan untuk melacak tugas Anda dengan kanban board. Jika Anda merasa ingin Anda dapat mengotomatiskan kanban Anda dengan trigger bawaan untuk membuat hidup bahkan lebih mudah.
Branch
Aah, inilah kita. Lihat, saya bilang saya akan menjelaskan apa itu branch! Nah, saya akan biarkan GitHub menjelaskan apa itu branch …
Akan membuat banyak perubahan atau mengimplementasikan fitur baru? Buat branch untuk menjaga perubahan Anda terisolasi dan gabungkan “feature branch” Anda ke branch master Anda dengan pull request.
Release
Siap untuk melakukan deploy proyek? Buat release untuk ditambahkan ke AS Build Anda!
