Git_Version.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true,
    "pycharm": {
     "name": "#%% md\n"
    }
   },
   "source": [
    "# Pengantar Git Version dan Github\n",
    "## Git\n",
    "Git adalah program yang digunakan untuk menyimpan dan mengelola versi-versi file pekerjaan. Pengeloaan file tersebut dilakukan di dalam komputer secara lokal.\n",
    "\n",
    "Ilustrasi versi file dapat diibaratkan seperti kita membuat file dokumen (file_1.doc, file_2.doc, dan seterusnya sampai file_final.doc) dimana nomor menunjukkan versi kebaruan dari file pekerjaan. Daripada membuat dan menyimpan banyak file dengan nomor yang berbeda setiap kita melakukan perbaikan dokumen, maka program <b>Git</b> membantu dalam menyimpan <b> hanya versi perubahan </b> dalam file dokumen yang sedang dikerjakan. Dengan demikian, cukup membuat sebuah nama file.doc, kemudian setiap ada perubahan atau perbaikan, kita menyimpan informasi perubahan ke dalam program Git tersebut.\n",
    "\n",
    "Keuntungan sederhana lainnya menggunakan program Git adalah kita bisa melihat perubahan-perubahan pada setiap versi file dan apabila diperlukan, kita <i>set back</i> ke versi terdahulu/lama dari suatu file yang sedang dikerjakan.\n",
    "\n",
    "## Github\n",
    "<a href=\"github.com\">Github </a> adalah tempat menyimpan file-file versi pekerjaan dalam suatu repositori / tempat penyimpanan secara online. Github adalah salah satu penyedia, ada banyak penyedia ruang  penyimpanan versi pekerjaan online lainnya. Keuntungan menggunakan tempat penyimpanan secara online untuk versi-versi file pekerjaan adalah\n",
    "\n",
    "1. dapat diakses dari berbagai perangkat secara online\n",
    "\n",
    "2. dapat diakses oleh lebih dari satu orang untuk bekerja secara kolaboratif\n",
    "\n",
    "## Instalasi Git dan Registrasi Akun Github\n",
    "\n",
    "Sesi ini belum menjelaskan bagaimana proses instalasi git dan registrasi akun github. Diasumsikan pembaca bisa melakukan secara mandiri prose-proses\n",
    "\n",
    "1. Download program <a href=\"https://git-scm.com/downloads\"> Git </a>\n",
    "\n",
    "2. Instalasi program Git.\n",
    "\n",
    "3. Registrasi akun pada <a href=\"github.com\">Github </a>\n",
    "\n",
    "\n",
    "## Membuat Folder/Repositori pada <a href=\"github.com\">Github </a>\n",
    "\n",
    "1. Login menggunakan akun github.\n",
    "\n",
    "2. Klik tombol tab <b>Repositories</b> >> <b> New </b>\n",
    "\n",
    "3. Isikan nama folder atau repo yang diinginkan. Sebagai contoh, foldernya bernama <b>git-version</b>.\n",
    "\n",
    "4. Tuliskan deskripsi singkat mengenai folder yang dibuat. Contoh: <i> Folder ini menyimpan tutorial sederhana penggunaan git dan github</i>.\n",
    "\n",
    "5. Check list pada bagian [ ] Add a README file dan abaikan lebih dahulu pilihan-pilihan lainnya.\n",
    "\n",
    "6. Klik tombol <b> Create Repository </b>\n",
    "\n",
    "## Membuat Clonning Folder dari <a href=\"github.com\">Github </a> ke dalam Folder Komputer Lokal\n",
    "\n",
    "### A. Setting ssh-key di Komputer\n",
    "\n",
    "Langkah-langkahnya sebagai berikut:\n",
    "\n",
    "1. Jalankan <b> Git Bash </b>, kemudian ketik perintah:\n",
    "> ssh-keygen -t rsa -b 4096 -C \"akun_emailmu_di_github@contoh.com\"\n",
    "\n",
    "2. Jika muncul pertanyaan :\n",
    "> Enter a file in which to save the key (/c/Users/you/.ssh/id_rsa):[Press enter saja]\n",
    "\n",
    "3. Masukkan passphrase (password akun github.com) :\n",
    "> Enter passphrase (empty for no passphrase): [Type a passphrase]\n",
    "\n",
    "4. Ketik perintah ini untuk menuju pada folder berisi ssh-key\n",
    "> cd ~/.ssh\n",
    "\n",
    "5. Buka file id_rsa.pub menggunakan editor notepad++ atau lainnya, dan copy seluruh isi file tersebut.\n",
    "\n",
    "\n",
    "### B. Menambahkan ssh-key ke <a href=\"github.com\">Github </a>\n",
    "\n",
    "Langkahnya lanjutanny proses A sebagai berikut:\n",
    "\n",
    "1. Buka Account Setting pada Profil Github.com Anda\n",
    "\n",
    "2. Pilih menu <b>SSH and GPG Keys</b>\n",
    "\n",
    "3. Klik New SSH key. Isikan title, misal menggunakan nama komputer Anda (sebagai pengenal)\n",
    "\n",
    "4. Pada isian Key, <b> Paste</b> ssh-key yang telah di copy dari file id_rsa.pub.\n",
    "\n",
    "5. Simpan perubahan.\n",
    "\n",
    "### C. Clone Repo dari  <a href=\"github.com\">Github </a> ke Komputer\n",
    "\n",
    "Langkahnya sebagai berikut:\n",
    "\n",
    "1. Buka repositori <a href=\"github.com\">Github </a> yang telah dibuat.\n",
    "\n",
    "2. Pilih branch yang akan di kloning.\n",
    "\n",
    "3. klik tombol Code berwarna hijau, lalu pilih tab SSH, dan klik tombol Copy untuk menyalin url alamat repositori.\n",
    "\n",
    "4. Buka Git Bash, dan posisikan kursor pada folder dimana Anda akan menempatkan folder clonning dari Repo Github.com.  Ketik perintah clone. [Penjelasan : -o digunakan untuk mengganti nama origin menjadi nama alias dari remote sesuai keinginan. -b digunakan untuk memilih sepsifik branch yang akan di clone ]\n",
    "\n",
    "> git clone -o [shortcut_name] -b [branch_name]  git@github.com:[username_anda]/git-version.git\n",
    "\n",
    "5. Setelah download clone selesai, pada direktori Anda akan ada sebuah folder yang namanya sama dengan nama folder repo dari github. [ Anda boleh melakukan rename atau memindahkan ke tempat lain.]\n",
    "\n",
    "6. Masuklah ke dalam direktori tersebut menggunakan baris perintah di Git Bash, misal\n",
    "\n",
    "> cd [nama_direktori_repo]\n",
    "\n",
    "7. Ketik perintah ini untuk melihat hasilnya.\n",
    "\n",
    "> git remote -v\n",
    "\n",
    "8. Coba test untuk lakukan push (sinkronisasi dari lokal ke repo github). Jika ditanyakan parapharse (password), maka isikan password. Proses selesai jika uptodate\n",
    "\n",
    "> git push\n",
    "\n",
    "> Enter passphrase for key '/c/Users/Yusuf/.ssh/id_rsa':\n",
    "\n",
    "> Everything up-to-date\n",
    "\n",
    "9. Agar tidak diatanyakan berulang password, maka jalankan perintah pada git bash\n",
    "\n",
    "> eval 'ssh-agent'\n",
    "\n",
    "10. Menambahkan key yang sudah ada dengan nama yang berbeda, replace id_rsa di command dengan nama file key private.\n",
    "\n",
    "> ssh-add ~/.ssh/id_rsa\n",
    "\n",
    "11. Tambahkan proses configurasi folder\n",
    "\n",
    "> git config --local user.email \"[email_anda@github]\"\n",
    "\n",
    "> git config --local user.username [username_anda]\n",
    "\n",
    "12. Coba git push lagi. Jia tidak ada permintaah password, maka selesai\n",
    "\n",
    "\n",
    "### D. Jika memiliki 2 akun github.com yang berbeda\n",
    "\n",
    "lakukan proses pada langkah A sa,pai C, hanya saja saat diminta nama file id_rsa, tambahkan angka 2 dibelakangnya menjadi <b>id_rsa2</b>\n",
    "\n",
    "> Enter a file in which to save the key (/c/Users/you/.ssh/id_rsa):[ketikkan id_rsa2]\n",
    "\n",
    "[TODO: Bagian di bawah Ini tidak digunakan Lagi !!! ]\n",
    "\n",
    "## Config dan Init\n",
    "\n",
    "Langkah awal adalah melakukan konfigurasi terkait hak akses.\n",
    "\n",
    "1. Buka interface command line (cmd) atau terminal untuk mengeksekusi perintah-perintah Git.\n",
    "\n",
    "2. Pastikan terminal sudah berada di folder clonning yang dibuat sebelumnya. gunakan perintah <i> pwd </i>\n",
    "\n",
    "3. lakukan proses konfigurasi menggunakan perintah berikut ini\n",
    "\n",
    "> git config --local user.username \"Your User Detail Name\"\n",
    "\n",
    "> git config --local user.email youremail@gmail.com\n",
    "\n",
    "> git config --local user.name \"your name\"\n",
    "\n",
    "4. Check git config.\n",
    "\n",
    "> git config --list\n",
    "\n",
    "\n",
    "Langkah berikutnya membuat atau konfigurasi folder f:/git-version-main agar dikenali sebagai folder untuk mengelola file pekerjaan berbasis git version.\n",
    "\n",
    "1. Gunakan perintah ini:\n",
    "\n",
    "> git init .\n",
    "\n",
    "perhatikan tanda titik tersebut. Artinya menjadi folder dilokasi saat ini menjadi folder berbasis git.\n",
    "\n",
    "> Initialized empty Git repository in F:/git-version-main/.git/\n",
    "\n",
    "2. Jika Anda menampilkan hidden folder, maka bisa dilihat ada folder <b>.git</b>\n",
    "\n",
    "## Mengarahkan Remote / Sinkronisasi antara Folder Lokal dan Repo di <a href=\"github.com\">Github </a>\n",
    "\n",
    "Langkah berikutnya ada mengatur agar folder di lokal komputer sebelumnya dapat disinkronkan dengan folder atau repositori di <a href=\"github.com\">Github </a>\n",
    "\n",
    "1. Buka repositori <a href=\"github.com\">Github </a> yang telah dibuat\n",
    "\n",
    "2. klik tombol Code berwarna hijau, lalu pilih tab HTTPS, dan klik tombol Copy untuk menyalin url alamat repositori\n",
    "\n",
    "3. Ketik perintah ini. Perhatikan alamat url adalah copy-paste dari langkah 2.\n",
    "\n",
    "> git remote add github https://github.com/priyandari/git-version.git\n",
    "\n",
    "Catatan: struktur dasarnya seperti di bawah ini. Nama singkat itu akan <b>digunakan</b> saat kita akan melakukan proses upload ke folder repo\n",
    "\n",
    "> git remote add [namasingkat] [link URL HTTPS]\n",
    "\n",
    "\n",
    "4. Periksa apakah remote-remote sudah ditambahkan\n",
    "\n",
    "> git remote -v"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}