Deploy Hugo Di Github

Memanfaatkan github sebagai hosting hugo secara gratis

April 1, 2021

Misterthree

Facebook Twitter Instagram Youtube

Github Pages adalah sebuah website yang memanfaatkan hosting github langsung dari repositori yang ada. Setiap akun atau organisasi hanya memiliki satu Repositori, namun hosting yang kamu miliki masih bisa di manfaatkan sebagai media penyimpanan proyek yang sedang kamu kerjakan. Nah, disini kita akan mencoba memanfaatkan akun github yang kita miliki sebagai hosting Hugo. Jika kamu belum memiliki akun github, kamu perlu mendaftar terlebih dahulu untuk dapat menggunakannya.

Berdasarkan panduan yang saya baca dari situs resmi Hugo, ada empat cara yang bisa digunakan untuk hosting hugo di github :

1. Hosting ke direktori doc
2. Hosting ke cabang gh-pages
3. Hosting ke halaman personal/organisasi
4. Hosting Github dengan Continuous Integration (CI)

Pada saat ini kita akan mengunakan cara nomor tiga yang menurut saya mudah untuk dipahami bagi kita yang baru belajar.

Buat Repositori

• Pastikan anda sudah memiliki akun github

• Sebelum membuat repositori lebih baik setting SSH terlebih dahulu ke github agar kita tidak diminta memasukan password disetiap kali nge-push hugo ke github.

• Buat dua repositori:

  1. blog

     

     Repositori ini opsional dibuat sebagai back-up semua file Hugo

  2. username.github.io atau organisasi.github.io

     

     Repositori username.github.io untuk menyimpan file yang ada di public atau hasil render dari Hugo dan repository ini yang nantinya akan bisa diakses melalui https://username.github.io.

  Saat membut repository, jangan centang “Initalize this repository with README.md” agar kosong.

Membuat File Back-UP

Setelah kita membuat repository di github selanjutnya kita menghubungkan repository website kita dengan repository github dengan inisialisasi git.

• Masuk direktori hugo, sebagai contoh nama direktori website saya testhugo

  cd testhugo
  

• Lakukan inisialisasi git:

  git init
  

• Hapus direktori public, karena ini adalah repository back-up file ini dihapus saja.

  rm -rf public
  

• Kita hubungkan direktori website kita dengan repository hugo mengunakan repository remote

  Jika kamu sudah melakukan setting ssh gunakan perintah SSH

  git remote add origin git@github.com:{username}/{nama-repo}.git
  

  Jika belum kita gunakan perintah HTTPS

  git remote add origin https://github.com/{username}/{nama-repo}.git
  

• Setelah semua siap tinggal kita upload ke github:

  git add .
  git commit -m "commit pertama"
  git push -u origin master
  

  Perintah ini akan selalu kamu lakukan setiap ingin melalukan update file back-up.

  

Membuat SubModul

SubModul ini yang nantinya akan menjadi website kita yang bisa diakses dengan https://username.github.io

• Pastikan masih didalam direktori hugo

• Tambahkan submodul di direktori Hugo

  Jika kamu sudah melakukan setting ssh gunakan perintah SSH

  git submodule add -b master git@github.com:{username}/{username}.github.io.git public
  

  Jika belum kita gunakan perintah HTTPS

  git submodule add -b master https://github.com/{username}/{username}.github.io.git public
  

  Perintah tersebut akan melakukan menghubungkan repository username.github.io ke dalam direktori public.

• Setelah semua sudah siap tinggal kita upload ke Github

  # generate statc web
  hugo
  
  # push ke repository
  cd public
  git add .
  git commit -m "tes Deploy hugo"
  git push -u origin master
  

  Perintah ini akan selalu kamu lakukan setiap ingin melalukan update website.

  

  Tunggu beberapa saat dan anda buka https://username.github.io