Cara mengunggah proyek ke Github sebagai pemula

Setiap pengembang atau profesional yang terkait dengan dunia teknologi tahu apa itu GitHubNamun, tidak semua orang menguasai proses unggah proyek ke Github dan memanfaatkan sepenuhnya potensi kontrol versi, kolaborasi tim, dan visibilitas profesional yang ditawarkan platform ini.

Jadi, dalam hal ini, baik pemula maupun ahli sering kali merasa agak bingung. Dalam artikel ini, Anda akan mempelajari Kami memberi tahu Anda cara melakukannya, karena Ada beberapa pilihan atau metodeJika Anda ingin membuat proyek Anda tersedia untuk kolaborasi atau agar orang lain dapat melihat dan mengunduhnya dengan mudah, baca terus untuk mempelajari semua detailnya.

Apa itu repositori dan mengapa menyimpannya di GitHub?

Un gudang Ini adalah ruang virtual tempat file dan folder proyek Anda disimpan, beserta riwayat perubahan yang terjadi saat Anda melanjutkan pengembangannya. Riwayat ini memungkinkan Kelola versi, kembalikan ke status sebelumnya, berkolaborasi dengan orang lain, dan simpan catatan jelas tentang kemajuan pekerjaan Anda..

Hosting repositori di GitHub Hal ini memiliki beberapa keunggulan:

• Kontrol versi: Perubahan Anda direkam dan Anda dapat membatalkan, meninjau, atau membagikan bagian mana pun dari pengembangan.
• Pencadangan cloud: Anda terhindar dari kehilangan informasi penting jika terjadi insiden lokal.
• Visibilitas profesional: Karena bersifat publik, siapa pun dapat melihat karya Anda, yang meningkatkan portofolio Anda.
• Kolaborasi sederhana: GitHub memudahkan orang lain berkontribusi ke proyek Anda melalui permintaan tarik, masalah, atau percabangan.

Memulai: Prasyarat dan Persiapan Lingkungan

Sebelum mengunggah proyek ke Github, pastikan Anda telah menginstal yang berikut ini di komputer Anda:

• Akun di GitHub. Sangat penting untuk membuat repositori pada platform.
• Git sudah terpasang. Ini adalah alat kontrol versi dasar yang memungkinkan Anda mengelola perubahan. Anda dapat mengunduh dan menginstalnya dari situs web resmiPada sistem berbasis Linux, Anda dapat melakukan instalasi dengan menjalankan perintah sudo apt-get install git di terminal.
• Editor kode atau IDE. Opsi seperti Visual Studio Code (Kode VSC) mempermudah prosesnya. Jika Anda ingin memanfaatkan integrasi langsung dengan GitHub dari editor, sebaiknya unduh salah satu alat ini.

Setelah terpasang Git pada sistem Anda, langkah pertama adalah mengonfigurasinya dengan nama dan email (Data ini akan digunakan untuk menandatangani komitmen Anda.) Dari terminal, jalankan yang berikut ini:

git config --global user.name "TuNombre"
git config --global user.email [email protected]

Konfigurasi ini adalah global dan Anda hanya perlu melakukannya satu kali dalam tim Anda.

Membuat repositori di GitHub

Sekarang saatnya membuat ruang tempat Anda akan menyimpan proyek Anda. Lakukan ini dari antarmuka web GitHub dengan mengikuti langkah-langkah berikut:

1. Akses profil Anda di GitHub.com lalu tekan tombolnya "Baru" untuk membuat repositori baru.
2. Masuk nama diinginkan untuk repositori dan menambahkan keterangan singkat tetapi konkret tentang tujuan proyek.
3. Pilih apakah repositori akan publik atau swastaJika Anda ingin orang lain dapat melihat dan berpartisipasi, pilih publik.
4. Anda memiliki opsi untuk membuat file README.md secara otomatis. File ini direkomendasikan, karena merupakan hal pertama yang akan dilihat oleh pengembang lain saat mereka mengakses repositori.
5. Klik pada "Buat repositori" untuk menyelesaikan proses dan repositori Anda akan siap menerima berkas.

Mempersiapkan proyek lokal Anda untuk diunggah ke GitHub

Setelah repositori Anda dibuat, langkah selanjutnya untuk mengunggah proyek ke GitHub adalah menyiapkan folder proyek di komputer Anda. Untuk melakukannya, ikuti petunjuk berikut di terminal, pertama-tama cari jalur yang benar dengan cd:

cd tu-carpeta-del-proyecto

Sekarang inisialisasi repositori Git lokal:

git init

Ini akan membuat folder tersembunyi bernama .git yang menyimpan riwayat versi dan berkas internal lainnya.

 

Mengunggah kode ke GitHub: proses lengkap di terminal

Setelah repositori lokal diinisialisasi, kami akan mengunggah semua konten ke GitHub dengan menjalankan perintah berikut:

1. Tambahkan semua file ke area pementasan dengan:

git add .

2. Buat komitmen Untuk merekam titik pemeriksaan pertama:

git commit -m "Primer commit"

3. Hubungkan repositori lokal dengan repositori jarak jauh. Menggantikan NOMBRE_USUARIO y NOMBRE_REPOSITORIO dengan data nyata:

git remote add origin https://github.com/NOMBRE_USUARIO/NOMBRE_REPOSITORIO.git

4. Unggah perubahan ke GitHub (cabang main o master sebagaimana mestinya):

git push -u origin main

Di beberapa repositori atau konfigurasi lama, cabang utamanya adalah master alih-alih mainJika Anda mendapatkan kesalahan, periksa nama cabang utama dan ganti dalam perintah di atas.

