Aplikasi berjalan baik di laptop tetapi gagal selepas deploy. Kadang-kadang puncanya bukan kod fungsi, melainkan tetapan yang berbeza: connection string, URL API, tahap log atau secret yang belum tersedia. Persekitaran pembangunan, ujian dan produksi patut mempunyai tujuan serta konfigurasi yang jelas.
Simpan nilai umum dalam fail konfigurasi yang sesuai, tetapi jangan commit secret. Gunakan mekanisme yang disediakan persekitaran untuk kata laluan serta kunci, dan pastikan nama tetapan konsisten. Dokumentasi konfigurasi ASP.NET Core menerangkan susunan sumber nilai dan cara override berlaku. Fahami susunan itu sebelum menganggap aplikasi membaca fail yang anda baru ubah.
Uji persekitaran yang menyerupai produksi
Staging berguna apabila ia menggunakan komponen dan aturan yang cukup dekat dengan produksi untuk mendedahkan masalah deploy, tanpa menyentuh data sebenar. Jangan salin secret atau data peribadi produksi ke staging hanya untuk menjadikannya “realistik”. Uji dengan data contoh yang sesuai dan semak migrasi pangkalan data secara terkawal.
Sediakan fail contoh yang menyenaraikan nama tetapan tanpa nilai rahsia, bersama penerangan ringkas tentang tempat mendapatkan nilai lokal. Ini membantu onboarding dan mengelakkan orang menyalin konfigurasi produksi secara sembarangan. Apabila tetapan baharu ditambah, kemas kini contoh itu dalam PR yang sama supaya dokumentasi tidak tertinggal.
Senarai tetapan yang diperlukan patut menjadi sebahagian dokumentasi onboarding. Jika pembangun baharu perlu meneka nilai daripada chat lama, sistem itu belum cukup jelas. Konfigurasi yang rapi membuat perbezaan antara persekitaran mudah dikesan, bukan kejutan selepas butang deploy ditekan.