¶ Proses Rilis Premium
Rilis pada aplikasi-aplikasi yang dikembangkan oleh OpenDesa yaitu dilakukan setiap bulan pada tanggal 01, kecuali pada aplikasi tertentu dapat dilakukan setiap hari Rabu jika ada versi rev dan untuk aplikasi berupa layanan maka dapat dilakukan setiap saat ketika penambahan fitur atau bug telah diperbaiki agar dapat digunakan segera oleh layanan.
Adapun proses rilis pada aplikasi setiap bulannya wajib mengikuti prosedur berikut:
- H-5 rilis akan dilakukan pembekuan, yaitu tidak akan dilakukan penggabungan baik fitur baru maupun bug.
- Untuk Rilis Beta di Umumkan ke Pengguna Premium
- Untuk Rilis Beta di Umumkan ke Tim Testing
- Pembuatan PR rilis dilakukan H-1 pembekuan.
- Unggah versi pra-rilis terbaru ke web demo masing-masing aplikasi.
- Umumkan di https://www.facebook.com/groups/OpenSID mengajak seluruh komunitas untuk ikut melakukan testing.
- Lakukan testing bersama komunitas untuk memastikan semua perubahan bekerja sesuai yang diinginkan.
- Komunitas yang melakukan testing untuk melaporkan jika terdapat kesalahan di https://github.com/OpenSID/wiki-pbb/issues agar segera diperbaiki sebelum rilis.
- Hanya lakukan perbaikan apabila ada kesalahan fatal akibat perubahan sejak rilis sebelumnya.
¶ Proses Rilis
Panduan ini menjelaskan langkah-langkah untuk melakukan rilis OpenSID versi Premium. Proses rilis untuk versi Umum ada di [[Proses Rilis Umum]].
Perilisan OpenSID versi resmi dilakukan pada tanggal 1 setiap bulan. Tetapi perbaikan dan penambahan fitur dilakukan secara terus-menurus. Proses rilis berjalan dijelaskan di [[Proses Rilis Premium Berjalan]].
Semua pengembangan perlu dihentikan lima hari sebelum rilis, untuk memberi waktu khusus untuk testing dan persiapan rilis. Dalam lima hari tersebut, perubahan masih mungkin dilakukan, untuk memperbaiki masalah yang ditemukan saat testing.
Alur Rilis :
Langkah-langkah membuat rilis:
Sistem penomoran versi OpenSID menggunakan Calendar Versioning dengan format vYY.MM-premium, di mana v adalah inisial dari kata Versi, YY adalah Dua digit terakhir tahun rilis, dan MM adalah bulan rilis (contoh v21.06-premium untuk rilis bulan Juni 2021). Tambahan -premium adalah untuk membedakan versi ini dari rilis Umum dengan versi yang sama.
Lima hari sebelum rilis:
- Lakukan testing untuk memastikan semua perubahan bekerja sesuai yang diinginkan. Lima hari sebelum rilis, bekukan semua perubahan script, dan umumkan di https://www.facebook.com/groups/OpenSID/ mengajak seluruh komunitas untuk ikut melakukan testing. Hanya lakukan perbaikan apabila ada kesalahan fatal akibat perubahan sejak rilis sebelumnya.
Sebelum membuat posting, yakinkan https://berputar.opensid.or.id sudah memuat versi pra-rilis terbaru siap untuk digunakan untuk testing. - Periksa setiap tema sebelum rilis untuk menampilkan logo idcloud host dan ingatkan pembuat tema untuk menerapkan.
Pada hari rilis:
Lakukan di Pagi hari 08.00 WIB
Lakukan menggunakan branch rilis-dev.
- Checkout ke
bug-fix. Lakukan update package dengan menjalankancomposer update --no-devjika ada perubahan. - Gabungkan branch
bug-fixkerilis-dev. - Lakukan update tema dan package dengan menjalankan
composer update --no-dev. - Ubah nomor versi (VERSION) sesuai format di atas pada file
core_helper.php. Juga ubah VERSI_DATABASE menggunakan format YYYYMMDD. Nomor urut harap dimulai dari 71. Sebagai contoh untuk rilis pada tanggal 1 November 2020, ubah menjadi 2021070171. Versi database digunakan untuk memungkinkan migrasi otomatis. - Lengkapi catatan rilis di file
catatan_rilis.md. - Buat file migrasi baru, dengan prepix
migrasi_' + versidatabase : misalnyamigrasi_2412010171.phpdan sesuaikan isi migrasinya. - Lakukan testing install baru. Lakukan testing upgrade dari rilis sebelumnya dan kemudian menggunakan menu Database > Migrasi DB (Semua Migrasi)
- Kirim semua perubahan sebagai
pull requestsupaya bisa digabungkan ke branchrilis-devoleh pengawas rilis. - Siapkan draft rilis di https://github.com/OpenSID/premium/releases, isi kolom tag dengan versi sesuai format di atas. Simpan sebagai draft.
Jangan dipublish. Nanti dipublish terpisah pada langkah berikut setelah pull request telah digabung oleh pengawas rilis. Tunggu pemberitahuan dari pengawas rilis bahwa pull request persiapan rilis telah digabung. Proses review oleh pengawas rilis ada di bawah (https://github.com/OpenSID/OpenSID/wiki/Proses-Rilis-Premium#review-sebelum-rilis).- Publish rilis. Langkah ini hanya dilakukan setelah ada konfirmasi dari pengawas rilis bahwa langkah 8 telah selesai. Yaitu pull request persiapan rilis telah digabung ke branch
rilis-devpada tanggal 1, dan telah diobfuscate ke branchbeta. - Update situs demo https://beta.opensid.or.id menggunakan branch
rilis-dev. Petunjuk mengupdate website demo ini ada di [[Memasang Demo di VPS]]. - Buat rilis premium untuk publik https://github.com/OpenSID/OpenSID/wiki/Rilis-Premium-Repositori-Publik
¶ Review sebelum rilis
Pull request yang dikirim pelaksana rilis perlu diperiksa oleh pengawas rilis sebelum digabung ke rilis. Proses review ini mencakup:
- Memeriksa setiap file yg diubah.
- Memasang dan menjalankan. Periksa migrasi berjalan semestinya dan versi yang ditampilkan benar.
- Melakukan instal baru menggunakan seeder.
- Testing jalankan migrasi database gabungan.
Setelah lolos pemeriksaan, gabung pull request tersebut ke branch rilis-dev dan push ke repo.
Kemudian beritahu pelaksana rilis, supaya proses rilis di atas dapat dilanjutkan.
Lakukan di Sore hari 17.00 WIB
¶ Pengecekan dan Perbaikan
- Periksa fitur yang ditambahkan
- Periksa bug yang diperbaiki
- Periksa teknis yang disesuaikan
- Lakukan perbaikan jika ditemukan masalah
¶ Pengecekan Database
- Pengecekan install awal
- Pengecekan backup dan restore data awal
¶ Perbarui dari versi sebelumnya
- Cek migrasi
- Cek backup dan restore
- Lakukan proses tsb pada 5 data desa yang sering bermasalah
¶ Pengecekan Server
- Update rilis terbaru ke server
- Lakukan migrasi
- Lakukan backup / restore
¶ Rilis Premium Repositori Publik
¶ Langkah-langkah sebagai berikut :
- Clone repo beruptar (https://github.com/OpenSID/Berputar)
git clone https://github.com/OpenSID/Berputar.git
-
Sediakan rilis (premium) tag versi premium yang akan di rilis (yang sudah diobfuscate)
-
Buka folder project repo berputar, hapus semua file kecuali folder
.git,.githubdan.ignore.
-
Buka folder project repo premium, dan copy semua file kecuali folder
.gitdan.githubserta copy juga file.github/workflows/deploy.ymluntuk proses deploy ke server berputar bisa jalan, ke folder project repo berputar.
-
Misalnya membuat rilis v22.05-premium. Jalankan perintah git berikut :
composer install --no-dev
php make_obfuscate.php
git add .
git commit -m "Rilis v[versi]-premium"
git tag v[versi]-premium
git push [remote] master
git push [remote] -uf tag v[versi]-premium
- Buat rilis di https://github.com/OpenSID/Berputar/releases/new menggunakan tag yang sudah dibuat td atau jika belum membuat tag, bisa dibuat saat melakukan rilis menggunakan branch dengan update rilis terbaru.
- Tambahkan catatan rilis.
- Publish rilis.
- Update situs demo https://berputar.opensid.or.id dengan rilis baru. Petunjuk mengupdate website demo ini ada di [[Memasang Demo di VPS]].
- Umumkan rilis di Forum Pengguna dan Pegiat OpenSID di https://www.facebook.com/groups/OpenSID/
- Lengkapi panduan untuk disesuaikan dengan perubahan di rilis baru
- Buat posting di https://www.facebook.com/groups/OpenSID/, mengajak pegiat membuat installer Windows untuk rilis baru.
¶ Sesudah Rilis
Gabungkan branch rilis-dev ke bug-fix, untuk pengembangan rilis selanjutnya.
git checkout bug-fix
git merge rilis-dev
Sesudah proses rilis selesai, hapus branch beta dan rilis-bug-fix (krn belum digunakan) yang ada diopensid premium sehingga hanya ada branch rilis, rilis-dev, bug-fix dan branch tertentu.
¶ Lengkapi Rilis Yang akan datang
Perbaiki atau lengkapi panduan di https://panduan.opendesa.id/id/opensid/rilis-umum-yang-akan-datang sesuai dengan perubahan atau penambahan fitur yang dilakukan di rilis saat ini.
Aplikasi yang tidak dilakukan pembekuan yaitu Layanan dan Dasbor SiapPakai