arifal
108 lines
2.8 KiB
Markdown
108 lines
2.8 KiB
Markdown
# Cron Setup (PM2 / self-hosted Linux)
|
|
|
|
Aplikasi punya beberapa endpoint cron yang harus di-trigger periodik dari luar. Karena deploy pakai PM2 di VPS Linux (bukan Vercel), trigger schedule pakai **system crontab** — zero dependency, OS-native.
|
|
|
|
## Daftar cron job
|
|
|
|
| Endpoint | Schedule | Tujuan |
|
|
|---|---|---|
|
|
| `GET /api/cron/auto-complete-trips` | `0 18 * * *` (18:00 UTC = 01:00 WIB) | Flip trip yang sudah lewat tanggal selesai dari `OPEN`/`FULL` ke `COMPLETED`. |
|
|
|
|
## Setup di server
|
|
|
|
### 1. Set `CRON_SECRET` di env production
|
|
|
|
Generate random secret 32 byte:
|
|
|
|
```bash
|
|
openssl rand -hex 32
|
|
```
|
|
|
|
Tambah ke file `.env` yang dibaca PM2 (atau yang pasti ter-load saat process boot):
|
|
|
|
```bash
|
|
CRON_SECRET="<hasil-openssl-tadi>"
|
|
```
|
|
|
|
Restart PM2 supaya proses re-load env:
|
|
|
|
```bash
|
|
pm2 restart setrip --update-env
|
|
```
|
|
|
|
### 2. Daftarkan crontab
|
|
|
|
Edit crontab user yang punya akses ke env (biasanya user yang menjalankan PM2):
|
|
|
|
```bash
|
|
crontab -e
|
|
```
|
|
|
|
Tambah baris (ganti `https://your-domain.com` dan `<CRON_SECRET>` sesuai env yang di-set di step 1):
|
|
|
|
```cron
|
|
# Setrip — auto-complete trips harian (jam 01:00 WIB)
|
|
0 18 * * * curl -fsS -H "Authorization: Bearer <CRON_SECRET>" https://your-domain.com/api/cron/auto-complete-trips >> /var/log/setrip-cron.log 2>&1
|
|
```
|
|
|
|
Verifikasi crontab tersimpan:
|
|
|
|
```bash
|
|
crontab -l
|
|
```
|
|
|
|
### 3. Siapkan file log
|
|
|
|
```bash
|
|
sudo touch /var/log/setrip-cron.log
|
|
sudo chown $(whoami) /var/log/setrip-cron.log
|
|
```
|
|
|
|
## Test manual
|
|
|
|
Sebelum tunggu schedule, panggil endpoint langsung untuk verifikasi:
|
|
|
|
```bash
|
|
curl -fsS -H "Authorization: Bearer $CRON_SECRET" https://your-domain.com/api/cron/auto-complete-trips
|
|
```
|
|
|
|
**Expected response:**
|
|
|
|
- Belum ada trip yang lewat: `{"ok":true,"completed":0,"ids":[]}`
|
|
- Ada trip yang lewat: `{"ok":true,"completed":2,"ids":["clx...","cly..."]}`
|
|
|
|
**Kalau dapat 401:** `CRON_SECRET` di env tidak match dengan header. Cek `pm2 env <id>`.
|
|
|
|
**Kalau dapat 500:** `CRON_SECRET` belum di-set di env.
|
|
|
|
## Monitoring
|
|
|
|
Tail log cron:
|
|
|
|
```bash
|
|
tail -f /var/log/setrip-cron.log
|
|
```
|
|
|
|
Cek log app PM2 (untuk `console.log` dari endpoint):
|
|
|
|
```bash
|
|
pm2 logs setrip --lines 100 | grep cron
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
**Cron jalan tapi tidak ada efek di DB:**
|
|
- Cek `pm2 logs setrip` untuk error.
|
|
- Verifikasi waktu server: `date` (output harus UTC kalau pakai schedule UTC).
|
|
|
|
**Cron tidak jalan sama sekali:**
|
|
- Cek service cron aktif: `systemctl status cron` (Debian/Ubuntu) atau `systemctl status crond` (RHEL/CentOS).
|
|
- Cek crontab terdaftar di user yang benar: `sudo crontab -u $(whoami) -l`.
|
|
|
|
**Secret bocor:**
|
|
- Generate ulang `CRON_SECRET`, update di `.env` + crontab line, restart PM2.
|
|
|
|
## Hari kalau pindah ke Vercel / PaaS lain
|
|
|
|
Tinggal hapus crontab line + bikin `vercel.json` (atau equivalent platform). Endpoint sudah platform-agnostic — proteksinya sama (header `Authorization: Bearer <CRON_SECRET>`).
|