Deployment & Orchestration

File: /etc/supervisor/conf.d/ao_api.conf

Buat file konfigurasi ini di direktori konfigurasi supervisor (biasanya /etc/supervisor/conf.d/ atau melalui panel server Anda).

[program:ao_api]
; Nama proses (gunakan nama yang unik)
command=/www/wwwroot/app-collection/ao/venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000

; Direktori kerja (Root project Python)
directory=/www/wwwroot/app-collection/ao

; User yang menjalankan proses (sesuaikan dengan user web server, biasanya www atau www-data)
user=www

; Otostart saat server boot
autostart=true

; Autorestart jika crash
autorestart=true
; Jika berhenti, tunggu 10 detik sebelum restart
startsecs=10

; Redirect log stdout dan stderr
stdout_logfile=/www/wwwroot/app-collection/ao/logs/supervisor.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=10

stderr_logfile=/www/wwwroot/app-collection/ao/logs/supervisor_err.log
stderr_logfile_maxbytes=50MB
stderr_logfile_backups=10

; Environment variables
environment=PATH="/www/wwwroot/app-collection/ao/venv/bin"

chown -R www:www /www/wwwroot/app-collection/ao/logs

File: /www/server/panel/vhost/nginx/ao.baktimakmur.com.conf

Catatan: Lokasi file bisa berbeda tergantung panel yang Anda gunakan (aapanel, cpanel, manual install). Pastikan ini adalah config untuk domain ao.baktimakmur.com.

server {
    listen 80;
    server_name ao.baktimakmur.com;
    
    # Root direktori untuk file statis (Public Area)
    root /www/wwwroot/ao.baktimakmur.com;
    index index.html;

    # Log Nginx
    access_log /www/wwwlogs/ao.baktimakmur.com-access.log;
    error_log /www/wwwlogs/ao.baktimakmur.com-error.log;

    # --- 1. Melayani API Python (Reverse Proxy) ---
    location /api/ {
        proxy_pass http://127.0.0.1:8000; # Mengarah ke uvicorn

        # Header Wajib agar FastAPI bisa membaca URL client dengan benar
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Timeout untuk proses ML (sesuaikan jika prediksi butuh waktu lama)
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;

        # Mengizinkan upload file besar (jika user upload gambar/input file)
        client_max_body_size 20M;
    }

    # --- 2. Melayani Dokumentasi (Opsional) ---
    location /docs {
        proxy_pass http://127.0.0.1:8000/docs;
    }

    # --- 3. Melayani File Statis ---
    location / {
        try_files $uri $uri/ /index.html;
        
        # Cache file statis (CSS, JS, Gambar)
        location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2)$ {
            expires 1y;
            add_header Cache-Control "public, immutable";
        }
    }
}

# 1. Baca ulang konfigurasi supervisor
supervisorctl reread

# 2. Update perubahan (start service baru)
supervisorctl update

# 3. Cek status service
supervisorctl status

# Output yang diharapkan:
# ao_api                          RUNNING   pid 12345, uptime 0:00:05

# Tes konfigurasi (pastikan outputnya: successful)
nginx -t

# Reload Nginx
systemctl reload nginx
# atau jika menggunakan panel (aaPanel/cPanel): simpan config di panel, panel akan reload otomatis.

Verifikasi Akhir:
1. Buka browser: http://ao.baktimakmur.com/api/health
2. Harus muncul JSON response: {"status": "healthy", ...}
3. Coba akses http://ao.baktimakmur.com/docs untuk melihat dokumentasi Swagger API.

Arsitektur Anda saat ini:

• ✅ Database: PostgreSQL yang aman (User: ao).
• ✅ Backend: FastAPI + Python Virtual Env (Private Area).
• ✅ Orchestrator: Supervisor menjaga API tetap hidup 24/7.
• ✅ Gateway: Nginx melayani API dan File Statis (Public Area).
• ✅ Structure: Terpisah rapi antara kode ML, API, dan aset web.