Runner

Bagaimana Cara Kerjanya?

Runner menggunakan teknologi container orchestration (CapRover) di atas cluster server FlazHost. Setiap aplikasi berjalan dalam container terisolasi dengan resource yang bisa di-scale secara horizontal.

Alur deploy: Anda push code ke GitHub → GitHub Actions build image → image dikirim ke registry FlazHost → cluster deploy container baru → aplikasi live dalam hitungan detik.

Cara Deploy

Runner mendukung tiga cara deploy aplikasi:

1. Dari GitHub (Custom Code)

Hubungkan repository GitHub Anda. FlazHost otomatis:

• Inject Dockerfile ke repository (jika belum ada)
• Inject workflow GitHub Actions (.github/workflows/deploy.yml)
• Build image di GitHub Actions, push ke registry FlazHost
• Deploy ke Runner cluster — aplikasi langsung online

2. Dari Docker Image

Deploy langsung dari image publik atau privat. Cukup masukkan nama image (contoh: nginx:latest, ghcr.io/username/app:v1) dan sistem akan menjalankannya.

3. Dari Template (Starter)

Pilih template siap-pakai (WordPress, Strapi, n8n, Ghost, dll) dan deploy dalam satu klik. Template sudah termasuk Dockerfile dan konfigurasi yang optimal.

App Sizes (Replica)

Setiap aplikasi berjalan dalam satu atau lebih replica. Ukuran replica menentukan alokasi resource per-replica:

Replica dihitung per-jam (PAYG). Biaya replica adalah biaya tambahan di luar biaya plan bulanan. Replica yang sedang sleep (setelah idle 15-30 menit) tidak dikenakan biaya.

Plans & Pricing

Runner tersedia dalam beberapa plan berlangganan. Biaya replica (PAYG) dihitung terpisah dari biaya plan.

Auto-scale

Runner memiliki dua layer autoscale yang bekerja bersama-sama:

Layer 1: Replica Autoscale

Untuk setiap aplikasi dengan autoscale aktif, sistem memonitor CPU container via CapRover API setiap ~1 menit:

• Scale Up — Jika CPU > threshold tinggi (misal 80%) dalam periode tertentu → tambah +step replica (capped di max_replicas)
• Scale Down — Jika CPU < threshold rendah (misal 20%) dalam periode tertentu → kurangi -step replica (floored di min_replicas)
• Cooldown — Jeda waktu antar scale untuk mencegah flapping (naik-turun terus)
• Audit — Semua keputusan scale dicatat ke paas_scale_events

Layer 2: Node Autoscale

Sistem juga memonitor CPU rata-rata seluruh node dalam cluster setiap ~5 menit via SSH (membaca /proc/stat host):

• Tambah Node — Jika rata-rata CPU cluster > threshold → tambah worker node baru (capped di max_workers)
• Kurangi Node — Jika rata-rata CPU rendah dalam periode tertentu → drain + terminate worker idle (master tidak pernah di-terminate)
• Hard Cap — Batas maksimal worker mencegah biaya tak terkendali dari misconfig

Safety & Reliability

• Jika endpoint stats CapRover gagal, autoscaler skip tick (TIDAK scale)
• Cooldown mencegah flapping
• Semua keputusan tercatat di audit log

Auto-scale

Plan Developer ke atas mendukung autoscale. Sistem otomatis menambah atau mengurangi jumlah replica berdasarkan beban CPU (threshold 80% scale up, 20% scale down). Konfigurasi dapat disesuaikan:

• Min/Max Replicas — Batas jumlah replica minimal dan maksimal
• CPU Threshold — Persentase CPU untuk trigger scale up/down
• Cooldown — Jeda waktu sebelum scale berikutnya (default 120 detik)
• Step Size — Jumlah replica yang ditambah/dikurangi sekali scale

Custom Domain + SSL Otomatis

Setiap aplikasi mendapat subdomain *.runner.flazhost.com secara default. Anda bisa menambahkan domain kustom sendiri — SSL (SSL otomatis) di-issue dan diperpanjang otomatis.

Jumlah domain kustom tergantung plan: Personal (2 domain), Developer (5), Start Up (10), Pro (30), Business/Enterprise (unlimited).

GitHub Actions CI/CD

Saat Anda menghubungkan repository GitHub, sistem akan:

• Menambahkan Dockerfile ke repository (jika belum ada)
• Menambahkan workflow file .github/workflows/deploy.yml
• Push ke repository Anda

Setiap push ke branch akan memicu build + deploy otomatis.

Link Resources

Attach database atau Object Storage ke aplikasi Anda. Environment variables akan otomatis di-inject ke container.

• Database: Pilih database MySQL/PostgreSQL existing, atau buat baru (PAYG)
• Object Storage: Link S3-compatible bucket untuk file/assets
• Auto-inject: DATABASE_URL, S3_ACCESS_KEY, dll otomatis tersedia di container

Monitoring

Pantau resource aplikasi secara real-time melalui dashboard monitoring bawaan. Metrics yang tersedia:

• CPU Usage (%)
• Memory Usage (MB)
• Network I/O
• Container status & logs

Template Starter

Deploy aplikasi populer dalam satu klik: WordPress, Strapi CMS, n8n (automation), Activepieces, Ghost, Coolify, Dokploy, dan lainnya. Template sudah termasuk Dockerfile optimal.

Environment Variables & Secrets

Atur environment variables dan secrets melalui dashboard. Variabel seperti DATABASE_URL, API keys, dan konfigurasi lainnya bisa di-set tanpa hardcode di repository.

Backup & Restore

Runner memiliki sistem backup otomatis dengan arsitektur berlapis:

App Backup (User)

Backup per-aplikasi disimpan ke OSS bucket milik pelanggan. Backup mencakup volume data aplikasi dan konfigurasi.

• Backup Otomatis — Backup mingguan/harian tergantung plan
• Cluster Backup (Admin) — Backup seluruh cluster untuk DR/migrasi
• Failed App Auto-Retry — Jika provision gagal, sistem otomatis retry

Backup & Restore

Backup otomatis berdasarkan plan:

• Developer — Backup mingguan
• Start Up, Pro, Business, Enterprise — Backup harian

Backup mencakup volume data aplikasi dan dapat direstore melalui dukungan.

Persistent Storage

Setiap aplikasi mendapat persistent volume untuk menyimpan data. Ukuran default setara RAM allocation. Volume bisa diperbesar dengan biaya tambahan.

Cron Jobs & Worker Apps

Runner mendukung background worker dan cron jobs. Anda bisa deploy aplikasi worker yang berjalan terus-menerus, atau scheduled task periodik.

Quota Enforcement

Sistem otomatis menegakkan batas plan setiap hari:

• Downgrade Violations — Jika user turun plan tapi masih punya app melebihi limit baru, app di-scale ke 0 atau di-suspend
• App Limit — Jumlah maksimal aplikasi per plan ditegakkan saat create
• Resource Limit — Total CPU/RAM dibatasi sesuai plan

SLA Uptime