Update di cPanel

Berikut ini langkah-langkah untuk mengupdate script OpenDK (versi terbaru dari Github) di cPanel (Shared Hosting)

Asumsi

Prosedur update ini berasumsi:

1. Struktur folder di hosting cPanel adalah hasil install mengikuti prosedur di Install-di-cPanel. Yaitu, script utama tersimpan di folder opendk dan isi folder public telah dipindahkan ke folder public_html.
2. cPanel menyediakan menu sbb. Gunakan hosting (seperti yg disediakan OpenDesa) yang menyediakan menu-menu itu.
   • Files > Git Version Control, dan
   • Advanced > Terminal

File OpenDK yang tidak boleh ditimpa

File yang diubah khusus untuk keperluan instalasi kecamatan tidak boleh ditimpa pada waktu melakukan update OpenDK ke versi baru.

File di folder opendk yang tidak boleh ditimpa:

• .env

File di folder public_html yang tidak boleh ditimpa:

• folder upload
• .htaccess
• favicon.ico
• index.php
• storage

Siapkan repository OpenDK supaya bisa update menggunakan git

Langkah berikut ini hanya perlu dilakukan satu kali. Kalau repository OpenDK sudah ada, langkah berikut tidak perlu dilakukan lagi.

Pasang repository OpenDK menggunakan Git

1. Login ke cPanel
2. Buka Files > Git Version Control
3. Create repository baru
4. Di isian Clone URL, masukkan url https://github.com/OpenDK/OpenDK.git
5. Di isian Repository Path dan Repository Name gunakan nama default OpenDK
6. Tekan tombol Create

Buat file .cpanel.yml untuk repository OpenDK

1. Buka cPanel Files > File Manager. Perhatikan dan catat nama instalasi yang ada di menu navigasi di bagian atas sesudah /home/
2. Masuk ke folder repositories/OpenDK
3. Buat file baru .cpanel.yml. Perhatikan ada titik di awal nama file. File seperti ini defaultnya tidak tampil, yaitu 'hidden'. Untuk menampilkan file yang ‘hidden’ klik setting -> centang 'show hidden'.
4. Salin ke file itu script di bawah ini :

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/<instalasi>/opendk
    - export PUBLICPATH=/home/<instalasi>/public_html
    - /bin/cp -rf * $DEPLOYPATH
    - /bin/cp -rf public/bower_components public/css public/img public/installer public/js  $PUBLICPATH

1. Ubah baris lokasi sasaran DEPLOYPATH dan PUBLICPATH sesuai dengan path instalasi
2. Simpan file .cpanel.yml

Commit file .cpanel.yml ke repository OpenDK

1. Di cPanel, buka Advanced > Terminal
2. Ketikkan cd repositories/OpenDK + Enter
3. Ketikkan git config --global user.email “<email anda>" + Enter
4. Ketikkan git config -- global user.name “<nama anda>” + Enter
5. Ketikkan git status + Enter, dan yakinkan hasilnya melaporkan adanya penambahan file .cpanel.yml
6. Ketikkan git add . + Enter
7. Ketikkan git commit -m “Tambah .cpanel.yml” + Enter
8. Ketikkan git status + Enter, dan yakinkan hasilnya melaporkan tidak ada perubahan

Update script OpenDK

Setelah semua persiapan di atas telah dilakukan, script OpenDK dapat diupdate mengikuti langkah-langkah berikut.

Backup database

1. Di cPanel, buka Database > Phpmyadmin
2. Pilih database yang digunakan
3. Export ke komputer lokal, simpan di tempat yang aman

Update repository OpenDK (masukkan script terbaru langsung dari Github)

1. Pergi ke dashboard cPanel
2. Buka File > Git Version Control
3. Klik Kelola (atau Manage) untuk repository OpenDK
4. Klik tab Pull or Deploy
5. Klik Update from Remote
6. Apabila terjadi error “fatal: Not possible to fast-forward, aborting.", hapus git repository dan buat ulang:
   1. Di File Manager, hapus folder repositories/OpenDK
   2. Buat repository OpenDK dari awal lagi (lihat prosedur di atas).

Deploy script OpenDK

Proses berikut akan menimpa script OpenDK di folder opendk dan public_html dengan script versi baru, kecuali file ubahan kecamatan yang tidak boleh ditimpa.

1. Di cPanel, buka Files > Git Version Control
2. Klik Kelola (atau Manage) untuk repository OpenDK
3. Klik tab Pull or Deploy
4. Klik Deploy HEAD Commit
5. Buka Files > File Manager, dan yakinkan script OpenDK telah disalin ke folder opendk dan public_html

Jalankan migrasi

Jalankan proses berikut untuk mengubah struktur database sesuai dengan kebutuhan versi OpenDK yang baru.

1. Di browser, buka <URL aplikasi>/update (misalnya: https://luak.opendesa.id/update)

Kalau tidak ada perubahan database untuk versi OpenDK yang baru ini, layar kosong akan tampil dengan pesan 'Sorry, the page you are looking for could not be found.'