Lewati ke konten utama

Custom Error Page Settings via NGINX Balancer

Saat terjadi kesalahan dalam suatu environment (seperti mencoba mengakses halaman yang tidak ada), halaman kesalahan default akan ditampilkan. Anda dapat menyesuaikan halaman kesalahan ini menggunakan NGINX load balancer untuk memberikan instruksi yang lebih spesifik atau informasi kontak untuk pengguna akhir. Berikut adalah cara mengatur halaman kesalahan kustom melalui NGINX balancer:

1. Akses Konfigurasi NGINX Load Balancer​

Masuk ke dashboard platform Anda, temukan NGINX load balancer di environment Anda, dan klik tombol Config.

NGINX balancer config button

2. Unggah Halaman Kesalahan Kustom​

Dalam pengelola konfigurasi, navigasikan ke folder /etc/nginx/conf.d dan buat atau unggah halaman kesalahan kustom Anda.

create custom error page

3. Contoh Halaman Kesalahan Kustom​

Untuk panduan ini, kami menggunakan file error.html berikut sebagai contoh:

example custom page

4. Edit Konfigurasi NGINX​

Navigasikan ke direktori /etc/nginx dan buka file nginx-jelastic.conf. Salin isinya dan tempelkan ke dalam file nginx.conf, menggantikan baris include /etc/nginx/nginx-jelastic.conf;.

edit nginx.conf file

5. Perbarui Pengaturan Halaman Kesalahan​

Temukan bagian server dari konfigurasi yang ditempel dan ganti pengaturan error_page default dengan yang berikut:

error_page 403 404 500 502 503 504 /error.html;
proxy_intercept_errors on;
error page configurations

6. Modifikasi Bagian Lokasi​

Gulir ke bawah ke bagian location dan sesuaikan parameter halaman kesalahan:

location /error.html {
    root /etc/nginx/conf.d;
    internal;
}
location / {
    if ($cookie_SRVGROUP ~ group|common) {
        proxy_pass http://$cookie_SRVGROUP;
        error_page 403 404 500 502 503 504 = /error.html;
    }
    if ($cookie_SRVGROUP !~ group|common) {
        add_header Set-Cookie "SRVGROUP=$group; path=/";
    }
    proxy_pass http://default_upstream;
    add_header Set-Cookie "SRVGROUP=$group; path=/";
}
location @rescue {
    proxy_pass http://$cookie_SRVGROUP;
    error_page 500 502 503 504 = /error.html;
}
location @recycle {
    proxy_pass http://default_upstream;
    add_header Set-Cookie "SRVGROUP=$group; path=/";
}
error page location settings

7. Pengaturan Tambahan untuk SSL (Opsional)​

Jika Anda menggunakan SSL untuk koneksi yang aman, pengaturan tambahan diperlukan.

Dalam file /etc/nginx/conf.d/ssl.conf, tambahkan yang berikut:

proxy_intercept_errors on;
location /error.html {
    root /etc/nginx/conf.d;
}
configure ssl.conf file

8. Sesuaikan File SSL Upstreams​

Dalam file /etc/nginx/conf.d/ssl.upstreams.inc, modifikasi kondisi berikut:

if ($cookie_SRVGROUP ~ group|common) {
    proxy_pass http://$cookie_SRVGROUP;
    error_page 403 404 /error.html;
    error_page 500 502 503 504 = @resque;
}
adjust SSL upstreams file

9. Mulai Ulang Server NGINX​

Untuk menerapkan perubahan, Restart server NGINX.

restart NGINX balancer nodes

10. Uji Halaman Kesalahan Kustom​

Sekarang, coba akses halaman yang tidak ada dalam domain Anda untuk melihat halaman kesalahan kustom beraksi.

custom error page
peringatan

Jika environment atau server dengan halaman kesalahan kustom tidak dapat dijangkau, halaman kesalahan default di seluruh platform akan ditampilkan. Notifikasi kesalahan di seluruh platform ini tidak dapat dimodifikasi.

Baca Juga​