Deploy Flask: Gunicorn, Environment, dan Production Checklist

• Python • By TryzTech Team
FlaskPythonBackendWeb Development
Bagikan

Aplikasi yang lancar di laptop belum tentu siap menerima request publik. Di development, kita sengaja memakai debug mode dan auto reload agar perubahan kode cepat terlihat. Di production, prioritasnya berbeda: proses harus stabil, secret tidak boleh masuk repository, error perlu tercatat, dan aplikasi harus bisa diperiksa kesehatannya.

Deploy Flask juga tidak terikat pada satu provider. Detail dashboard dan command rilis bisa berbeda, tetapi kebutuhan dasarnya tetap mirip: WSGI server, environment variable, database yang siap, static files, log, dan health check.

Kenapa Tidak Memakai flask run?

Command flask run menjalankan development server bawaan Werkzeug. Server ini dibuat untuk membantu coding dan debugging, bukan untuk menangani beban production atau mengelola beberapa worker.

Gunicorn adalah WSGI server yang umum dipakai untuk aplikasi Flask di Linux. Install dan simpan sebagai dependency project:

# File: terminal
python -m pip install gunicorn
gunicorn --bind 0.0.0.0:8000 "app:create_app()"

Bagian "app:create_app()" berarti Gunicorn meng-import module app, memanggil application factory create_app(), lalu memakai object Flask yang dihasilkan. Opsi --bind menentukan alamat dan port tempat Gunicorn menerima koneksi.

Jumlah worker tidak perlu ditebak sejak awal. Mulai dari konfigurasi platform atau nilai kecil, lalu ukur waktu response, penggunaan memory, dan karakter workload. Menambah worker tanpa melihat kapasitas server justru bisa menghabiskan memory.

Pindahkan Config ke Environment

Secret dan alamat database tidak seharusnya ditulis langsung di source code. Baca nilainya saat proses aplikasi dimulai:

# File: config.py
import os


class Config:
    SECRET_KEY = os.environ["SECRET_KEY"]
    SQLALCHEMY_DATABASE_URI = os.environ["DATABASE_URL"]
    SQLALCHEMY_TRACK_MODIFICATIONS = False

os.environ["SECRET_KEY"] sengaja gagal jika variable belum tersedia. Untuk config wajib, kegagalan saat startup lebih mudah ditemukan daripada aplikasi hidup dengan secret default yang tidak aman.

Setiap environment sebaiknya memiliki nilai sendiri. Development, staging, dan production tidak perlu memakai database atau secret yang sama. File .env boleh membantu development lokal, tetapi masukkan .env ke .gitignore dan gunakan secret manager milik platform untuk production.

Debug mode juga harus mati. Jangan memasang FLASK_DEBUG=1 atau menjalankan --debug di server publik karena debugger dapat memperlihatkan detail internal dan berisiko membuka eksekusi kode.

Tambahkan Health Check Sederhana

Platform deploy atau monitoring service membutuhkan URL ringan untuk memastikan proses aplikasi masih merespons:

# File: routes/health.py
from flask import Blueprint, jsonify

health_bp = Blueprint("health", __name__)


@health_bp.get("/health")
def health():
    return jsonify({"status": "ok"})

Daftarkan blueprint tersebut di create_app(). Endpoint dasar ini membuktikan proses web hidup. Kalau Kamu ingin memeriksa database atau service eksternal, pertimbangkan endpoint readiness terpisah agar gangguan sementara tidak selalu membuat proses direstart.

Database Tidak Berubah Hanya karena Kode Berubah

Model terbaru bisa membutuhkan kolom yang belum ada di database production. Jalankan migration sebagai langkah rilis yang disengaja, misalnya dengan Flask-Migrate:

# File: terminal
python -m flask --app app db upgrade

Backup data penting sebelum migration berisiko, dan pastikan versi aplikasi masih kompatibel selama proses rollout. db.create_all() bukan pengganti migration karena tidak memperbarui tabel lama dengan aman.

Static Files dan Reverse Proxy

Flask mampu menyajikan folder static, tetapi deployment dengan traffic lebih besar sering menyerahkan asset ke reverse proxy, object storage, atau CDN. Pastikan URL hasil url_for("static", ...) tetap benar dan cache header sesuai kebutuhan.

Jika aplikasi berada di belakang reverse proxy, header seperti protocol HTTPS dan alamat client bisa diteruskan ke Flask. Gunakan ProxyFix hanya jika proxy memang dikonfigurasi dan jumlah proxy tepercaya diketahui. Mempercayai header tersebut secara membabi buta memungkinkan client memalsukan informasi request.

Log Harus Keluar dari Proses

Di container atau platform managed, tulis log ke standard output dan standard error agar platform dapat mengumpulkannya. Catat konteks yang membantu seperti method, path, status code, dan request ID, tetapi jangan merekam password, token, cookie session, atau body sensitif.

Error production sebaiknya menghasilkan halaman atau JSON yang aman untuk user, sementara stack trace lengkap masuk ke log privat. Dengan pembagian ini, user mendapat response yang wajar dan developer tetap punya bahan untuk mencari penyebabnya.

Checklist Rilis Flask

Sebelum mengarahkan traffic ke versi baru, cek hal-hal berikut:

  • Dependency production terkunci dan Gunicorn dapat meng-import create_app().
  • SECRET_KEY, DATABASE_URL, dan config wajib tersedia dari environment.
  • Debug mode mati dan stack trace tidak dikirim ke user.
  • Migration sudah diuji dan backup tersedia bila perubahan database berisiko.
  • Static files bisa dimuat dari URL production.
  • Cookie session memakai pengaturan aman ketika aplikasi berjalan lewat HTTPS.
  • Endpoint /health merespons dan monitoring dapat menjangkaunya.
  • Log startup serta error masuk ke tempat yang bisa dicari.

Periksa Setelah Deploy

Deploy belum selesai hanya karena dashboard menampilkan status hijau. Buka halaman utama, login dengan akun test, jalankan satu operasi CRUD, dan panggil endpoint API yang penting. Lihat log pada saat yang sama untuk memastikan tidak ada warning atau error tersembunyi.

Siapkan juga jalan kembali ke versi sebelumnya jika smoke test gagal. Rollback yang sederhana dan pernah diuji jauh lebih menenangkan daripada menyusun rencana pemulihan ketika aplikasi sudah bermasalah.

Lanjutkan membaca topik yang masih satu konteks.

Jangan Ketinggalan Info Terbaru

Dapatkan artikel teknologi, tips, dan insights menarik langsung ke email Kamu.