Deploy produk

Tujuan

Menggunakan skrip instalasi untuk men-deploy Sa2web, menyelesaikan instalasi pertama, upgrade, validasi, dan konfigurasi HTTPS.

Prasyarat

• Server deployment harus menggunakan Linux x86_64. Produk saat ini tidak mendukung Windows, macOS, ARM64, atau arsitektur CPU lainnya.
• Docker dan Docker Compose sudah terpasang.
• Path instalasi, IP intranet host, IP publik atau domain, nama sistem, dan kata sandi pengguna system sudah disiapkan.

Video referensi

Untuk melihat panduan prosesnya, lihat video referensi instalasi.

Unduh

Unduh versi yang diperlukan dari situs resmi, versi team atau full, lalu ekstrak ke sebuah direktori, misalnya:

cd /opt && tar -xzf browser_full_1.0.0.tar.gz

Langkah operasi

1. Masuk ke direktori deployment dan jalankan skrip instalasi:

cd /opt/browser_full_1.0.0
chmod +x install.sh
./install.sh

2. Pilih bahasa instalasi. Skrip mendukung English, 简体中文, 日本語, Tiếng Việt, Bahasa Indonesia, Español, Français, dan Русский.
3. Baca dan setujui perjanjian penggunaan perangkat lunak.
4. Saat instalasi pertama, masukkan parameter berikut sesuai prompt:

Parameter	Keterangan	Default
Direktori instalasi	Direktori runtime produk	/opt/sa
IP intranet host	Digunakan untuk binding container dan layanan; jangan isi localhost atau 127.0.0.1	Wajib
IP publik host	Digunakan untuk akses eksternal	Default ke IP intranet
Domain akses sistem	Domain atau IP yang digunakan pengguna	Default ke IP publik
Nama sistem	Nama yang ditampilkan di frontend	App System
Kata sandi pengguna system	Kata sandi awal pengguna system	abc123456

5. Pilih metode sertifikat HTTPS/SSL:

• Menggunakan Caddy untuk otomatis memperoleh sertifikat gratis seperti Let's Encrypt.
• Menggunakan sertifikat self-signed Caddy.
• Menyediakan sertifikat sendiri dan menaruhnya di volumes/ssl.

Jika memilih sertifikat self-signed Caddy, perangkat klien perlu memasang sertifikat root lokal Caddy. Lihat Instalasi sertifikat intranet.

6. Skrip akan memuat image offline, menghasilkan docker-compose.yml, menulis konfigurasi runtime, dan memulai container.

Proses upgrade

1. Backup direktori instalasi saat ini, terutama volumes/, data/, dan logs/:

tar czf /tmp/browser_backup_$(date +%F).tgz $INSTALL_PATH

2. Salin file deployment versi baru ke server tujuan.
3. Jalankan ./install.sh di direktori versi baru.
4. Setelah skrip mendeteksi $HOME/.sa/config.env, skrip masuk mode upgrade, membuat ulang konfigurasi, lalu menjalankan:

docker compose down
docker compose up -d

Validasi hasil

docker compose -f $INSTALL_PATH/docker-compose.yml ps
tail -n 200 $INSTALL_PATH/logs/app/app.log
docker compose -f $INSTALL_PATH/docker-compose.yml logs --tail 200 --follow

Akses melalui browser:

https://<APP_DOMAIN>/
https://<APP_DOMAIN>/admin/login

Inisialisasi setelah instalasi

1. Login ke konsol admin dengan pengguna system.
2. Jika masih memakai kata sandi default abc123456, segera ubah dan buat setidaknya satu admin cadangan.
3. Dapatkan dan tambahkan lisensi. Lihat Mendapatkan dan menambahkan lisensi.
4. Periksa nama sistem, domain, dan pengaturan dasar.
5. Buat mesin dan instance browser.
6. Buat pengguna uji, situs uji, dan grup uji.
7. Selesaikan satu validasi akses situs dari portal pengguna:

https://<APP_DOMAIN>/app

Saran backup

Data	Saran
Direktori instalasi	Backup penuh $INSTALL_PATH sebelum upgrade
volumes	Menyimpan sertifikat, konfigurasi, object storage, dan data runtime lain
data	Menyimpan gambar upload, sertifikat Caddy, ClickHouse, Garage, GeoIP, dan data runtime browser
logs	Menyimpan log untuk troubleshooting dan audit
Database	Backup berkala sesuai kebijakan perusahaan
Konfigurasi .sa	Simpan $HOME/.sa/config.env dan $HOME/.sa/user.env

Masalah umum

• Sertifikat otomatis membutuhkan domain publik yang mengarah benar ke server dan port 80/443 terbuka.
• Untuk deployment intranet dengan sertifikat self-signed Caddy, pasang $INSTALL_PATH/data/caddy/pki/authorities/local/root.crt ke trust store root klien.
• Sertifikat kustom harus bernama cert.crt dan cert.key, lalu diletakkan di volumes/ssl di bawah direktori instalasi.
• Statistik lokasi membutuhkan bash update_geolite2.sh untuk mengunduh database GeoLite2. Jika gagal, atur proxy di update_geolite2.sh.
• Jika instalasi terputus, periksa dahulu apakah image Docker sudah dimuat, lalu cek apakah ada konfigurasi lama di direktori instalasi dan $HOME/.sa.
• Jika perlu instal ulang total, bukan upgrade, hapus $HOME/.sa, lalu jalankan ulang install.sh.