Lewati ke isi

Menjalankan aplikasi#

REST API proyekmu berjalan dengan dua cara: untuk pengembangan, dan di dalam container.

Sebelum mulai: dependency proyek sudah ter-install dan .env sudah berisi API key. Rinciannya ada di Membuat proyek baru dan Mengatur model dan API key.

Menjalankan server pengembangan#

Dari root proyek, jalankan:

uvicorn src.interface.http.main:app --reload

Server berjalan di http://localhost:8000. Opsi --reload memulai ulang server setiap kali kode berubah. Jangan memakai opsi itu di produksi.

Untuk memakai port lain, tambahkan --port:

uvicorn src.interface.http.main:app --reload --port 9000

Menjalankan di container#

  1. Bangun image dari root proyek. Ganti NAMA_IMAGE dengan nama yang kamu inginkan:

    docker build -f dockerfile/Dockerfile -t NAMA_IMAGE .

  2. Jalankan container dengan variabel dari .env:

    docker run --env-file .env -p 8000:8000 NAMA_IMAGE

Image hanya memuat requirements.txt dan folder src. File .env tidak ikut disalin ke dalam image; variabelnya diberikan saat container dijalankan.

Warning

Sebelum menjalankan di produksi, isi PLAYGROUND_ENABLED=false atau hapus barisnya. Playground menampilkan argumen dan hasil setiap tool kepada siapa pun yang bisa membuka halamannya.

Memeriksa hasilnya#

Panggil endpoint pemeriksa:

curl http://localhost:8000/health

Server yang hidup menjawab:

{"status": "ok"}

Dokumentasi interaktif buatan FastAPI untuk semua endpoint ada di http://localhost:8000/docs. Agent beserta setiap langkahnya bisa dicoba di Playground.

Halaman terkait#