Perbarui aplikasi ke versi terbaru dan atur konfigurasinya dengan aman.
Tab Konfigurasi adalah tempat mengatur aplikasi di luar tampilan aplikasinya sendiri. Di sini kamu bisa memperbarui aplikasi ke versi baru, mengubah variabel environment, dan melihat riwayat deploy. Karena perubahan di tab ini memengaruhi cara aplikasi berjalan, baca panduan ini sebelum mengubah apa pun.
Versi aplikasi
Bagian Versi Aplikasi menampilkan versi yang sedang berjalan dan versi baru yang tersedia, lengkap dengan labelnya, misalnya Latest atau Minor release.
- Pilih versi di Pilih versi baru.
- Klik Ganti Versi.
- Sistem memasang versi baru lalu memastikan aplikasi berjalan sehat. Bila versi baru gagal berjalan, aplikasi dikembalikan ke versi sebelumnya.
Memahami jenis rilis
- Patch atau perbaikan kecil: biasanya hanya perbaikan bug, aman untuk diperbarui.
- Minor release: fitur baru tanpa perubahan besar, umumnya aman.
- Major: perubahan besar, misalnya dari 1.x ke 2.x. Bisa mengubah cara kerja aplikasi atau format data.
Sebelum pindah ke versi mayor, baca catatan rilis aplikasinya dan pastikan backup aktif.
Aplikasi dengan data satu arah
Sebagian aplikasi, misalnya Nextcloud, mengubah format datanya saat diperbarui ke versi baru. Setelah itu data tidak bisa dibuka oleh versi lama. Untuk aplikasi seperti ini, pengembalian otomatis ke versi lama tidak dilakukan, dan tim kami akan diberi tahu bila pembaruan gagal. Selalu pastikan backup aktif sebelum memperbarui aplikasi jenis ini.
Kapan sebaiknya memperbarui?
- Saat ada perbaikan keamanan.
- Saat kamu membutuhkan fitur baru.
- Di waktu yang tenang, bukan saat aplikasi sedang ramai dipakai.
Tidak wajib selalu memakai versi terbaru. Versi yang stabil dan berjalan baik boleh dipertahankan sampai ada alasan untuk memperbarui.
Variabel environment
Bagian Variabel Environment berisi pengaturan aplikasi, misalnya zona waktu, alamat website, atau kunci API.
- Ubah atau tambah variabel yang dibutuhkan.
- Klik Simpan & Deploy Ulang. Aplikasi jeda sebentar saat deploy ulang.
Ubah variabel hanya bila kamu paham fungsinya, karena salah isi bisa membuat aplikasi gagal berjalan. Untuk menambah CPU atau RAM, pakai tab Upgrade, bukan variabel environment.
Tips mengubah variabel
- Catat nilai lama sebelum mengubah, agar bisa dikembalikan bila ada masalah.
- Ubah satu per satu, lalu uji aplikasi. Mengubah banyak sekaligus menyulitkan mencari penyebab bila terjadi error.
- Jangan hapus variabel bawaan yang tidak kamu pahami, terutama yang berisi kunci enkripsi. Menghapusnya bisa membuat data lama tidak bisa dibaca.
- Rahasiakan isinya. Variabel environment sering berisi kunci API dan password. Jangan screenshot lalu membagikannya ke grup.
Deployment terakhir
Riwayat deploy aplikasimu. Klik Perbarui untuk memuat ulang daftar. Berguna untuk mengecek kapan perubahan terakhir diterapkan, misalnya saat aplikasi mulai bermasalah setelah perubahan tertentu.
Bila aplikasi bermasalah setelah perubahan
- Cek tab Log untuk melihat pesan error.
- Bila penyebabnya variabel environment, kembalikan nilai lama lalu Simpan & Deploy Ulang.
- Bila penyebabnya versi baru, buka tiket dan sebutkan versi sebelumnya yang berjalan normal.
- Bila data terdampak, minta pemulihan dari titik backup terakhir lewat tab Backup.
Contoh: mengatur zona waktu
Sebagian aplikasi memakai zona waktu UTC secara bawaan, sehingga jadwal yang kamu buat bisa berjalan tujuh jam lebih awal dari yang diharapkan. Bila aplikasimu menyediakan variabel zona waktu, misalnya TZ atau GENERIC_TIMEZONE di n8n, isi dengan Asia/Jakarta, lalu klik Simpan & Deploy Ulang. Setelah aplikasi berjalan kembali, cek jadwal di dalam aplikasi untuk memastikan waktunya sudah sesuai.
Tanya jawab
Apakah ganti versi menghapus data? Tidak. Data tetap tersimpan. Namun pada pembaruan versi mayor, format data bisa berubah, sehingga backup tetap disarankan sebelum memperbarui.
Kenapa versi yang saya inginkan tidak ada di daftar? Daftar berisi versi yang sudah diuji untuk berjalan di Container Apps. Bila kamu membutuhkan versi tertentu, buka tiket.
Ringkasan
Perbarui versi di waktu yang tenang dan pastikan backup aktif, terutama untuk versi mayor dan aplikasi dengan data satu arah. Ubah variabel environment satu per satu, catat nilai lama, dan jangan pernah menghapus variabel kunci enkripsi bawaan.