Cara mengunggah proyek ke Github dari VSCode

Editor modern seperti Kode VSC Mereka memiliki integrasi asli dengan Git dan GitHub. Berikut cara melakukannya dengan mudah:

• Buka folder proyek Anda di editor (“File → Buka Folder”).
• Akses panel Kontrol Sumber (kontrol kode sumber) yang terletak di bilah sisi.
• Klik "Initialize repository" jika Anda belum melakukannya. Ini sama dengan perintah git init.
• Setelah diinisialisasi, Anda akan melihat tombol untuk Publikasikan ke GitHubJika ini pertama kalinya Anda, Anda harus mengotorisasi koneksi antara VSCode dan akun GitHub Anda.
• Pilih untuk menerbitkan repositori sebagai publik atau privat.
• Siapkan berkas untuk komitmen pertama dengan menandai perubahan dan menambahkan pesan deskriptif.
• Publikasikan proyek Anda dan Anda dapat dengan mudah menyinkronkan perubahan dari editor.

Pilihan ini sempurna bagi mereka yang lebih suka tetap berada dalam lingkungan pengembangan dan membuat manajemen proyek harian menjadi jauh lebih mudah.

Unggah file secara manual dari situs web GitHub

Alternatif lain, terutama untuk proyek kecil, adalah mengunggah file secara manual dari antarmuka web:

1. Masuk ke repositori yang baru dibuat di GitHub.
2. Klik pada menu tarik-turun "Tambahkan berkas" dan pilih Unggah file.
3. Tarik dan letakkan file atau folder dari komputer Anda ke jendela browser.
4. Di bagian bawah, tambahkan pesan konfirmasi dan klik Komit perubahan untuk mengunggah berkas.

Metode ini kurang efisien untuk proyek dalam pengembangan aktif, tetapi berguna untuk menambahkan file, dokumentasi, dan item tertentu lainnya.

Manajemen tingkat lanjut dan praktik terbaik saat bekerja dengan GitHub

Mengunggah proyek hanyalah permulaan. Untuk mendapatkan manfaat maksimal dari GitHub dan mempertahankan organisasi yang profesional, kami sarankan untuk mengikuti praktik terbaik tambahan berikut:

• Selalu perbarui README.md. Ini adalah surat pengantar proyek Anda. Surat ini menjelaskan tujuannya, cara menginstalnya, cara menggunakannya, dan detail yang relevan. Anda dapat mengeditnya langsung secara daring atau dari editor Anda menggunakan sintaks Markdown.
• Membuat cabang kerja. Jangan buat semua perubahan di "main" atau "master." Gunakan cabang terpisah untuk fitur atau perbaikan baru. Anda dapat menggabungkannya nanti menggunakan permintaan tarik.
• Unggah file .gitignore untuk menghindari berbagi data sensitif atau yang dibuat secara otomatis, seperti folder node_modules, file sementara, atau file konfigurasi lokal.
• Sinkronkan repositori lokal dan jarak jauh Anda secara berkala. Menggunakan git pull untuk menjaga salinan lokal Anda tetap terkini dengan setiap perubahan yang mungkin telah dibuat oleh kontributor.
• Kelola remote dengan hati-hati. Jika Anda pernah mengubah sumber jarak jauh, gunakan git remote -v untuk meninjau repositori terkait dan git remote remove origin untuk menghapusnya jika perlu.

Klon dan berkolaborasi pada proyek: langkah selanjutnya

Setelah repositori Anda ada di cloud, Anda dapat mengkloningnya ke komputer lain mana pun menggunakan:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git

Ini akan membuat salinan lokal proyek Anda, termasuk semua riwayat perubahanJika Anda ingin folder tersebut memiliki nama yang berbeda, Anda dapat menambahkannya di akhir perintah. Untuk mencegah perintah tersebut membuat folder baru dan menempatkan file secara langsung ke direktori saat ini, tambahkan titik:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git .

Berkolaborasi dengan pengguna lain di GitHub berarti mempelajari alur cabang, permintaan penarikan, dan tinjauan kode. Dengan cara ini, Anda akan dapat menerima kontribusi eksternal dan bekerja sebagai tim secara terorganisasi dan efisien.

Kesalahan umum dan cara memperbaikinya

Saat mengunggah proyek, Anda mungkin mengalami beberapa masalah umum. Berikut ini adalah masalah yang paling umum dan cara mengatasinya:

• Mencoba mendorong ke repositori kosong tanpa cabang master- Jika repositori jarak jauh dibuat tanpa README.md dan cabang belum pernah didorong, pastikan untuk mendorong cabang pertama dengan nama yang benar, biasanya "utama" atau "master".
• Konflik sinkronisasi:Jika terjadi perubahan secara lokal dan jarak jauh secara bersamaan, selesaikan dengan melakukan peninjauan terlebih dahulu. git pull dan menyelesaikan konflik sebelum melakukan git push lagi.
• Izin tidak mencukupiPastikan Anda memiliki kredensial yang benar dan periksa apakah URL jarak jauh dieja dengan benar (https atau ssh sebagaimana mestinya).
• Lupa menambahkan file penting: Tinjau dan perbarui berkas Anda .gitignore agar tidak tertinggal file-file penting atau tidak sengaja mengunggah informasi pribadi.

Mengunggah proyek Anda ke GitHub akan mengubah alur kerja Anda: Anda selalu dapat memulihkan versi sebelumnya, berkolaborasi, dan memamerkan pekerjaan Anda kepada dunia.